[HttpFoundation] Split getClientIp into two methods for better flexibility.
[HttpFoundation] Add tests for the newly created Request::getClientIps() method.
[HttpFoundation] Fixing tests.
[HttpFoundation] Use @see annotation for better documentation generation.
[HttpFoundation] Split the tests into two methods / data providers.
[HttpFoundation] Removed the @api annotation on getClientIps method.
[HttpFoundation] Move comments from one method to the other [ci skip].
merged branch gnutix/issue-7349-fix (PR #7612)

This PR was merged into the master branch.

Discussion
----------

[HttpFoundation] Split getClientIp into two methods for better flexibility

| Q             | A
| ------------- | ---
| Bug fix?      | no
| New feature?  | no
| BC breaks?    | no
| Deprecations? | no
| Tests pass?   | Locally: NO (HttpFoundation tests passes, but all Symfony tests fails because of my local setup). Travis : YES
| Fixed tickets | #7349
| License       | MIT
| Doc PR        | none (yet?)

Split the ``Request::getClientIp`` method in two to allow better overriding flexibility. See #7349 for more information.

Commits
-------

2678dd5 [HttpFoundation] Move comments from one method to the other [ci skip].
7529664 [HttpFoundation] Removed the @api annotation on getClientIps method.
f0c4ab6 [HttpFoundation] Split the tests into two methods / data providers.
80030fb [HttpFoundation] Use @see annotation for better documentation generation.
3e703a2 [HttpFoundation] Fixing tests.
63cbbb5 [HttpFoundation] Add tests for the newly created Request::getClientIps() method.
58347fb [HttpFoundation] Split getClientIp into two methods for better flexibility.