Correctly return IP address when using trusted header

[raicabogdan]

Hello!

• Type: bug fix
• Link to issue: [BUG]: Local IP may be returned by request->getClientAddress(true); #16777

In raising this pull request, I confirm the following:

• I have read and understood the Contributing Guidelines
• I have checked that another pull request for this purpose does not exist
• I wrote some tests for this PR
• I have updated the relevant CHANGELOG
• I have created a PR for the documentation about this change

Small description of change:

When using $this->request->getClientAddress(true); to extract IP address from X-Forwarded-For header it needs to select the first left side IP that is not private or reserved IP address.

Added support for users to add their own trustedProxies via method, accepts array of IPs or range of IPs.

$this->request->setTrustedProxies(['1.1.1.1']);

This will trigger an Exception("The forwarded proxy IP addresses are not trusted.") if users mess up their proxy setup.

Thanks

[niden]

Thank you @raicabogdan !!