geocoder-php/stack-geo-ip

Geolocation Stack middleware for Geocoder library.

StackGeoIp

Geolocation Stack middleware that adds geolocation results to the request for subsequent middlewares by leveraging the Geocoder library., _(*1)

, _(*2)

Usage

Example

Here we create a simple application that returns the IP address of the request and the contents of the X-Country header to the browser. Normally, the X-Country header would not exists., _(*3)

By wrapping the GeoIP middleware around it using the StackBuilder, if the IP address can be matched to a country, the X-Country header will be set to the two-letter code for that country, and be available to the application., _(*4)

<?php

use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\HttpFoundation\RedirectResponse;

require __DIR__ . '/vendor/autoload.php';

$app = new \Silex\Application();

$app->get('/', function(Request $request) {
    $ip      = $request->getClientIp();
    $country = $request->headers->get('X-Country', 'UNKNOWN');

    return new Response($ip . ' => '. $country, 200);
});

$stack = (new \Stack\Builder())
    ->push('Geocoder\Stack\GeoIp')
    ;

$app = $stack->resolve($app);

$request  = Request::createFromGlobals();
$response = $app->handle($request)->send();
$app->terminate($request, $response);

Options

The following options can be used:, _(*5)

• adapter (optional): The Geocoder HTTP adapter to use. Defaults to cURL adapter., _(*6)

• provider (optional): The Geocoder provider to use. Defaults to the FreeGeoIP provider. For production, it is recommended to use a provider that relies on local files rather than HTTP requests, such as Max Mind binary provider., _(*7)

• header (optional): The name of the HTTP header to store the country result in. Defaults to "X-Country"., _(*8)

See the Geocoder documentation for a list of available adapters and providers., _(*9)

Intallation

The recommended way to install StackGeoIp is through Composer:, _(*10)

json { "require": { "geocoder-php/stack-geo-ip": "@stable" } }, _(*11)

Protip: you should browse the geocoder-php/stack-geo-ip page to choose a stable version to use, avoid the @stable meta constraint., _(*12)

License

StackGeoIp is released under the MIT License. See the bundled LICENSE file for details., _(*13)