arielmejiadev/geo-ip

Resolve a visitor's country and location from their IP address in Laravel — modern syntax, swappable drivers (MaxMind GeoLite2, ip-api, ipinfo), zero external calls when you want them.

v1.0.1 2026-05-29 00:58 UTC

Requires

• php: ^8.2
• geoip2/geoip2: ^3.0
• illuminate/contracts: ^12.0||^13.0
• spatie/laravel-package-tools: ^1.16

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.14
• nunomaduro/collision: ^8.8
• orchestra/testbench: ^11.0.0||^10.0.0
• pestphp/pest: ^4.0
• pestphp/pest-plugin-arch: ^4.0
• pestphp/pest-plugin-laravel: ^4.0
• phpstan/extension-installer: ^1.4
• phpstan/phpstan-deprecation-rules: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• spatie/laravel-ray: ^1.35

MIT

• ArielMejiaDev

• laravel
• geo-ip
• arielmejiadev

README

Resolve a visitor's country and geolocation from their IP address using swappable drivers — DB-IP Lite (default, free, no signup), MaxMind GeoLite2, ip-api, or ipinfo.

Documentation

Full documentation is available at arielmejiadev.github.io/geo-ip.

Quick Start

composer require arielmejiadev/geo-ip
php artisan geo-ip:install

This publishes the config and downloads the free DB-IP Lite database (no signup or API key needed).

Usage

One-shot lookups

use ArielMejiaDev\GeoIp\Facades\GeoIp;

GeoIp::country('8.8.8.8');       // 'United States'
GeoIp::countryCode('8.8.8.8');   // 'US'
GeoIp::city('8.8.8.8');          // 'Mountain View'
GeoIp::timezone('8.8.8.8');      // 'America/Los_Angeles'
GeoIp::coordinates('8.8.8.8');   // ['latitude' => 37.386, 'longitude' => -122.084]

Fluent API

$ip = GeoIp::of('8.8.8.8');

$ip->country();      // 'United States'
$ip->is('US');       // true
$ip->isIn(['US', 'CA', 'MX']); // true

// Conditional logic
GeoIp::of($ip)
    ->whenCountry('US', fn ($ip) => handleUs($ip))
    ->whenIn(['MX', 'CO', 'AR'], fn ($ip) => handleLatam($ip))
    ->toArray();

// From the current request
GeoIp::fromRequest()->countryCode();

Drivers

Driver	Env Value	Requirements
DB-IP Lite	dbip (default)	php artisan geo-ip:install
MaxMind GeoLite2	maxmind	License key + php artisan geo-ip:install --maxmind
ip-api.com	ip-api	None (45 req/min limit)
ipinfo.io	ipinfo	IPINFO_TOKEN
Null	null	None (for testing)

Set the driver in .env:

GEOIP_DRIVER=dbip

Testing

composer test

Set the driver to null in your test environment to avoid external calls:

<env name="GEOIP_DRIVER" value="null"/>

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• ArielMejiaDev
• All Contributors

License

The MIT License (MIT). Please see License File for more information.