middlewares/geolocation

Middleware to geolocate the client using the ip address

middlewares/geolocation

![Software License][ico-license] ![Total Downloads][ico-downloads] ![SensioLabs Insight][ico-sensiolabs], _(*1)

Middleware to geolocate the client using the ip address and Geocoder and save the result as a request attribute., _(*2)

Requirements

• PHP >= 7.0
• A PSR-7 http library
• A PSR-15 middleware dispatcher
• A PHP-HTTP adapter, for example Guzzle6
• A Geocoder ip-based provider

Installation

This package is installable and autoloadable via Composer as middlewares/geolocation., _(*3)

composer require middlewares/geolocation

Example

$freeGeoIpProvider = new Geocoder\Provider\FreeGeoIp($adapter);

$dispatcher = new Dispatcher([
    new Middlewares\Geolocation($freeGeoIpProvider),

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

        $country = $location->first()->getCountry();
    }
]);

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

Options

__construct(Geocoder\Provider\Provider $provider)

The geocoder provider used to geolocate the client., _(*4)

It's also recommended to configure it to caching responses., _(*5)

ipAttribute(string $ipAttribute)

By default uses the REMOTE_ADDR server parameter to get the client ip. This option allows to use a request attribute. Useful to combine with a ip detection middleware, for example client-ip., _(*6)

attribute(string $attribute)

The attribute name used to store the client addresses in the server request. By default is client-location., _(*7)

Please see CHANGELOG for more information about recent changes and CONTRIBUTING for contributing details., _(*8)

The MIT License (MIT). Please see LICENSE for more information., _(*9)