README

Determine the geographical location of website visitors based on their IP addresses.

Installation

To get the latest version of GeoIP simply require it in your composer.json file.

"furey-imagination/laravel4-geoip": "0.1.*"

You'll then need to run composer install to download it and have the autoloader updated.

Once GeoIP is installed you need to register the service provider with the application. Open up app/config/app.php and find the providers key.

'providers' => array(

    'Torann\GeoIP\GeoIPServiceProvider',

)

GeoIP also ships with a facade which provides the static syntax for creating collections. You can register the facade in the aliases key of your app/config/app.php file.

'aliases' => array(

    'GeoIP' => 'Torann\GeoIP\GeoIPFacade',

)

Create configuration file using artisan

$ php artisan config:publish furey-imagination/laravel4-geoip

Usage

Get the location data for a website visitor:

$location = GeoIP::getLocation();

When an IP is not given the $_SERVER["REMOTE_ADDR"] is used.

Getting the location data for a given IP:

$location = GeoIP::getLocation( '232.223.11.11' );

Example Data

array (
    "ip"           => "232.223.11.11",
    "isoCode"      => "US",
    "country"      => "United States",
    "city"         => "New Haven",
    "state"        => "CT",
    "postal_code"  => "06510",
    "lat"          => 41.28,
    "lon"          => -72.88,
    "timezone"     => "America/New_York",
    "continent"    => "NA",
    "default"      => false
);

Note

In the case that a location is not found the fallback location will be returned with the default parameter set to true. In a future release I'll make the default location customizable. For not it is New Haven, CT.

Services

MaxMind

Database Service: To use the database version of MaxMind services download the GeoLite2-City.mmdb from http://dev.maxmind.com/geoip/geoip2/geolite2/ and extract it to /app/database/maxmind/. And that's it.

furey-imagination / laravel4-geoip

Maintainers

Details