writecrow/country_code_converter

Convert country name to codes or vice-versa.

1.2.0 2023-08-23 22:44 UTC

Requires (Dev)

• phpunit/phpunit: ~4

Suggests

• ext-mbstring: For best performance
• symfony/polyfill-mbstring: If you can't install ext-mbstring

MIT

• Mark Fullmer

README

A PHP library for converting ISO country codes to names and vice-versa.

Country data was last updated on August 10, 2017, from https://en.wikipedia.org/wiki/ISO_3166-1#Officially_assigned_code_elements

The library recognizes ISO 2-digit, 3-digit, and numeric codes.

Usage in an application

The included /demo/index.php file contains a generation form demo.

Make your code aware of the CountryCodeConverter class via your favorite method (e.g., use or require)

Then pass a country code or country name into the class:

echo CountryCodeConverter::convert('AL');
// Will print 'Albania'

echo CountryCodeConverter::convert('ALB');
// Will print 'Albania'

echo CountryCodeConverter::convert('008');
// Will print 'Albania'

echo CountryCodeConverter::convert('Albania');
// Will print 'AL'

Explicitly requesting return format.

If you want a specific format returned, pass the desired format as a second parameter:

echo CountryCodeConverter::convert('Albania', 'name');
// Will print 'Albania'

echo CountryCodeConverter::convert('Albania', 'two-digit');
// Will print 'AL'

echo CountryCodeConverter::convert('Albania', 'three-digit');
// Will print 'ALB'

echo CountryCodeConverter::convert('Albania', 'numeric');
// Will print '008'