d3catalyst/l4-geoip

Laravel 4 Library for detecting geogpraphical location info.

1.0.1 2014-07-28 23:05 UTC

This package is not auto-updated.

Last update: 2024-11-19 03:03:07 UTC


README

Build Status Latest Stable Version Total Downloads Latest Unstable Version License Scrutinizer Code Quality

Laravel 4 Library for calling http://ip-api.com/ API.

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.

Just install the package, add the config and it is ready to use!

Requirements

  • PHP >= 5.3.7
  • cURL Extension

Installation

Add in composer.json
"d3catalyst/l4-geoip": "dev-master"

Add the service provider and facade in your config/app.php

Service Provider

D3Catalyst\GeoIP\Laravel4\ServiceProviders\GeoIPServiceProvider

Facade

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

Usage

Set IP of the visitor (Optional)

GeoIP::setIp("127.0.0.1");  // Optional set ip, when not set this take automatical from REMOTE_HOST

Get country of the visitor

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

Get country code of the visitor

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

Get region of the visitor

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

Get region code of the visitor

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

Get city of the visitor

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

Get zip code of the visitor

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

Get latitude of the visitor

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

Get longitude of the visitor

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

Get timezone of the visitor

GeoIP::getTimezone();  // returns "America/Mexico_City"

Get ISP of the visitor

GeoIP::getIsp();  // returns "Internet Service provider"

Get ALL geo information of visitor

GeoIP::getAll();  // returns array with all information