NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #2030 most downloaded on Packagist
ISO country, subdivision, language, currency and script definitions and their translations. Based on pythons pycountry and Debian's iso-codes.
Latest stable
4.4.0
Last release 1 years ago
16 Sep 2025
Ships unpredictably
gaps range from 2 weeks to 1.5 years
Most releases are documented
notes for 52 of 59 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
59 releases · first in 2014
Drag across the ruler to compare, or tap a release to open it.
Define external Synfony Translator
Removed support of PHP less than PHP 7.4
Support of PHP 8.4 (See PR #80)
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Common name of country \Sokil\IsoCodes\Database\Countries\Country::getCommonName
\Sokil\IsoCodes\Database\Countries\Country::getCommonName\Sokil\IsoCodes\Database\Countries\Country::getFlagAuth release fix. Swallow clone does not clone tags required to set version in README
Fix: database entries may has no mo files. In this case exception occured. Locale "en" as default locale has no mo files because all data already pres
Fix: database entries may has no mo files. In this case exception occured. Locale "en" as default locale has no mo files because all data already present in database. When no mo file found, default "en" value returns.

As you already know, russia invaded Ukraine on 24 of February 2022, at 5.00 AM the armed forces of the Russian Federation attacked Ukraine. Please, Stand with Ukraine, stay tuned for updates on Ukraine’s official sources and channels in English and support Ukraine in its fight for freedom and democracy in Europe.
https://ukraine.ua/news/stand-with-ukraine/
Ways to support Ukraine
Fix #53 - Compatibility with php 8.1
Fixes in update_iso_codes_db.sh
Fixes in update_iso_codes_db.sh
Database and messages extracted to separate projects sokil/php-isocodes-db-i18n and sokil/php-isocodes-db-only. Current library may be used directly o
./bin/update_iso_codes_db.sh signature changed to {mode} {base_dir} [{build_dir}].
See installation notes for more info.Database version: v4.8.0-26-gf4b9c87c from 2021-12-02 04:27
Database version: v4.8.0-26-gf4b9c87c from 2021-12-02 04:27
Database version: v4.8.0-1-gdd836c89 from 2021-11-06 08:41
Database version: v4.8.0-1-gdd836c89 from 2021-11-06 08:41
Database version: iso-codes-4.7.0-47-g5fb1ffdd from 2021-10-02 04:26
Database version: iso-codes-4.7.0-47-g5fb1ffdd from 2021-10-02 04:26
database update to iso-codes-4.7.0-45-g1a23444a from 2021-09-15 08:38
database update to iso-codes-4.7.0-45-g1a23444a from 2021-09-15 08:38
Database version: iso-codes-4.6.0-35-g3f006e4f from 2021-08-02 04:26
Database version: iso-codes-4.6.0-35-g3f006e4f from 2021-08-02 04:26
Database version: iso-codes-4.6.0-32-gb3bbcb5d from 2021-07-02 04:14
Database version: iso-codes-4.6.0-32-gb3bbcb5d from 2021-07-02 04:14
Database update to iso-codes-4.6.0-29-g5acbceb6 from 2021-06-02 06:13
Database update to iso-codes-4.6.0-29-g5acbceb6 from 2021-06-02 06:13
Database version: iso-codes-4.6.0-12-g26bd8f07 from 2021-05-02 04:07
Database version: iso-codes-4.6.0-12-g26bd8f07 from 2021-05-02 04:07
Database version iso-codes-4.6.0-5-g0ccdc2d2 from 2021-04-02 05:14
Database version iso-codes-4.6.0-5-g0ccdc2d2 from 2021-04-02 05:14
Database version: iso-codes-4.6.0-1-gd490b2a4 from 2021-03-17 16:34
Database version: iso-codes-4.6.0-1-gd490b2a4 from 2021-03-17 16:34
Database version: iso-codes-4.5.0-210-gf88891a3 from 2021-03-02 04:25
Database version: iso-codes-4.5.0-210-gf88891a3 from 2021-03-02 04:25
Database version: iso-codes-4.5.0-205-g927a9f3a from 2021-02-17 08:50
Database version: iso-codes-4.5.0-205-g927a9f3a from 2021-02-17 08:50
Database version: iso-codes-4.5.0-199-g4070a2e5 from 2021-02-02 04:31
Database version: iso-codes-4.5.0-199-g4070a2e5 from 2021-02-02 04:31
Database version: iso-codes-4.5.0-186-ga7b8a017 from 2021-01-19 15:33
Database version: iso-codes-4.5.0-186-ga7b8a017 from 2021-01-19 15:33
Database version: iso-codes-4.5.0-178-g802915de from 2021-01-02 04:38
Database version: iso-codes-4.5.0-178-g802915de from 2021-01-02 04:38
Fix configure external directory to database files
SomeDatabase::getByNumericCode now accept strings instead of ints, SomeEntity::getNumericCode now return stringsAllow to configure own translation driver
Allow to configure own translation driver
Database updated to version iso-codes-4.5.0-165-g46cea063 from 2020-12-12 19:09
Bug #25 fixed, \Sokil\IsoCodes\Database\Countries::getByNumericCode now accept strings instead of ints
Bug #25 fixed, \Sokil\IsoCodes\Database\Countries::getByNumericCode now accept strings instead of ints
Database version: iso-codes-4.5.0-99-g3feba234 from 2020-09-22 23:33
Database version: iso-codes-4.5.0-99-g3feba234 from 2020-09-22 23:33
Database version: iso-codes-4.2-515-g7c579bb0 from 2020-05-29 01:27
Database version: iso-codes-4.2-515-g7c579bb0 from 2020-05-29 01:27
Database version: iso-codes-4.2-299-gc0e8506 from 2019-11-28 08:56
Database version: iso-codes-4.2-299-gc0e8506 from 2019-11-28 08:56
Update database to version 4.2-277-g3d1d2f11 from 2019-10-23 22:24
Update database to version 4.2-277-g3d1d2f11 from 2019-10-23 22:24
Database version: iso-codes-4.2-202-gfefebff3 from 2019-08-28 23:03
Database version: iso-codes-4.2-202-gfefebff3 from 2019-08-28 23:03
Remove stub class \Sokil\IsoCodes, use \Sokil\IsoCodes\IsoCodesFactory instead
Cluster index is now lazy loaded. If you use iterator methods directly to iterate through all database, you must call rewind first.
rewind first.Database version: iso-codes-4.2-299-gc0e8506 from 2019-11-28 09:14
Database version: iso-codes-4.2-299-gc0e8506 from 2019-11-28 09:14
Database version: iso-codes-4.2-202-gfefebff3 from 2019-08-28 23:05
Database version: iso-codes-4.2-202-gfefebff3 from 2019-08-28 23:05
Database version: iso-codes-4.2-147-gcadebc34
Database version: iso-codes-4.2-147-gcadebc34
Update database to iso-codes-4.2-128-g7fcf7d92 from 2019-06-01 16:43
Update database to iso-codes-4.2-128-g7fcf7d92 from 2019-06-01 16:43
Nothing published for this version
Update script splitted into production update script and library release script.
Database version: iso-codes-4.2 from 2019-04-02 08:53
Database version: iso-codes-4.2 from 2019-04-02 08:53
Nothing published for this version
Fix update script when running initially
Nothing published for this version
Added possibility to configure directory with databases and messages, and manually update them without updating composer
AbstractDatabase::DATABASE_PATH and AbstractDatabase::MESSAGES_PATH now contain directory name instead of directory pathNothing published for this version
Database version: iso-codes-3.79-207-g752179ce from 2018-10-13 18:47
Database version: iso-codes-3.79-207-g752179ce from 2018-10-13 18:47
Database version: iso-codes-3.77-647-g7970097 from 2018-09-04 08:36
Database version: iso-codes-3.77-647-g7970097 from 2018-09-04 08:36
Update database to iso-codes-3.77-628-g360ef4e
Update database to iso-codes-3.77-628-g360ef4e
Update database to iso-codes-3.77-562-gd6cb176
Update database to iso-codes-3.77-562-gd6cb176
Update database to iso-codes-3.77-332-g813a2e9a
Update database to iso-codes-3.77-332-g813a2e9a
Update db to iso-codes-3.76-31-g58b6628
Update db to iso-codes-3.76-31-g58b6628
Nothing published for this version
Replace class \Sokil\IsoCodes with \Sokil\IsoCodes\IsoCodesFactory. First is deprecated now.
\Sokil\IsoCodes with \Sokil\IsoCodes\IsoCodesFactory. First is deprecated now.\Sokil\IsoCodes\* to \Sokil\IsoCodes\DatabaseNothing published for this version
Nothing published for this version
AbstractDatabase::find() now returns null when $fieldValue not found in index instead of throwing exception
AbstractDatabase::find() now returns null when $fieldValue not found in index instead of throwing exceptionOne column per quarter.