php countries est une bibliothèque qui fournit une syntaxe élégante aux données nationales.
Vous pouvez installer php countries via Composer, comme suit.
composer require divineomega/php-countries
Pour utiliser php countries , vous devez créer un nouvel objet Countries
.
use DivineOmega Countries Countries ;
$ countries = new Countries ;
Vous pouvez ensuite appeler différentes méthodes sur cet objet, pour obtenir les données du pays.
Vous pouvez facilement récupérer un tableau de tous les pays et les parcourir, comme suit.
foreach ( $ countries -> all () as $ country ) {
var_dump ( $ country -> name . ' - ' . $ country -> officialName );
}
Les détails du pays peuvent être récupérés à partir du nom officiel ou commun du pays.
var_dump ( $ countries -> getByName ( ' United Kingdom ' ));
/*
object(DivineOmegaCountriesCountry)#146 (17) {
["name"]=>
string(14) "United Kingdom"
["officialName"]=>
string(52) "United Kingdom of Great Britain and Northern Ireland"
["topLevelDomains"]=>
array(1) {
[0]=>
string(3) ".uk"
}
["isoCodeAlpha2"]=>
string(2) "GB"
["isoCodeAlpha3"]=>
string(3) "GBR"
["isoCodeNumeric"]=>
string(3) "826"
["languages"]=>
array(1) {
[0]=>
string(7) "English"
}
["languageCodes"]=>
array(1) {
[0]=>
string(3) "eng"
}
["currencyCodes"]=>
array(1) {
[0]=>
string(3) "GBP"
}
["callingCodes"]=>
array(1) {
[0]=>
string(2) "44"
}
["capital"]=>
string(6) "London"
["capitals"]=>
array(1) {
[0]=>
string(6) "London"
}
["region"]=>
string(6) "Europe"
["subregion"]=>
string(15) "Northern Europe"
["latitude"]=>
int(54)
["longitude"]=>
int(-2)
["areaInKilometres"]=>
int(242900)
["nationality"]=>
string(7) "British"
}
*/
Vous pouvez obtenir les données d'un pays par son code ISO 3166-1. Les variantes à 2 caractères, 3 caractères et numériques sont toutes acceptées.
var_dump ( $ countries -> getByIsoCode ( ' USA ' ));
/*
object(DivineOmegaCountriesCountry)#4693 (16) {
["name"]=>
string(13) "United States"
["officialName"]=>
string(24) "United States of America"
// etc...
}
*/
En fournissant une langue, vous obtiendrez un tableau de tous les pays dans lesquels cette langue est parlée. Vous pouvez fournir un nom ou un code de langue.
var_dump ( $ countries -> getByLanguage ( ' German ' ));
/*
array(5) {
[0]=>
object(DivineOmegaCountriesCountry)#4913 (16) {
["name"]=>
string(7) "Belgium"
["officialName"]=>
// etc...
}
[1]=>
object(DivineOmegaCountriesCountry)#4883 (16) {
["name"]=>
string(7) "Germany"
["officialName"]=>
string(27) "Federal Republic of Germany"
// etc...
}
[2]=>
object(DivineOmegaCountriesCountry)#4826 (16) {
["name"]=>
string(13) "Liechtenstein"
["officialName"]=>
string(29) "Principality of Liechtenstein"
// etc...
}
[3]=>
object(DivineOmegaCountriesCountry)#4808 (16) {
["name"]=>
string(10) "Luxembourg"
["officialName"]=>
string(25) "Grand Duchy of Luxembourg"
// etc...
}
[4]=>
object(DivineOmegaCountriesCountry)#4871 (16) {
["name"]=>
string(7) "Namibia"
["officialName"]=>
string(19) "Republic of Namibia"
// etc...
}
}
*/