NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #1225 most downloaded on Packagist
Retrieve a user's location by their IP Address
Latest stable
v7.8.2
Last release 12 days ago
09 Nov 2026
Release timing varies
gaps range from 8 days to 7 months
Most releases are documented
notes for 51 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
73 releases · first in 2014
Drag across the ruler to compare, or tap a release to open it.
Deprecate zipCode in favor of postalCode by @tegos in https://github.com/stevebauman/location/pull/422
Add example output to README and clean up driver fields by @tegos - https://github.com/stevebauman/location/pull/421
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Support shared MaxMind databases with coordinated local refreshes by @stevebauman + @georgebohnisch - https://github.com/stevebauman/location/pull/420
Allow Guzzle ^8 alongside ^7 by @rwinkelman - https://github.com/stevebauman/location/pull/416
Fix LocationManager::get() return type and simplify it. by @gonssal - https://github.com/stevebauman/location/pull/408
LocationManager::get() return type and simplify it. by @gonssal - https://github.com/stevebauman/location/pull/408Laravel 13.x Compatibility - https://github.com/stevebauman/location/pull/406
Initialize currencyCode to null by @rogermedico - https://github.com/stevebauman/location/pull/405
currencyCode to null by @rogermedico - https://github.com/stevebauman/location/pull/405MaxMind Web Service client locales parameter by @phuclh - https://github.com/stevebauman/location/pull/404
Add IpInfo Lite driver support by @nzkozar - https://github.com/stevebauman/location/pull/398
Add .gitattributes to clean up composer installs - https://github.com/stevebauman/location/pull/402
.gitattributes to clean up composer installs - https://github.com/stevebauman/location/pull/402Laravel 12 support - 10d41f523ff6443debbaf7d7de7f8afc41372d18
Ip2locationio.php - 61328732392eb672537a8e2aef4edad5fafb9372$position->postalCode to postal for IpInfo driver - b7d8121f738fef70a124c6f49414e7b2f52e87bbLaravel 8 compatibility - b7caada - #185
Ability to fake requests and responses with Location::fake - 367a4c5d631d10ad2fbf61cde6c2005262411368 - Docs
Location::fake - 367a4c5d631d10ad2fbf61cde6c2005262411368 - DocsPosition instances with Position::make - c1c77fb17daf097487ef9235c98a0ba7efc8e852Don't report exception when location is not found using Maxmind driver - https://github.com/stevebauman/location/pull/184
MaxMind MMDB extraction root and directory in Windows by @3likayed - https://github.com/stevebauman/location/pull/180
PharException when trying to update MaxMind files - https://github.com/stevebauman/location/pull/178, #177
Config path maxmind.web.license_key has been moved up a level to maxmind.license_key - 95ad0a9, d857a44
maxmind.web.license_key has been moved up a level to maxmind.license_key - 95ad0a9, d857a44Macroable Trait to LocationManager for Extensibility by @a1383n - https://github.com/stevebauman/location/pull/174Maxmind download URLs by @dbrlk - https://github.com/stevebauman/location/pull/170
Select IP API Pro fields in request by @robdekort - https://github.com/stevebauman/location/pull/165
Laravel 11 compatibility - https://github.com/stevebauman/location/pull/163
Incorrect property access on MaxMind driver when passing off in… by @craigpaul - https://github.com/stevebauman/location/pull/161
Bug 157 - Permission denied tmp directory - https://github.com/stevebauman/location/pull/159
tmp directory - https://github.com/stevebauman/location/pull/159
.tar Maxmind files in configured path instead of tmpAdded extra headers to Cloudflare Driver by @AlejandroBBL - https://github.com/stevebauman/location/pull/155
Ensure HTTP exceptions are thrown so false is returned by driver - https://github.com/stevebauman/location/commit/b27e95e9746176ec72f65258c8812694a079
false is returned by driver - https://github.com/stevebauman/location/commit/b27e95e9746176ec72f65258c8812694a079df96IP2Location.io Driver by @ip2location - https://github.com/stevebauman/location/pull/150
Ignore Report by @joaopalopes24 - https://github.com/stevebauman/location/pull/144
In version 7, the codebase has been updated with strict PHP types, updated PHP and Laravel version requirements, an updated Driver structure, as well
In version 7, the codebase has been updated with strict PHP types,
updated PHP and Laravel version requirements, an updated Driver
structure, as well as a small configuration addition.
In version 7, location drivers can now implement an Updatable interface
that allows them to be updated using the location:update command.
Currently, only the MaxMind driver supports this.
To update your configuration file to be able to download the latest
MaxMind database file automatically, insert the below url
configuration option in your config/location.php file:
// config/location.php
return [
'maxmind' => [
// ...
'local' => [
// ...
+ 'url' => sprintf('https://download.maxmind.com/app/geoip_download_by_token?edition_id=GeoLite2-City&license_key=%s&suffix=tar.gz', env('MAXMIND_LICENSE_KEY')),
],
],
];
Once done, you may execute the below artisan command to download the latest .mmdb file:
php artisan location:update
In version 7, the codebase has been updated with strict PHP
types, updated PHP and Laravel version requirements,
and an updated Driver structure.
If you have created your own custom driver implementation,
you must update it to use the base Driver or HttpDriver class.
If you're fetching a location using an HTTP service, it
may be useful to extend the HttpDriver to reduce
the code you need to write:
namespace App\Location\Drivers;
use Illuminate\Support\Fluent;
use Stevebauman\Location\Position;
- use Stevebauman\Location\Drivers\Driver;
+ use Stevebauman\Location\Drivers\HttpDriver;
- class MyDriver extends Driver
+ class MyDriver extends HttpDriver
{
- public function url($ip)
+ public function url(string $ip): string;
{
return "http://driver-url.com?ip=$ip";
}
- protected function process($ip)
- {
- return rescue(function () use ($ip) {
- $response = json_decode(file_get_contents($this->url($ip)), true);
-
- return new Fluent($response);
- }, $rescue = false);
- }
- protected function hydrate(Position $position, Fluent $location)
+ protected function hydrate(Position $position, Fluent $location): Position;
{
$position->countryCode = $location->country_code;
return $position;
}
}
Fix Kloudend (ipapi.co) integration with empty tokens by @rhwilr - https://github.com/stevebauman/location/pull/136
# Added - Laravel 10 support
ipapi.co integration by @boogiefromzk in https://github.com/stevebauman/location/pull/126
ipapi.co driver by Kloudend by @ipapi-co - https://github.com/stevebauman/location/pull/112
Composer description typo - by @8ctopus - https://github.com/stevebauman/location/pull/107
Properly retrieve timezone from the MaxMind driver - #102
Timezone support - https://github.com/stevebauman/location/pull/98 - Thanks to @mohkoma
IpData driver - c7eb8f3...15de260 - #96 -thanks to @Rijoanul-Shanto 🎉
GeoIP version requirement from v2.8.0 to ^v2.0 - #91
v2.8.0 to ^v2.0 - #91Actually require PHP 7.0 as mentioned in the readme
Stevebauman\Location\Location instance uses Laravel's config Repository instance instead of config() helperLaravel 8.0 support - 0246472 - #83
Ability to customize Position instance created and returned by drivers via configuration - 668fff3 - #74
Position instance created and returned by drivers via configuration - 668fff3 - #74## Added - Laravel 7.0 support
Invalid configuration path for IpApiPro - #65 - Thanks to @callumMcComisky
$ip parameter to Driver::url() method to allow easier URL building - 1008328
$ip parameter to Driver::url() method to allow easier URL building - 1008328ip public property to returned Position objects - 6369091isoCode is now set when using the MaxMind driver - 1924c29Location facade method annotations (get() & setDriver()) - 08f20e9
Location facade method annotations (get() & setDriver()) - 08f20e9isEmpty() method to Position class - 0f38b93Position now implements the Illuminate\Contracts\Support\Arrayable interface for the toArray() method - 0957049Position attributes are now null by default instead of empty strings - 4edf26aPosition will now fallback to another driver - edab47dLaravel 6.0 support - cd24972 - #62
Fallback drivers not being called properly - 5dc72ec - #35, #45
Calling Location::get() will now always request a new location, not from session
Location::get() will now always request a new location, not from sessionNothing published for this version
Rebuilt. Please view the readme for more information.
Nothing published for this version
Removed Telize driver due to public API being shutdown
Nothing published for this version
Bind location instance in service provider boot method instead of register
Service provider is now Laravel 5 only
Fixed: https://github.com/stevebauman/location/pull/24
Fixed: https://github.com/stevebauman/location/pull/24
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.