mibo/countries

PHP Library for ISO 3166-1 country codes

1.0.0 2023-12-14 14:43 UTC

Requires

• php: ^8.2
• league/iso3166: ^4.3
• mibo/currencies: ^1.1

Requires (Dev)

• jetbrains/phpstorm-attributes: ^1.0
• php-parallel-lint/php-parallel-lint: ^1.3
• phpstan/extension-installer: ^1.3
• phpstan/phpstan: ^1.5
• phpstan/phpstan-strict-rules: ^1.5
• phpunit/php-invoker: ^4.0
• phpunit/phpunit: ^10.1
• slevomat/coding-standard: ^8.13

MIT

• Michal Boris

• php
• countries
• ISO 3166
• country
• standard
• codes
• iso
• 3166
• 3166-1
• country codes

README

mibo/countries

The library provides a simple interface for a country entity and country provider, which retrieves a country by its ISO 3166-1 alpha-2 code, alpha-3 code, or numeric code. The provider is able to retrieve a country by its name, too.
If the provider does not find the country, it returns a null.

The Country entity contains its name, ISO 3166-1 alpha-2 code, alpha-3 code, numeric code, and the country's currencies (objects).

The list of the available countries can be changed by the provider, because the library (ISO) provider uses a provider from 'league/iso3166' library, which provides the same data but as array instead.

$provider = new \MiBo\Countries\ISO\CountryProvider(
    new \League\ISO3166\ISO3166($myCountryList ?? []),
    new \MiBo\Currencies\ISO\ISOCurrencyProvider(
        new \MiBo\Currencies\ISO\ISOArrayListLoader(),
        new \Psr\Log\NullLogger()
    )
)

$country = $provider->getByAlpha2('SK');

echo $country->getName(); // Slovakia
echo $country->getAlpha2(); // SK
echo $country->getAlpha3(); // SVK
echo $country->getNumericalCode(); // 703
echo $country->getCurrencies()[0]->getAlphabeticalCode(); // EUR