README

CountryCodes PHP 类用于获取包含 ISO 3166-1 alpha-2、ISO 3166-1 alpha-3、ISO 3166-1 数字和 ISD 码的国家数组，可以提供与国家相关的以下信息

1. alpha2 ISO-3166-1 alpha-2 https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
2. alpha3 ISO-3166-1 alpha-3 https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3
3. numeric ISO-3166-1 数字 https://en.wikipedia.org/wiki/ISO_3166-1_numeric
4. isd 国际电话区号 https://en.wikipedia.org/wiki/List_of_country_calling_codes
5. continentCode 大洲代码
6. continent 大洲名称
7. country 国家名称
8. countryFull 国家全称
9. emoji 表情符号国旗 http://unicode.org/emoji/charts/emoji-ordering.html#country-flag

安装

通过 Composer 安装

composer require thalidzhokov/country-codes

或者将 CountryCodes.php 包含在你的 PHP 代码中

require_once('CountryCodes.php');

使用方法

更改默认语言

\CountryCodes::$language = 'ru';

方法 get()

获取 key => value 的数组

\CountryCodes::get('alpha2', 'country');

返回

array (
  'AB' => 'Abkhazia',
  'AD' => 'Andorra',
  ...,
  'AI' => 'Anguilla',
  'AL' => 'Albania',
  'AM' => 'Armenia',
  ...,
  'US' => 'USA',
  ...
)

方法 get2()

获取包含多个值的数组 key => [value1, value2, ...]

\CountryCodes::get2('alpha3', ['alpha2', 'continentCode', 'emoji']);

返回

array (
  'ABH' => 
  array (
    'alpha2' => 'AB',
    'continentCode' => 'AS',
    'emoji' => '',
  ),
  'AND' => 
  array (
    'alpha2' => 'AD',
    'continentCode' => 'EU',
    'emoji' => '🇦🇩',
  ),
  'ARE' => 
  array (
    'alpha2' => 'AE',
    'continentCode' => 'AS',
    'emoji' => '🇦🇪',
  ),
  ...
)

方法 getByContinent()

通过大洲获取 key => value 的数组

\CountryCodes::getByContinent('alpha3', 'countryFull', 'EU');

返回

array (
  ...,
  'BEL' => 'Belgium',
  'BGR' => 'Bulgaria',
  'BLR' => 'Belarus',
  'CHE' => 'Swiss Confederation',
  'CZE' => 'Czech Republic',
  'DEU' => 'Germany',
  ...
)

方法 getEmojiByAlpha2()

通过 alpha2 获取表情符号国旗代码

\CountryCodes::getEmojiByAlpha2('ZW');

返回

🇿🇼

方法 getEmojiByAlpha3()

通过 alpha3 获取表情符号国旗代码

\CountryCodes::getEmojiByAlpha3('ZMB');

返回

🇿🇲