Download the PHP package rolandverner/symfony-cloudflare without Composer
On this page you can find all versions of the php package rolandverner/symfony-cloudflare. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download rolandverner/symfony-cloudflare
More information about rolandverner/symfony-cloudflare
Files in rolandverner/symfony-cloudflare
Package symfony-cloudflare
Short Description Symfony bundle for Cloudflare integration: trusted proxies, real client IP detection, forwarded headers.
License MIT
Informations about the package symfony-cloudflare
Cloudflare Trusted Proxies Bundle for Symfony (Real IP & Reverse Proxy Support)
A production-ready Symfony bundle for integrating Cloudflare with Symfony applications. It ensures correct real client IP detection, trusted proxy configuration, and forwarded headers handling when Symfony runs behind Cloudflare.
Why use Cloudflare with Symfony?
When running Symfony behind Cloudflare, incorrect proxy configuration often causes:
- Wrong client IP addresses (
Request::getClientIp()) - Broken HTTPS / scheme detection
- Invalid security and rate-limiting behavior
This bundle automatically configures Symfony trusted proxies using official Cloudflare IPv4 and IPv6 ranges and keeps them up to date.
Features
- Automatic IP Updates: Automatically fetches and updates official Cloudflare IPv4 and IPv6 ranges for Symfony trusted proxies.
- Caching: IP ranges are cached using Symfony Cache to avoid overhead on every request.
- Zero Configuration: Works out of the box with standard Symfony environment variables (
TRUSTED_PROXIES). - Flexible: Customizable headers, caching, and merging logic.
- Feature Toggle: Easily enable or disable the bundle via config or environment variables.
Installation
After installation, register the bundle in your config/bundles.php:
After installation, you can automatically publish the configuration file to your project:
Compatibility
- PHP 8.1+
- Symfony 6.x
- Symfony 7.x
- Symfony 8.x
- Cloudflare (Free, Pro, Business, Enterprise)
Configuration
Environment Variables
By default, the bundle will automatically merge Cloudflare IPs with any proxies defined in your standard Symfony environment variable:
If you prefer to use a custom variable name, you can change proxy_env in the configuration.
Usage
The bundle hooks into the kernel.request event with high priority (2000),
so it runs before the Security component.
Commands
You can manually reload or view the cached IP ranges:
[!TIP] While the bundle refreshes the cache automatically on request, it is recommended to set up a cron job to keep the cache warm:
Credits
This bundle is inspired by monicahq/laravel-cloudflare.
License
MIT
All versions of symfony-cloudflare with dependencies
symfony/http-foundation Version ^6.0 || ^7.0 || ^8.0
symfony/http-kernel Version ^6.0 || ^7.0 || ^8.0
symfony/http-client Version ^6.0 || ^7.0 || ^8.0
symfony/cache Version ^6.0 || ^7.0 || ^8.0
symfony/config Version ^6.0 || ^7.0 || ^8.0
symfony/dependency-injection Version ^6.0 || ^7.0 || ^8.0
symfony/console Version ^6.0 || ^7.0 || ^8.0