NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist · #3588 most downloaded on Packagist
Laravel countries, states, cities, currencies, languages and IP geolocation
Last release 15 days ago
22 Sep 2026
Ships fairly regularly
a new release about every 4 months
Nearly every release is documented
notes for 9 of 10 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
10 releases · first in 2024
Added the 11 new Algerian wilayas from the November 2025 territorial reform (codes 59-69) and reassigned their cities from the parent provinces Added
Added the 11 new Algerian wilayas from the November 2025 territorial reform (codes 59-69) and reassigned their cities from the parent provinces
Added Hungarian localization
Updated the Bengali translation for Kosovo
Updated Bulgaria's currency to the Euro
Fixed translation publishing paths for modern Laravel applications
Changed cacheKey generation to use app()->getLocale()
Added methods PHPDoc to WorldHelper
Fixed Laravel 13 compatibility issues by updating caching from saving collections to arrays
Fixed World::setLocale() so it changes Laravel's active runtime locale
Added global and per-action cache controls with predictable one-action overrides
Upgraded geoip2/geoip2 to v3 and raised the minimum PHP version to 8.1
Added Guzzle as an explicit dependency for the geolocation API fallback
Added standalone SQLite tests and CI coverage for Laravel 10–13 on PHP 8.1–8.4
Added automated world-data and localization integrity checks
Fixed Undefined array key "class" error when running php artisan world:install with geolocate module enabled
Undefined array key "class" error when running php artisan world:install with geolocate module enabledstate_code columnOne column per month.
New Geolocate Module: IP-based geolocation feature Added World::geolocate() facade method for IP geolocation Added GET /api/geolocate endpoint with au
New Geolocate Module: IP-based geolocation feature
Added World::geolocate() facade method for IP geolocation
Added GET /api/geolocate endpoint with automatic IP detection
Added MaxMind GeoLite2 database support via geoip2/geoip2 package
Added fallback to ip-api.com when database not installed
Added php artisan world:geoip command to download GeoLite2 database
Added Geolocate middleware for automatic IP resolution from headers
IP detection supports: CF-Connecting-IP, X-Forwarded-For, X-Real-IP, CLIENT-IP
Returns linked Country, State, City models with database IDs when available
Configurable via world.modules.geolocate and world.geolocate settings
added Armenian locale support by @vahan
Addition of the azerbaijani localisation by @elnurvl .
Fix for the world install console command
Cities data correction by @kminek and @OzanKurt
Tested with Laravel 11 and Php 8.4
Nothing published for this version
Addition of the br, fr, hr, kr, pt locales @rinodrummer
See UPGRADE.md file.
Your coding agent can read these notes before it upgrades. Set up the MCP server →