Multilingual Country Lists for Laravel 5
For PHP < 5.5.9
, (*1)
Is the same code I fork from petercoles but changed to use it with PHP < 5.5.9, (*2)
Introduction
I've lost count of the number of time that I've carefully edited a list of 250 of so countries to create the data needed for a select field on a form - and that's just for one language. This thin Laravel wrapper around an industry-maintained list of country names in many, many languages, consigns that tedious task and ongoing maintenance of those lists to the trash bin of history., (*3)
The package provides easy access, through a simple API, to country names in an enormously large number of language and locale settings, together with their ISO-3166 alpha-2 two-letter country codes., (*4)
Data can be returned as a lookup array or an array of key-value pairs, where both the key and value labels can be set according to the needs of the software consuming them., (*5)
Installation
At the command line run, (*6)
composer require ericlagarda/multilingual-country-list-php5-5
then add the service provider to the providers entry in your config/app.php file, (*7)
'providers' => [
// ...
PeterColes\Countries\CountriesServiceProvider::class,
// ...
],
An optional facade is also available and can be enabled by adding the following to you config/app.php's aliases array, (*8)
'Countries' => PeterColes\Countries\CountriesFacade::class,
Usage
Once installed the package exposes two API methods: lookup() and keyValue(), each of which returns a list of countries ordered by the country name in the language being used., (*9)
Lookup
The lookup method takes two optional parameters: $locale (default 'en') and $flip (default false) and returns a collection. This collection will be cast to a json object by Laravel if returned as a response, or can be cast to an array if needed with the toArray() method., (*10)
Locales can be expressed as a language code, e.g. 'fr', or a full locale code, e.g. zh_CN., (*11)
Examples
The default is English., (*12)
Countries::lookup();
// returns
{
"AF": "Afghanistan",
...
"ZW": "Zimbabwe"
}
The flip parameter facilitates reverse lookups, e.g. for typahead components that recognize values, but don't support keys, requiring the key to obtained later., (*13)
Countries::lookup('es', true);
// returns
{
"Afganistán": "AF",
...
"Zimbabue": "ZW"
}
Non-latin character sets are supported too, including locale settings, (*14)
Countries::lookup('zh_CN');
// returns
{
"AL": "阿尔巴尼亚",
...
"HK": "中国香港特别行政区"
}
keyValue
The keyValue method takes three optional parameters: $locale (default 'en'), $key (default 'key') and $value (default 'value')., (*15)
Examples
The default is still English., (*16)
Countries::keyValue();
// returns
[
{"key": "AF", "value": "Afghanistan"},
...
{"key": "ZW", "value": "Zimbabwe"}
]
If you need a key-value list with custom indices, then the $key and $value parameters can be used to redfine them. this might be the case, for example, if you're using a javascript component to generate a select field and that component has expectations as to the indices used in the data that it receoves., (*17)
Countries::keyValue('zh', 'label', 'text');
// returns
[
{"label": "AL", "text": "阿尔巴尼亚"},
...
{"label": "HK", "text": "中国香港特别行政区"}
]
Issues
This package was developed to meet a specific need and then generalised for wider use. If you have a use case not currently met, or see something that appears to not be working correctly, please raise an issue at the github repo, (*18)
License
This package is licensed under the MIT license., (*19)
Wallogit.com
