kielabokkie / laravel-ipdata
Laravel wrapper for kielabokkie/ipdata-php
Installs: 28 583
Dependents: 0
Suggesters: 0
Security: 0
Stars: 5
Watchers: 3
Forks: 2
Open Issues: 0
Requires
- php: >=7.1
- kielabokkie/ipdata: ^0.2
This package is auto-updated.
Last update: 2024-11-10 15:43:46 UTC
README
Laravel wrapper for the kielabokkie/ipdata-php package which retrieves IP address information the using the ipdata.co API.
Prerequisites
Ipdata has a free plan that allows you to make 1,500 requests per day and paid plans if you need more than that. All plans need an API key and you'll have to register on their website to get one.
Installation
Install the package via composer:
composer require kielabokkie/laravel-ipdata
If you are on Laravel 5.4 or lower or don't use Laravel's auto discovery, you should add the following to your config/app.php
:
'providers' => [ // ... Kielabokkie\LaravelIpdata\IpdataServiceProvider::class, ] 'aliases' => [ // ... 'Ipdata' => Kielabokkie\LaravelIpdata\Facades\Ipdata::class, )
Config
Add the following to your config/services.php
file:
// ... 'ipdata' => [ 'api_key' => env('IPDATA_API_KEY'), ],
Update your .env
file and enter the API key you got from Ipdata:
IPDATA_API_KEY=youkeyhere
Usage
Lookup of the calling IP address
use Kielabokkie\LaravelIpdata\Facades\Ipdata; $res = Ipdata::lookup();
Lookup a specific IP address
use Kielabokkie\LaravelIpdata\Facades\Ipdata; $res = Ipdata::lookup('1.1.1.1');
The Ipdata API will return the following data:
{ "ip": "1.1.1.1", "is_eu": false, "city": "Research", "region": "Victoria", "region_code": "VIC", "country_name": "Australia", "country_code": "AU", "continent_name": "Oceania", "continent_code": "OC", "latitude": -37.7, "longitude": 145.1833, "asn": "AS13335", "organisation": "Cloudflare Inc", "postal": "3095", "calling_code": "61", "flag": "https://ipdata.co/flags/au.png", "emoji_flag": "🇦🇺", "emoji_unicode": "U+1F1E6 U+1F1FA", "languages": [ { "name": "English", "native": "English" } ], "currency": { "name": "Australian Dollar", "code": "AUD", "symbol": "AU$", "native": "$", "plural": "Australian dollars" }, "time_zone": { "name": "Australia/Melbourne", "abbr": "AEST", "offset": "+1000", "is_dst": false, "current_time": "2018-06-20T11:41:23.068040+10:00" }, "threat": { "is_tor": false, "is_proxy": false, "is_anonymous": false, "is_known_attacker": false, "is_known_abuser": false, "is_threat": false, "is_bogon": false } }
This library will run the response through a json_decode giving you an easy object to work with, for example:
echo $res->country_name; // Australia echo $res->flag; // https://ipdata.co/flags/au.png