Download the PHP package pulkitjalan/geoip without Composer
On this page you can find all versions of the php package pulkitjalan/geoip. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download pulkitjalan/geoip
More information about pulkitjalan/geoip
Files in pulkitjalan/geoip
Package geoip
Short Description IP Geolocation Wrapper with Laravel Support
License MIT
Homepage https://github.com/pulkitjalan/ip-geolocation
Informations about the package geoip
IP Geolocation
IP Geolocation Wrapper with Laravel Support
This package provides an easy way to get geolocation information from IP addresses. It supports multiple drivers including IP-API, MaxMind Database, MaxMind API, IPStack, IP2Location, and IPinfo.
Requirements
- PHP >= 8.1
Installation
Install via composer:
Laravel
There is a Laravel service provider and facade available.
Add the following to the providers
array in your config/app.php
Next add the following to the aliases
array in your config/app.php
Next publish the config file:
Using an older version of PHP / Laravel?
If you are on a PHP version below 8.1 or a Laravel version below 9.0, use an older version of this package.
Usage
The ipGeolocation class takes a config array as the first parameter or defaults to using the ip-api
driver.
Example:
IP-API
To use the ip-api pro service you can set the options in your config.
Pro Example:
Maxmind Database
To use Maxmind database as the driver you can set the options in your config.
Database Example:
Maxmind Api
To use Maxmind api as the driver you can set the options in your config.
Web API Example:
IPStack
To use the ipstack as the driver set the config.
Example:
IP2Location
To use IP2Location as the driver, set the config as follows:
Example:
IPinfo
To use IPinfo as the driver, set the config as follows:
Example:
Laravel
To use this package in Laravel, simply update the config file in config/ip-geolocation.php
to get the same effect. The driver can be set using the IPGEOLOCATION_DRIVER
env.
Available Methods
IPGeolocation will try to determin the ip using the following http headers: HTTP_CLIENT_IP
, HTTP_X_FORWARDED_FOR
, HTTP_X_FORWARDED
, HTTP_FORWARDED_FOR
, HTTP_FORWARDED
, REMOTE_ADDR
in this order. Optionally use the setIp
method to set it.
There are a number of available methods to pull out the required information. All methods will return an empty string if data is unavailable.
Get latitude
Get longitude
Get city
Get country
Get country code
Get region
Get region code
Get postal code
Get timezone
Get isp (not supported on all drivers)
Get all geo information
Get raw geo information
Update Database
There is an update command available to help with updating and installing a local ip geolocation database. The following will download and install/update the database file to /path/to/database.mmdb
. As of 30th December 2019, Maxmind requires users to create an account and use a license key to download the databases.
Laravel
Once you have registered the service provider (supports auto discovery), you can use the command php artisan ip-geolocation:update
Services
IP-API
IP-API is a free (or paid) service that can be used instead of the database file or the paid MaxMind service. They do have some limitations on the free service, so please review their documentation first.
MaxMind
You can use the free database from MaxMind (license key required) or their web API service. You can sign up and get a free license key here.
IPStack
IPStack is a real-time IP to geolocation API service. They offer both free and paid plans. You can find more information and sign up on their website.
IP2Location
IP2Location provides IP geolocation databases and web services. They offer various products and services, including both free and paid options. You can learn more and sign up on their website.
IPinfo
IPinfo is a comprehensive IP address data provider offering accurate geolocation, ASN, company, and other IP-related information. They provide both API and database download options. You can sign up for a free API key or explore their paid plans on their website.
License
The MIT License (MIT). Please see the License File for more information.
All versions of geoip with dependencies
illuminate/support Version ^10.0|^11.0
illuminate/console Version ^10.0|^11.0
guzzlehttp/guzzle Version ^7.5|^7.8
geoip2/geoip2 Version ^3.0