PHPackages godscodes/proxy - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [HTTP & Networking](/categories/http) 4. / 5. godscodes/proxy ActiveLibrary[HTTP & Networking](/categories/http) godscodes/proxy =============== Set trusted proxies for Laravel 1.0.0(2y ago)0115MITPHPPHP >=5.4.0 Since Dec 29Pushed 2y agoCompare [ Source](https://github.com/godscodes/TrustedProxy)[ Packagist](https://packagist.org/packages/godscodes/proxy)[ RSS](/packages/godscodes-proxy/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (4)Versions (2)Used By (0) Laravel Trusted Proxies ======================= [](#laravel-trusted-proxies) [![Build Status](https://github.com/fideloper/TrustedProxy/workflows/Tests/badge.svg)](https://github.com/fideloper/TrustedProxy/actions) [![Total Downloads](https://camo.githubusercontent.com/7638e1a48af64d520209ad1e5b813cf079b4250bf02658aca95e1af95f43ba66/68747470733a2f2f706f7365722e707567782e6f72672f666964656c6f7065722f70726f78792f646f776e6c6f6164732e706e67)](https://packagist.org/packages/fideloper/proxy) **Setting a trusted proxy allows for correct URL generation, redirecting, session handling and logging in Laravel when behind a reverse proxy such as a load balancer or cache.** --- Installation ------------ [](#installation) To install Trusted Proxy, use: ``` composer require godscodes/proxy:^3.3 ``` Setup ----- [](#setup) Refer to the docs above for using Trusted Proxy in Laravel 5.5+. For Laravel 4.0 - 5.4, refer to [the wiki](https://github.com/fideloper/TrustedProxy/wiki). What Does This Do? ------------------ [](#what-does-this-do) Setting a trusted proxy allows for correct URL generation, redirecting, session handling and logging in Laravel when behind a reverse proxy. This is useful if your web servers sit behind a load balancer (Nginx, HAProxy, Envoy, ELB/ALB, etc), HTTP cache (CloudFlare, Squid, Varnish, etc), or other intermediary (reverse) proxy. How Does This Work? ------------------- [](#how-does-this-work) Applications behind a reverse proxy typically read some HTTP headers such as `X-Forwarded`, `X-Forwarded-For`, `X-Forwarded-Proto` (and more) to know about the real end-client making an HTTP request. > If those headers were not set, then the application code would think every incoming HTTP request would be from the proxy. Laravel (technically the Symfony HTTP base classes) have a concept of a "trusted proxy", where those `X-Forwarded` headers will only be used if the source IP address of the request is known. In other words, it only trusts those headers if the proxy is trusted. This package creates an easier interface to that option. You can set the IP addresses of the proxies (that the application would see, so it may be a private network IP address), and the Symfony HTTP classes will know to use the `X-Forwarded` headers if an HTTP requets containing those headers was from the trusted proxy. Why Does This Matter? --------------------- [](#why-does-this-matter) A very common load balancing approach is to send `https://` requests to a load balancer, but send `http://` requests to the application servers behind the load balancer. For example, you may send a request in your browser to `https://example.org`. The load balancer, in turn, might send requests to an application server at `http://192.168.1.23`. What if that server returns a redirect, or generates an asset url? The users's browser would get back a redirect or HTML that includes `http://192.168.1.23` in it, which is clearly wrong. What happens is that the application thinks its hostname is `192.168.1.23` and the schema is `http://`. It doesn't know that the end client used `https://example.org` for its web request. So the application needs to know to read the `X-Forwarded` headers to get the correct request details (schema `https://`, host `example.org`). Laravel/Symfony automatically reads those headers, but only if the trusted proxy configuration is set to "trust" the load balancer/reverse proxy. > Note: Many of us use hosted load balancers/proxies such as AWS ELB/ALB, etc. We don't know the IP address of those reverse proxies, and so you need to trusted **all** proxies in that case. > > The trade-off there is running the security risk of allowing people to potentially spoof the `X-Forwarded` headers. IP Addresses by Service ----------------------- [](#ip-addresses-by-service) [This Wiki page](https://github.com/fideloper/TrustedProxy/wiki/IP-Addresses-of-Popular-Services) has a list of popular services and their IP addresses of their servers, if available. Any updates or suggestions are welcome! ### Health Score 22 — LowBetter than 22% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity11 Limited adoption so far Community18 Small or concentrated contributor base Maturity37 Early-stage or recently created project Bus Factor1 Top contributor holds 64.3% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 871d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/109ebbfdeb2d2b671fc72e6fa33d8505a63d4a25b0f696c850bea46ffd6f7c43?d=identicon)[godscodes](/maintainers/godscodes) --- Top Contributors [![fideloper](https://avatars.githubusercontent.com/u/467411?v=4)](https://github.com/fideloper "fideloper (146 commits)")[![GrahamCampbell](https://avatars.githubusercontent.com/u/2829600?v=4)](https://github.com/GrahamCampbell "GrahamCampbell (34 commits)")[![vluzrmos](https://avatars.githubusercontent.com/u/450848?v=4)](https://github.com/vluzrmos "vluzrmos (5 commits)")[![rrpadilla](https://avatars.githubusercontent.com/u/6921286?v=4)](https://github.com/rrpadilla "rrpadilla (5 commits)")[![taylorotwell](https://avatars.githubusercontent.com/u/463230?v=4)](https://github.com/taylorotwell "taylorotwell (4 commits)")[![Keoghan](https://avatars.githubusercontent.com/u/6714599?v=4)](https://github.com/Keoghan "Keoghan (4 commits)")[![tamc](https://avatars.githubusercontent.com/u/43987?v=4)](https://github.com/tamc "tamc (3 commits)")[![ssfinney](https://avatars.githubusercontent.com/u/1596394?v=4)](https://github.com/ssfinney "ssfinney (3 commits)")[![JohnnyWalkerDigital](https://avatars.githubusercontent.com/u/6763222?v=4)](https://github.com/JohnnyWalkerDigital "JohnnyWalkerDigital (3 commits)")[![Bradez](https://avatars.githubusercontent.com/u/919214?v=4)](https://github.com/Bradez "Bradez (2 commits)")[![onlyonemuthuraj](https://avatars.githubusercontent.com/u/22977107?v=4)](https://github.com/onlyonemuthuraj "onlyonemuthuraj (2 commits)")[![djallits](https://avatars.githubusercontent.com/u/10674226?v=4)](https://github.com/djallits "djallits (2 commits)")[![SerafimArts](https://avatars.githubusercontent.com/u/2461257?v=4)](https://github.com/SerafimArts "SerafimArts (1 commits)")[![StevenBullen](https://avatars.githubusercontent.com/u/239862?v=4)](https://github.com/StevenBullen "StevenBullen (1 commits)")[![lucasff](https://avatars.githubusercontent.com/u/4260591?v=4)](https://github.com/lucasff "lucasff (1 commits)")[![barryvdh](https://avatars.githubusercontent.com/u/973269?v=4)](https://github.com/barryvdh "barryvdh (1 commits)")[![carusogabriel](https://avatars.githubusercontent.com/u/16328050?v=4)](https://github.com/carusogabriel "carusogabriel (1 commits)")[![crynobone](https://avatars.githubusercontent.com/u/172966?v=4)](https://github.com/crynobone "crynobone (1 commits)")[![dwightwatson](https://avatars.githubusercontent.com/u/1100408?v=4)](https://github.com/dwightwatson "dwightwatson (1 commits)")[![jarnovanleeuwen](https://avatars.githubusercontent.com/u/1358997?v=4)](https://github.com/jarnovanleeuwen "jarnovanleeuwen (1 commits)") --- Tags proxytrusted proxyload balancing ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/godscodes-proxy/health.svg) ``` [![Health](https://phpackages.com/badges/godscodes-proxy/health.svg)](https://phpackages.com/packages/godscodes-proxy) ``` ### Alternatives [fideloper/proxy Set trusted proxies for Laravel 7.3k174.4M559](/packages/fideloper-proxy)[nette/http 🌐 Nette Http: abstraction for HTTP request, response and session. Provides careful data sanitization and utility for URL and cookies manipulation. 48619.2M541](/packages/nette-http)[jenssegers/proxy Proxy library that forwards requests to the desired url and returns the response. 940487.2k4](/packages/jenssegers-proxy)[clue/http-proxy-react Async HTTP proxy connector, tunnel any TCP/IP-based protocol through an HTTP CONNECT proxy server, built on top of ReactPHP 472.3M33](/packages/clue-http-proxy-react)[willwashburn/phpamo A PHP library to create urls for Camo - the SSL image proxy 42159.6k1](/packages/willwashburn-phpamo)[zounar/php-proxy Forward your HTTP/HTTPS requests to another server. 1814.0k](/packages/zounar-php-proxy) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)