Middleware to detect the client ip and save it as a request attribute

v2.0.1 2020-12-02 00:05 UTC

This package is auto-updated.

Last update: 2024-05-29 04:27:44 UTC


Latest Version on Packagist Software License Testing Total Downloads

Middleware to detect the client ip and save it as a request attribute.



This package is installable and autoloadable via Composer as middlewares/client-ip.

composer require middlewares/client-ip


$dispatcher = new Dispatcher([
	new Middlewares\ClientIp(),

    function ($request) {
        //Get the client ip
        $ip = $request->getAttribute('client-ip');

$response = $dispatcher->dispatch(new ServerRequest());


This option configures the detection through proxies. The first argument is an array of ips or cidr of the trusted proxies. If it's empty, no ip filtering is made. The second argument is a list of the headers to inspect. If it's not defined, uses the default value ['Forwarded', 'Forwarded-For', 'Client-Ip', 'X-Forwarded', 'X-Forwarded-For', 'X-Cluster-Client-Ip']. Disabled by default.

//Use proxies
$middleware = (new Middlewares\ClientIp())->proxy();

//Trust only some proxies by ip
$middleware = (new Middlewares\ClientIp())->proxy(['', '']);

//Trust only some proxies by ip using a specific header
$middleware = (new Middlewares\ClientIp())->proxy(['', ''], ['X-Forwarded-For']);

// Trust only some proxies by cidr range
// usefull when you have an autoscaled proxy(like haproxy) in a subnet
$middleware = (new Middlewares\ClientIp())->proxy(['', '']);


By default, the ip is stored in the client-ip attribute of the server request. This options allows to modify that:

//Save the ip in the "ip" attribute
$middleware = (new Middlewares\ClientIp())->attribute('ip');

Please see CHANGELOG for more information about recent changes and CONTRIBUTING for contributing details.

The MIT License (MIT). Please see LICENSE for more information.