PHPackages azakhozhiy/laravel-iso-countries - 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. [Database & ORM](/categories/database) 4. / 5. azakhozhiy/laravel-iso-countries ActiveLibrary[Database & ORM](/categories/database) azakhozhiy/laravel-iso-countries ================================ Ready-to-use Laravel models and relations for country (ISO 3166), language (ISO 639-1), and currency (ISO 4217) information with multi-language support. 2.0.0(8mo ago)01[1 PRs](https://github.com/azakhozhiy/laravel-iso-countries/pulls)MITPHPPHP ^8.2 Since Aug 20Pushed 8mo agoCompare [ Source](https://github.com/azakhozhiy/laravel-iso-countries)[ Packagist](https://packagist.org/packages/azakhozhiy/laravel-iso-countries)[ Docs](https://github.com/io238/laravel-iso-countries)[ RSS](/packages/azakhozhiy-laravel-iso-countries/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (1)Dependencies (12)Versions (2)Used By (0) Laravel ISO Countries ===================== [](#laravel-iso-countries) [![Latest Version on Packagist](https://camo.githubusercontent.com/5692f17c28b99802576fc5e2173f3799584ad419f2ee4d922050aa2ef97b76ae/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f696f3233382f6c61726176656c2d69736f2d636f756e74726965732e7376673f6c6162656c3d56657273696f6e)](https://packagist.org/packages/io238/laravel-iso-countries)[![GitHub Tests Action Status](https://github.com/io238/laravel-iso-countries/workflows/Tests/badge.svg?branch=main)](https://github.com/io238/laravel-iso-countries/actions?query=workflow%3ATests+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/9093a00ee9770665b62dff3830d646291afda87e8a0e3136b6dc608b9af4fe04/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f696f3233382f6c61726176656c2d69736f2d636f756e74726965732e7376673f6c6162656c3d446f776e6c6f616473)](https://packagist.org/packages/io238/laravel-iso-countries) This package provides ready-to-use application models and seeds the database with ISO data from various sources. This package can be used in multi-language apps and supports Country/Language/Currency names in almost any locale. ### Included datasets [](#included-datasets) - [Countries: ISO 3166 alpha 2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) (incl. names, capital, lat/lon coordinates, TLD, phone calling code, regions, population, gini, area) - [Languages: ISO 639-1](https://en.wikipedia.org/wiki/ISO_639-1) (incl. names, language-family, wiki link) - [Currencies: ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) (incl. names, symbol, decimal digits, rounding) Unlike other packages, this one also includes relevant data relationships, such as: ``` // Official languages spoken in Luxembourg ('LU') Country::find('LU')->languages; // Currencies used in Ghana ('GH') Country::find('GH')->currencies; // Countries that have Spanish ('es') as one of their official languages Language::find('es')->countries; // Countries that use the Euro ('EUR') as currency Currency::find('EUR')->countries; ``` Installation ------------ [](#installation) You can install the package via composer: ``` composer require io238/laravel-iso-countries ``` The latest version of this package requires PHP version 8.0 or above. If you need support for PHP 7.4, please install version 2 of this package. ### Migrations [](#migrations) There is no need to run any migrations. All country data information is stored in a pre-compiled SQLITE database that is stored within this package. By default, this database includes all country/language/&currency names translated into English, German, French, and Spanish. If you want to compile your own database with other languages, please [see the instructions here](#data-updates--translations). ### Rebuilding the database [](#rebuilding-the-database) Country-level ISO data does not change very often. Nevertheless, if at any time you want to update the ISO data to the latest available version, you can manually re-seed the tables: ### Config [](#config) Optionally, you can publish the config file with: ``` php artisan vendor:publish --provider="Io238\ISOCountries\ISOCountriesServiceProvider" --tag="config" ``` In the config you can define, which translations of country/language/currency names you want to store in your DB. This is the contents of the published config file: ``` [ // Supported locales for names (countries, languages, currencies) 'locales' => [ 'en', 'de', 'fr', 'es', ], // Path for storing your own SQLITE database 'database_path' => database_path('iso-countries.sqlite'), ]; ``` After making changes to the config you need to re-build the database with the following command: ``` php artisan db:seed countries:build ``` This will create a new SQLITE database and stores it in your project at `database/iso-countries.sqlite`. Exclude this file from `.gitignore` to have it available in all environments. ``` # database/.gitignore *.sqlite* !iso-countries.sqlite ``` Usage ----- [](#usage) ### Country model [](#country-model) ``` Country::find('AD'); Io238\ISOCountries\Models\Country { id: "AD", alpha3: "AND", name: "{"en":"Andorra","de":"Andorra","fr":"Andorre","es":"Andorra"}", native_name: "Andorra", capital: "Andorra la Vella", top_level_domain: ".ad", calling_code: "376", region: "Europe", subregion: "Southern Europe", population: 78014, lat: 42.5, lon: 1.5, demonym: "Andorran", area: 468, } ``` ### Language model [](#language-model) ``` Country::find('pt'); Io238\ISOCountries\Models\Language { id: "pt", iso639_2: "por", iso639_2b: null, name: "{"en":"Portuguese","de":"Portugiesisch","fr":"portugais","es":"portugu\u00e9s"}", native_name: "Português", family: "Indo-European", wiki_url: "https://en.wikipedia.org/wiki/Portuguese_language", } ``` ### Currency model [](#currency-model) ``` Currency::find('COP'); Io238\ISOCountries\Models\Currency { id: "COP", name: "{"en":"Colombian Peso","de":"Kolumbianischer Peso","fr":"peso colombien","es":"peso colombiano"}", name_plural: "Colombian pesos", symbol: "CO$", symbol_native: "$", decimal_digits: 0, rounding: 0, } ``` ### Query relationships [](#query-relationships) All models have pre-defined many-to-many relationships that can be queried: ``` // Retrieve languages that are spoken in Luxembourg Country::find('LU')->languages; Illuminate\Database\Eloquent\Collection { all: [ Io238\ISOCountries\Models\Language { id: "de", iso639_2: "deu", iso639_2b: "ger", name: "{"en":"German","de":"Deutsch","fr":"allemand","es":"alem\u00e1n"}", native_name: "Deutsch", family: "Indo-European", wiki_url: "https://en.wikipedia.org/wiki/German_language", }, Io238\ISOCountries\Models\Language { id: "fr", iso639_2: "fra", iso639_2b: "fre", name: "{"en":"French","de":"Franz\u00f6sisch","fr":"fran\u00e7ais","es":"franc\u00e9s"}", native_name: "français, langue française", family: "Indo-European", wiki_url: "https://en.wikipedia.org/wiki/French_language", }, Io238\ISOCountries\Models\Language { id: "lb", iso639_2: "ltz", iso639_2b: null, name: "{"en":"Luxembourgish","de":"Luxemburgisch","fr":"luxembourgeois","es":"luxemburgu\u00e9s"}", native_name: "Lëtzebuergesch", family: "Indo-European", wiki_url: "https://en.wikipedia.org/wiki/Luxembourgish_language", }, ], } ``` ``` // Retrieve all countries that use the Euro (EUR) as currency. Currency::find('EUR')->countries->pluck('name'); Illuminate\Support\Collection { all: [ "Andorra", "Austria", "Åland Islands", "Belgium", "St. Barthélemy", "Cyprus", "Germany", "Estonia", "Spain", "Finland", "France", "French Guiana", "Guadeloupe", "Greece", "Ireland", "Italy", "Lithuania", "Luxembourg", "Latvia", "Monaco", "Montenegro", "St. Martin", "Martinique", "Malta", "Netherlands", "St. Pierre & Miquelon", "Portugal", "Réunion", "Slovenia", "Slovakia", "San Marino", "French Southern Territories", "Vatican City", "Republic of Kosovo", "Mayotte", "Zimbabwe", ], } ``` ### Localized names [](#localized-names) Each of the package models (Country, Language, Currency) has a `->name` attribute, which will be displayed in the app's locale, using the [spatie/laravel-translatable](https://github.com/spatie/laravel-translatable) package. The default config will migrate localized names for `en`, `de`, `fr`, and `es`. This can be adjusted in the [config](#config). The config `app.locale` and `app.fallback_locale` are automatically included. ``` // Set the app locale app()->setLocale('fr'); // Retrieve the top 10 countries in Africa (by population): Io238\ISOCountries\Models\Country::where('region', 'Africa')->orderByDesc('population')->limit(10)->pluck('name'); // Country names will be returned according to the app locale (fr = French) Illuminate\Support\Collection { all: [ "Nigéria", "Éthiopie", "Égypte", "Congo-Kinshasa", "Afrique du Sud", "Tanzanie", "Kenya", "Algérie", "Soudan", "Ouganda", ], } ``` ### Attribute casting [](#attribute-casting) If you already use ISO codes in your models, you can enrich them by casting them as Country/Language/Currency model: ``` use Io238\ISOCountries\Casts\Currency; class MyModel{ // ... protected $casts = [ 'currency' => Currency::class, ]; // ... } // Now you can dynamically retrieve all meta data associated with the currency MyModel::first()->currency; Io238\ISOCountries\Models\Currency { id: "JPY", name: "{"en":"Japanese Yen","de":"Japanischer Yen","fr":"yen japonais","es":"yen"}", name_plural: "Japanese yen", symbol: "¥", symbol_native: "￥", decimal_digits: 0, rounding: 0, } // When filling the model, the ISO code (string) or the model can be used MyModel::first()->update(['currency' => 'USD']); MyModel::first()->update(['currency' => Io238\ISOCountries\Models\Currency::find('USD')]); ``` Testing ------- [](#testing) ``` composer test ``` Contributing ------------ [](#contributing) Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](../../security/policy) on how to report security vulnerabilities. Credits ------- [](#credits) - [io238](https://github.com/io238) - [azakhozhiy](https://github.com/azakhozhiy) - - - - - - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 30 — LowBetter than 64% of packages Maintenance58 Moderate activity, may be stable Popularity1 Limited adoption so far Community8 Small or concentrated contributor base Maturity48 Maturing project, gaining track record Bus Factor1 Top contributor holds 86.6% of commits — single point of failure 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 Unknown Total 1 Last Release 266d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/cff59bdd48d2c5d6445c4750cae43fb30c0b8e2832acf02938e255a471f946ab?d=identicon)[azakhozhy](/maintainers/azakhozhy) --- Top Contributors [![io238](https://avatars.githubusercontent.com/u/26689138?v=4)](https://github.com/io238 "io238 (97 commits)")[![azakhozhiy](https://avatars.githubusercontent.com/u/14373063?v=4)](https://github.com/azakhozhiy "azakhozhiy (15 commits)") --- Tags phplaravellanguageseloquentcountriesisoworldcurrenciescastcodescountry codesIso3166iso4217iso639-1custom-casts ### Code Quality TestsPest ### Embed Badge ![Health badge](/badges/azakhozhiy-laravel-iso-countries/health.svg) ``` [![Health](https://phpackages.com/badges/azakhozhiy-laravel-iso-countries/health.svg)](https://phpackages.com/packages/azakhozhiy-laravel-iso-countries) ``` ### Alternatives [io238/laravel-iso-countries Ready-to-use Laravel models and relations for country (ISO 3166), language (ISO 639-1), and currency (ISO 4217) information with multi-language support. 5462.3k](/packages/io238-laravel-iso-countries)[watson/validating Eloquent model validating trait. 9723.3M47](/packages/watson-validating)[dyrynda/laravel-model-uuid This package allows you to easily work with UUIDs in your Laravel models. 4802.8M8](/packages/dyrynda-laravel-model-uuid)[spiritix/lada-cache A Redis based, automated and scalable database caching layer for Laravel 591444.8k2](/packages/spiritix-lada-cache)[reedware/laravel-relation-joins Adds the ability to join on a relationship by name. 2121.2M13](/packages/reedware-laravel-relation-joins)[sebastiaanluca/laravel-boolean-dates Automatically convert Eloquent model boolean attributes to dates (and back). 40111.7k1](/packages/sebastiaanluca-laravel-boolean-dates) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)