NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #2979 most downloaded on Packagist
Laravel countries, states, cities, currencies, languages and IP geolocation
Latest stable
2.0.1
Last release 1 months ago
10 Oct 2026
Ships fairly regularly
a new release about every 3 months
Nearly every release is documented
notes for 11 of 12 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
12 releases · first in 2024
Drag across the ruler to compare, or tap a release to open it.
Fixes country, currency, and language searches returning records outside supplied filters. Search alternatives are now grouped so every result must sa
Fixes country, currency, and language searches returning records outside supplied filters. Search alternatives are now grouped so every result must satisfy all filters, including when the search string is empty.
For example, filtering to iso2=FR while searching for Germany now returns an empty result rather than Germany.
With an existing ^2.0 constraint:
composer update nnjeim/world
For an exact version pin:
composer require nnjeim/world:2.0.1
Deploy the updated lock file. No database migration, data refresh, or configuration change is required. Dataset contents and runtime requirements are unchanged from 2.0.0. Existing 1.x tags remain available.
2.0 documentation · Patch and major upgrade guide · Changelog
World 2.0 replaces destructive refresh and seeding with preserving, transactional synchronization. Existing facade methods, routes, and default API re
Your coding agent can read these notes before it upgrades. Set up the MCP server →
World 2.0 replaces destructive refresh and seeding with preserving, transactional synchronization. Existing facade methods, routes, and default API response formats remain available.
This is a major release because maintenance behavior changes. Read the 2.0 upgrade guide before changing your Composer constraint.
php -d memory_limit=1G; prepare your cache store for synchronization locks.Install or explicitly upgrade:
composer require nnjeim/world:^2.0
php -d memory_limit=1G artisan world:refresh --dry-run
php -d memory_limit=1G artisan world:refresh --force
Existing ^1.1, ^1.1.39, exact 1.x pins, and lock files remain on their selected 1.x versions. Published Git tags remain intact. Use the separate 1.x documentation when staying on 1.x.
flag and ISO2 flag helper (#120), without a schema change.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 columnNew 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 to the world install console command
fix to 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.
One column per month.