PHPackages interaction-design-foundation/laravel-geoip - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. interaction-design-foundation/laravel-geoip ActiveLibrary[Utility & Helpers](/categories/utility) interaction-design-foundation/laravel-geoip =========================================== Support for multiple Geographical Location services. 4.3.0(4mo ago)19284.0k↑30.5%3[1 PRs](https://github.com/InteractionDesignFoundation/laravel-geoip/pulls)3BSD-2-ClausePHPPHP ^8.3CI passing Since Dec 12Pushed 1mo ago1 watchersCompare [ Source](https://github.com/InteractionDesignFoundation/laravel-geoip)[ Packagist](https://packagist.org/packages/interaction-design-foundation/laravel-geoip)[ RSS](/packages/interaction-design-foundation-laravel-geoip/feed)WikiDiscussions main Synced 2w ago READMEChangelog (10)Dependencies (39)Versions (78)Used By (3) GeoIP for Laravel ================= [](#geoip-for-laravel) [![run-tests](https://github.com/InteractionDesignFoundation/laravel-geoip/actions/workflows/run-tests.yml/badge.svg)](https://github.com/InteractionDesignFoundation/laravel-geoip/actions/workflows/run-tests.yml)[![Type coverage](https://camo.githubusercontent.com/3bace52c1359596574795a3904717b00411a6c328a0e87cb7c1ede7e28210376/68747470733a2f2f73686570686572642e6465762f6769746875622f496e746572616374696f6e44657369676e466f756e646174696f6e2f6c61726176656c2d67656f69702f636f7665726167652e737667)](https://shepherd.dev/github/InteractionDesignFoundation/laravel-geoip)[![Psalm error level](https://camo.githubusercontent.com/3f35770dbd9811e064cd3442091bedfb1e502932a921be45765c86929eef4a1b/68747470733a2f2f73686570686572642e6465762f6769746875622f496e746572616374696f6e44657369676e466f756e646174696f6e2f6c61726176656c2d67656f69702f6c6576656c2e737667)](https://shepherd.dev/github/InteractionDesignFoundation/laravel-geoip) Determine the geographical location and currency of website visitors based on their IP addresses. > Actively maintained fork of [`torann/geoip`](https://github.com/Torann/laravel-geoip) with modern PHP/Laravel support, better types, and additional features. [Migration guide](./docs/migration.md). Installation ------------ [](#installation) ``` composer require interaction-design-foundation/laravel-geoip ``` Publish the config file: ``` php artisan vendor:publish --provider="InteractionDesignFoundation\GeoIP\GeoIPServiceProvider" --tag=config ``` Set the `GEOIP_SERVICE` env variable to one of the [supported services](#services). Quick Start ----------- [](#quick-start) Use the `geoip()` helper or the `GeoIP` facade: ``` // Get location for an IP $location = geoip('203.0.113.1'); // Get location for the current visitor $location = geoip()->getLocation(); // Access location data $location->city; // "New Haven" $location->country; // "United States" $location->iso_code; // "US" $location->timezone; // "America/New_York" $location->currency; // "USD" ``` The `Location` object contains: `ip`, `iso_code`, `country`, `city`, `state`, `state_name`, `postal_code`, `lat`, `lon`, `timezone`, `continent`, `currency`, `default`, and `cached`. It implements `ArrayAccess`, so both `$location->city` and `$location['city']` work. Services -------- [](#services) Set the service via the `GEOIP_SERVICE` env variable or in `config/geoip.php`: ServiceKeyRequires[MaxMind Database](https://www.maxmind.com/en/geoip2-databases)`maxmind_database``geoip2/geoip2` package + license key[MaxMind Web API](https://www.maxmind.com/en/geoip2-precision-services)`maxmind_api``geoip2/geoip2` package + user ID & license key[IP-API](https://ip-api.com/)`ipapi`API key (for HTTPS)[IPGeolocation](https://ipgeolocation.io/)`ipgeolocation`API key[IPData](https://ipdata.co/)`ipdata`API key[IPFinder](https://ipfinder.io/)`ipfinder`API key[IP2Location](https://www.ip2location.io/)`ip2location`API keyFor detailed service configuration, see [services documentation](./docs/services.md). Configuration ------------- [](#configuration) Key options in `config/geoip.php`: ### Caching [](#caching) GeoIP caches lookups using Laravel's cache system to reduce API calls. Set the `cache` option to: - `all` -- cache all lookups - `some` -- cache only the current user's lookup - `none` -- disable caching You can also configure `cache_tags`, `cache_expires` (TTL in seconds), and `cache_prefix`. ### Currency Detection [](#currency-detection) When `include_currency` is enabled (default), the package resolves the visitor's currency from their country ISO code using the [league/iso3166](https://github.com/thephpleague/iso3166) package. ### Default Location [](#default-location) Configure a fallback location returned when a lookup fails or the IP is local/invalid. Artisan Commands ---------------- [](#artisan-commands) ``` # Download/update the local GeoIP database (required for maxmind_database) php artisan geoip:update # Clear cached locations php artisan geoip:clear ``` Changelog --------- [](#changelog) See [Releases](https://github.com/InteractionDesignFoundation/laravel-geoip/releases) for what has changed recently. Contributing ------------ [](#contributing) See [CONTRIBUTING](.github/CONTRIBUTING.md) for details. ### Health Score 67 — FairBetter than 99% of packages Maintenance85 Actively maintained with recent releases Popularity45 Moderate usage in the ecosystem Community27 Small or concentrated contributor base Maturity93 Battle-tested with a long release history Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~78 days Recently: every ~96 days Total 58 Last Release 137d ago Major Versions 0.2.3 → 1.0.02016-10-03 0.2.4 → 1.0.32017-01-26 0.2.5 → 1.0.42017-06-21 1.2.1 → 3.0.12020-09-10 3.7.4 → 4.0.0-rc12025-03-11 PHP version history (11 changes)0.1.0PHP >=5.3.0 1.0.0PHP >=5.5.9 1.0.9PHP ^7.0 1.0.10PHP ^7.1 1.2.0PHP ^7.2 3.0.2PHP ^7.2 || ^8.0 3.1.0PHP ^8.0|^8.1 3.1.1PHP ^8.0 3.4.0PHP ^8.1 4.1.0PHP ^8.2 4.2.0PHP ^8.3 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/90964642?v=4)[IxDF](/maintainers/IxDF)[@ixdf](https://github.com/ixdf) --- Top Contributors [![alies-dev](https://avatars.githubusercontent.com/u/5278175?v=4)](https://github.com/alies-dev "alies-dev (168 commits)")[![Torann](https://avatars.githubusercontent.com/u/1406755?v=4)](https://github.com/Torann "Torann (108 commits)")[![dotpack](https://avatars.githubusercontent.com/u/1175814?v=4)](https://github.com/dotpack "dotpack (10 commits)")[![lptn](https://avatars.githubusercontent.com/u/150333538?v=4)](https://github.com/lptn "lptn (9 commits)")[![jessarcher](https://avatars.githubusercontent.com/u/4977161?v=4)](https://github.com/jessarcher "jessarcher (6 commits)")[![dwightwatson](https://avatars.githubusercontent.com/u/1100408?v=4)](https://github.com/dwightwatson "dwightwatson (6 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (3 commits)")[![highstrike](https://avatars.githubusercontent.com/u/2379538?v=4)](https://github.com/highstrike "highstrike (3 commits)")[![kyranb](https://avatars.githubusercontent.com/u/5426926?v=4)](https://github.com/kyranb "kyranb (3 commits)")[![osmhub](https://avatars.githubusercontent.com/u/13149318?v=4)](https://github.com/osmhub "osmhub (3 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (2 commits)")[![Pythagus](https://avatars.githubusercontent.com/u/34168890?v=4)](https://github.com/Pythagus "Pythagus (2 commits)")[![LukeT](https://avatars.githubusercontent.com/u/2203091?v=4)](https://github.com/LukeT "LukeT (2 commits)")[![rjp2525](https://avatars.githubusercontent.com/u/1334865?v=4)](https://github.com/rjp2525 "rjp2525 (2 commits)")[![mithredate](https://avatars.githubusercontent.com/u/6016632?v=4)](https://github.com/mithredate "mithredate (2 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (2 commits)")[![janicerar](https://avatars.githubusercontent.com/u/29040621?v=4)](https://github.com/janicerar "janicerar (2 commits)")[![Butochnikov](https://avatars.githubusercontent.com/u/4212297?v=4)](https://github.com/Butochnikov "Butochnikov (2 commits)")[![rasoulrahimii](https://avatars.githubusercontent.com/u/24825810?v=4)](https://github.com/rasoulrahimii "rasoulrahimii (1 commits)")[![sakalauskas](https://avatars.githubusercontent.com/u/1455148?v=4)](https://github.com/sakalauskas "sakalauskas (1 commits)") --- Tags geolocationipapiipdataipfinderipgeolocationlaravellaravel-geolocationlaravel-packagemaxdbmaxmindmaxmind-geoiplaravelgeoipgeolocationlocationgeographicalIP APIinfoDB ### Code Quality TestsPHPUnit Static AnalysisPHPStan, Psalm, Rector Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/interaction-design-foundation-laravel-geoip/health.svg) ``` [![Health](https://phpackages.com/badges/interaction-design-foundation-laravel-geoip/health.svg)](https://phpackages.com/packages/interaction-design-foundation-laravel-geoip) ``` ### Alternatives [torann/geoip Support for multiple Geographical Location services. 2.2k15.7M104](/packages/torann-geoip)[propaganistas/laravel-disposable-email Disposable email validator 6023.2M7](/packages/propaganistas-laravel-disposable-email)[mike-bronner/laravel-model-caching Automatic caching for Eloquent models. 2.4k161.4k2](/packages/mike-bronner-laravel-model-caching)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 265.2k](/packages/aedart-athenaeum)[iazaran/smart-cache Smart Cache is a caching optimization package designed to enhance the way your Laravel application handles data caching. It intelligently manages large data sets by compressing, chunking, or applying other optimization strategies to keep your application performant and efficient. 21114.2k](/packages/iazaran-smart-cache)[forjedio/inertia-table Backend-driven dynamic tables for Laravel + Inertia.js 272.0k](/packages/forjedio-inertia-table) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)