larapkg/iso-countries

A map of ISO countries and their codes

1.1.0 2022-02-12 19:11 UTC

Requires

• php: ^8.0
• illuminate/support: ^v8.0.0|^v9.0.0

Requires (Dev)

• phpunit/phpunit: ^9.5
• roave/security-advisories: dev-master
• symfony/var-dumper: ^5.3

MIT

README

IsoCountries

A simple PHP mapper for ISO country data.

Country data is available within the data folder: in CSV, JSON and ODS format for convenience.

Usage

// Create an instance directly:
$countries = new \LaraPKG\IsoCountries\Countries();

// Could also be bound to a container:
//$this->app->singleton(Countries::class);
//$this->app->alias(Countries::class, 'countries');

The country records are keyed by their two letter ISO-3116-1 Alpha-2 code.

$gb = $countries->get('GB');
$us = $countries->get('US');
$fr = $countries->get('FR');

The countries class forwards calls to the collection instance so any Laravel Collection methods can be used to retrieve a country record.

$countries
    ->filter(static fn (Country $country) => $country->alpha3() === 'AUS')
    ->first();

Countries can be retrieved as an array for processing elsewhere in your application:

$countries->toArray();