codelibrary/world

List of countries and their associated data.

v0.2.1 2025-02-06 14:25 UTC

Requires

• php: ^8.2

Requires (Dev)

• codelibrary/countries: ^5.1@alpha
• phpunit/phpunit: ^11.1
• squizlabs/php_codesniffer: ^3.10
• symfony/var-dumper: ^7.1

MIT

• Nikola Zeravcic

README

PHP package as service for endpoint resource of countries and their associated data.

Installation

Add this package directly with composer:

composer require codelibrary/world
# or
composer require codelibrary/world -n # --no-interaction (Docker SSH reasons)

Build and run for dev environment

The docker build command will copy the local content to the container. So use docker run -v (or --volume) option to bind with local content:

cd /path/to/project/
docker build -t [IMAGE_NAME] .
docker run -d -v .:/var/www/html --name [NEW_CONTAINER_NAME] [IMAGE_NAME]
docker exec -it [NEW_CONTAINER_NAME] /bin/bash

Usage

use CodeLibrary\World\CountryFinder;

// optional params
$extraCountryData = [
    [
        'name' => ['official' => 'Hellenic Republic'], // already existing key
        'altSpellings' => ['hellenicccccccc'], // new custom values
    ],
    [
        'name' => ['official' => 'Kingdom of Spain'],
        'altSpellings' => ['The Kingdom of Spain'],
    ],
];

$finder = new CountryFinder($extraCountryData);

$finder->name('invalid country name here'); // throw 'InvalidCountryNameException'

$country1 = $finder->name('Hellenicccccccc');
$country2 = $finder->name('the kingdom of spain');

$country2->hasName('spain'); // (bool) true
$country2->hasName('spain, the kindom of'); // (bool) false
echo $country2->name('fra'); // Royaume d'Espagne
echo $country2->nameCommon('fra'); // Espagne

Contributing

Please see CONTRIBUTING and CODE OF CONDUCT for details.

Change log

Please see CHANGELOG for more information what has changed recently.

Security

If you discover any security related issues, please email to [e-mail] instead of using the issue tracker.

Credits

• Nikola Zeravcic

License

The MIT License (MIT). Please see License File for more information.