Laravel Package to utilise MaxMind GeoLite2 Database for IP based GeoLocation

v1.0.2 2023-07-26 10:55 UTC

This package is auto-updated.

Last update: 2024-02-08 09:26:52 UTC


This package utilises the MaxMind GeoLite databases to allow GeoLocation of an IP Address.

Console Commands

php artisan geolocation:update

Downloads a recent archive of the database from MaxMind, validates the hash, and stores on a remote disk (e.g S3) as specified in configuration.

php artisan geolocation:fetch

Fetches, extracts, and moves to application storage, the archive previously stored on a remove disk (e.g S3)


Once a database has been downloaded and extracted to the app local storage directory, to geolocate an IP address, use the provided facade, as such:

use CyberDuck\GeoLocate\Facades\GeoLocate;

$result = GeoLocate::country('');

// $result is an instance of \GeoIp2\Record\Country

$result->isoCode // == 'GB' for example.