Stack middleware for adding geolocation results as a HTTP header to the request.
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.


Geolocation Stack middleware that adds geolocation results to the request for subsequent middlewares by leveraging the Geocoder library.

Build Status



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.

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.


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())

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

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


The following options can be used:

  • adapter (optional): The Geocoder HTTP adapter to use. Defaults to cURL adapter.

  • 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.

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

See the Geocoder documentation for a list of available adapters and providers.


The recommended way to install StackGeoIp is through Composer:

    "require": {
        "geocoder-php/stack-geo-ip": "@stable"

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


StackGeoIp is released under the MIT License. See the bundled LICENSE file for details.