README.md

Country list

A wrapper around https://github.com/umpirsky/country-list to easily fetch a list of countries in a certain language or get a specific country by country code and language.

Installing

composer.json

{
    "require": {
        "woutersioen/country-list": "dev-master"
    }
}

index file for your project

// update this to the path to the "vendor/" directory, relative to this file
require_once '../vendor/autoload.php';

Usage

With dependency injection container:

First add an instance of the class Sioen\CountryList to your dependency injection container.

// fetch an array of countries in a language
$languages = $this->getContainer()->get('countries')->getForLanguage('en');

// fetch one country in a language
$language = $this->getContainer()->get('countries')->getSpecificForLanguage('be', 'en');
// returns 'Belgium'

Most modern PHP Frameworks have a dependency injection container. This is the prefered way, since there will only be one instance of the countries object, and data will be cached in this object.

PHP 5.4 (+)

use Sioen\ContryList;

// fetch an array of countries in a language
$languages = (new CountryList)->getForLanguage('en');

// fetch one country in a language
$language = (new CountryList)->getSpecificForLanguage('be', 'en');
// returns 'Belgium'

PHP 5.3

use Sioen\ContryList;

$countryList = new CountryList();

// fetch an array of countries in a language
$languages = $countryList->getForLanguage('en');

// fetch one country in a language
$language = $countryList->getSpecificForLanguage('be', 'en');
// returns 'Belgium'