buonzz/laravel-4-freegeoip

Laravel 4 Library for detecting geogpraphical location info of your visitors

FreeGeoIP for Laravel 4

, _(*1)

Laravel 4 Library for calling http://freegeoip.net/ API., _(*2)

In contrary to all other packages wherein it requires that you have the geoip database in your filesystem, this library calls a free service So you dont really have to worry about downloading and maintaining geoip data from Maxmind in your own server., _(*3)

Just install the package, add the config and it is ready to use!, _(*4)

Requirements

• PHP >= 5.3.7
• cURL Extension

Installation

composer require buonzz/laravel-4-freegeoip:dev-master

Add the service provider and facade in your config/app.php, _(*5)

Service Provider, _(*6)

Buonzz\GeoIP\Laravel4\ServiceProviders\GeoIPServiceProvider

Facade, _(*7)

'GeoIP'            => 'Buonzz\GeoIP\Laravel4\Facades\GeoIP',

Configuration

This library supports optional configuration., _(*8)

To get started, first publish the package config file:, _(*9)

$ php artisan config:publish buonzz/laravel-4-freegeoip

• freegeopipURL: defines the URL of the FreeGeoIP API. Use HTTPS or not. Default to http://www.freegeoip.net/json/.
• timeout: defines the timeout when calling the FreeGeoIP API (in seconds). Default to 30.

Usage

Get country of the visitor, _(*10)

GeoIP::getCountry();  // returns "United States"

Get country code of the visitor, _(*11)

GeoIP::getCountryCode();  // returns "US"

Get region of the visitor, _(*12)

GeoIP::getRegion();  // returns "New York"

Get region code of the visitor, _(*13)

GeoIP::getRegionCode();  // returns "NY"

Get city of the visitor, _(*14)

GeoIP::getCity();  // returns "Buffalo"

Get zip code of the visitor, _(*15)

GeoIP::getZipCode();  // returns "14221"

Get latitude of the visitor, _(*16)

GeoIP::getLatitude();  // returns "42.9864"

Get longitude of the visitor, _(*17)

GeoIP::getLongitude();  // returns "-78.7279"

Get metro code of the visitor, _(*18)

GeoIP::getMetroCode();  // returns "514"

Get area code of the visitor, _(*19)

GeoIP::getAreaCode();  // returns "716"

Credits

• Alexandre Fiori for the awesome http://freegeoip.net web api
• MaxMind for the data