378 lines
15 KiB
PHP
378 lines
15 KiB
PHP
<?php
|
|
|
|
/*
|
|
* This file is part of Respect/Validation.
|
|
*
|
|
* (c) Alexandre Gomes Gaigalas <alexandre@gaigalas.net>
|
|
*
|
|
* For the full copyright and license information, please view the LICENSE file
|
|
* that was distributed with this source code.
|
|
*/
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace Respect\Validation\Rules;
|
|
|
|
use Respect\Validation\Exceptions\ComponentException;
|
|
|
|
use function array_column;
|
|
use function array_keys;
|
|
use function implode;
|
|
use function sprintf;
|
|
|
|
/**
|
|
* Validates whether the input is a country code in ISO 3166-1 standard.
|
|
*
|
|
* This rule supports the three sets of country codes (alpha-2, alpha-3, and numeric).
|
|
*
|
|
* @author Alexandre Gomes Gaigalas <alexandre@gaigalas.net>
|
|
* @author Felipe Martins <me@fefas.net>
|
|
* @author Henrique Moody <henriquemoody@gmail.com>
|
|
* @author William Espindola <oi@williamespindola.com.br>
|
|
*/
|
|
final class CountryCode extends AbstractSearcher
|
|
{
|
|
/**
|
|
* The ISO representation of a country code.
|
|
*/
|
|
public const ALPHA2 = 'alpha-2';
|
|
|
|
/**
|
|
* The ISO3 representation of a country code.
|
|
*/
|
|
public const ALPHA3 = 'alpha-3';
|
|
|
|
/**
|
|
* The ISO-number representation of a country code.
|
|
*/
|
|
public const NUMERIC = 'numeric';
|
|
|
|
/**
|
|
* Position of the indexes of each set in the list of country codes.
|
|
*/
|
|
private const SET_INDEXES = [
|
|
self::ALPHA2 => 0,
|
|
self::ALPHA3 => 1,
|
|
self::NUMERIC => 2,
|
|
];
|
|
|
|
/**
|
|
* @see https://salsa.debian.org/iso-codes-team/iso-codes
|
|
*/
|
|
private const COUNTRY_CODES = [
|
|
['AD', 'AND', '020'], // Andorra
|
|
['AE', 'ARE', '784'], // United Arab Emirates
|
|
['AF', 'AFG', '004'], // Afghanistan
|
|
['AG', 'ATG', '028'], // Antigua and Barbuda
|
|
['AI', 'AFI', '262'], // French Afars and Issas
|
|
['AI', 'AIA', '660'], // Anguilla
|
|
['AL', 'ALB', '008'], // Albania
|
|
['AM', 'ARM', '051'], // Armenia
|
|
['AN', 'ANT', '530'], // Netherlands Antilles
|
|
['AO', 'AGO', '024'], // Angola
|
|
['AQ', 'ATA', '010'], // Antarctica
|
|
['AR', 'ARG', '032'], // Argentina
|
|
['AS', 'ASM', '016'], // American Samoa
|
|
['AT', 'AUT', '040'], // Austria
|
|
['AU', 'AUS', '036'], // Australia
|
|
['AW', 'ABW', '533'], // Aruba
|
|
['AX', 'ALA', '248'], // Åland Islands
|
|
['AZ', 'AZE', '031'], // Azerbaijan
|
|
['BA', 'BIH', '070'], // Bosnia and Herzegovina
|
|
['BB', 'BRB', '052'], // Barbados
|
|
['BD', 'BGD', '050'], // Bangladesh
|
|
['BE', 'BEL', '056'], // Belgium
|
|
['BF', 'BFA', '854'], // Burkina Faso
|
|
['BG', 'BGR', '100'], // Bulgaria
|
|
['BH', 'BHR', '048'], // Bahrain
|
|
['BI', 'BDI', '108'], // Burundi
|
|
['BJ', 'BEN', '204'], // Benin
|
|
['BL', 'BLM', '652'], // Saint Barthélemy
|
|
['BM', 'BMU', '060'], // Bermuda
|
|
['BN', 'BRN', '096'], // Brunei Darussalam
|
|
['BO', 'BOL', '068'], // Bolivia, Plurinational State of
|
|
['BQ', 'ATB', null], // British Antarctic Territory
|
|
['BQ', 'BES', '535'], // Bonaire, Sint Eustatius and Saba
|
|
['BR', 'BRA', '076'], // Brazil
|
|
['BS', 'BHS', '044'], // Bahamas
|
|
['BT', 'BTN', '064'], // Bhutan
|
|
['BU', 'BUR', '104'], // Burma, Socialist Republic of the Union of
|
|
['BV', 'BVT', '074'], // Bouvet Island
|
|
['BW', 'BWA', '072'], // Botswana
|
|
['BY', 'BLR', '112'], // Belarus
|
|
['BY', 'BYS', '112'], // Byelorussian SSR Soviet Socialist Republic
|
|
['BZ', 'BLZ', '084'], // Belize
|
|
['CA', 'CAN', '124'], // Canada
|
|
['CC', 'CCK', '166'], // Cocos (Keeling) Islands
|
|
['CD', 'COD', '180'], // Congo, The Democratic Republic of the
|
|
['CF', 'CAF', '140'], // Central African Republic
|
|
['CG', 'COG', '178'], // Congo
|
|
['CH', 'CHE', '756'], // Switzerland
|
|
['CI', 'CIV', '384'], // Côte d'Ivoire
|
|
['CK', 'COK', '184'], // Cook Islands
|
|
['CL', 'CHL', '152'], // Chile
|
|
['CM', 'CMR', '120'], // Cameroon
|
|
['CN', 'CHN', '156'], // China
|
|
['CO', 'COL', '170'], // Colombia
|
|
['CR', 'CRI', '188'], // Costa Rica
|
|
['CS', 'CSK', '200'], // Czechoslovakia, Czechoslovak Socialist Republic
|
|
['CS', 'SCG', '891'], // Serbia and Montenegro
|
|
['CT', 'CTE', '128'], // Canton and Enderbury Islands
|
|
['CU', 'CUB', '192'], // Cuba
|
|
['CV', 'CPV', '132'], // Cabo Verde
|
|
['CW', 'CUW', '531'], // Curaçao
|
|
['CX', 'CXR', '162'], // Christmas Island
|
|
['CY', 'CYP', '196'], // Cyprus
|
|
['CZ', 'CZE', '203'], // Czechia
|
|
['DD', 'DDR', '278'], // German Democratic Republic
|
|
['DE', 'DEU', '276'], // Germany
|
|
['DJ', 'DJI', '262'], // Djibouti
|
|
['DK', 'DNK', '208'], // Denmark
|
|
['DM', 'DMA', '212'], // Dominica
|
|
['DO', 'DOM', '214'], // Dominican Republic
|
|
['DY', 'DHY', '204'], // Dahomey
|
|
['DZ', 'DZA', '012'], // Algeria
|
|
['EC', 'ECU', '218'], // Ecuador
|
|
['EE', 'EST', '233'], // Estonia
|
|
['EG', 'EGY', '818'], // Egypt
|
|
['EH', 'ESH', '732'], // Western Sahara
|
|
['ER', 'ERI', '232'], // Eritrea
|
|
['ES', 'ESP', '724'], // Spain
|
|
['ET', 'ETH', '231'], // Ethiopia
|
|
['FI', 'FIN', '246'], // Finland
|
|
['FJ', 'FJI', '242'], // Fiji
|
|
['FK', 'FLK', '238'], // Falkland Islands (Malvinas)
|
|
['FM', 'FSM', '583'], // Micronesia, Federated States of
|
|
['FO', 'FRO', '234'], // Faroe Islands
|
|
['FQ', 'ATF', null], // French Southern and Antarctic Territories
|
|
['FR', 'FRA', '250'], // France
|
|
['FX', 'FXX', '249'], // France, Metropolitan
|
|
['GA', 'GAB', '266'], // Gabon
|
|
['GB', 'GBR', '826'], // United Kingdom
|
|
['GD', 'GRD', '308'], // Grenada
|
|
['GE', 'GEL', '296'], // Gilbert and Ellice Islands
|
|
['GE', 'GEO', '268'], // Georgia
|
|
['GF', 'GUF', '254'], // French Guiana
|
|
['GG', 'GGY', '831'], // Guernsey
|
|
['GH', 'GHA', '288'], // Ghana
|
|
['GI', 'GIB', '292'], // Gibraltar
|
|
['GL', 'GRL', '304'], // Greenland
|
|
['GM', 'GMB', '270'], // Gambia
|
|
['GN', 'GIN', '324'], // Guinea
|
|
['GP', 'GLP', '312'], // Guadeloupe
|
|
['GQ', 'GNQ', '226'], // Equatorial Guinea
|
|
['GR', 'GRC', '300'], // Greece
|
|
['GS', 'SGS', '239'], // South Georgia and the South Sandwich Islands
|
|
['GT', 'GTM', '320'], // Guatemala
|
|
['GU', 'GUM', '316'], // Guam
|
|
['GW', 'GNB', '624'], // Guinea-Bissau
|
|
['GY', 'GUY', '328'], // Guyana
|
|
['HK', 'HKG', '344'], // Hong Kong
|
|
['HM', 'HMD', '334'], // Heard Island and McDonald Islands
|
|
['HN', 'HND', '340'], // Honduras
|
|
['HR', 'HRV', '191'], // Croatia
|
|
['HT', 'HTI', '332'], // Haiti
|
|
['HU', 'HUN', '348'], // Hungary
|
|
['HV', 'HVO', '854'], // Upper Volta, Republic of
|
|
['ID', 'IDN', '360'], // Indonesia
|
|
['IE', 'IRL', '372'], // Ireland
|
|
['IL', 'ISR', '376'], // Israel
|
|
['IM', 'IMN', '833'], // Isle of Man
|
|
['IN', 'IND', '356'], // India
|
|
['IO', 'IOT', '086'], // British Indian Ocean Territory
|
|
['IQ', 'IRQ', '368'], // Iraq
|
|
['IR', 'IRN', '364'], // Iran, Islamic Republic of
|
|
['IS', 'ISL', '352'], // Iceland
|
|
['IT', 'ITA', '380'], // Italy
|
|
['JE', 'JEY', '832'], // Jersey
|
|
['JM', 'JAM', '388'], // Jamaica
|
|
['JO', 'JOR', '400'], // Jordan
|
|
['JP', 'JPN', '392'], // Japan
|
|
['JT', 'JTN', '396'], // Johnston Island
|
|
['KE', 'KEN', '404'], // Kenya
|
|
['KG', 'KGZ', '417'], // Kyrgyzstan
|
|
['KH', 'KHM', '116'], // Cambodia
|
|
['KI', 'KIR', '296'], // Kiribati
|
|
['KM', 'COM', '174'], // Comoros
|
|
['KN', 'KNA', '659'], // Saint Kitts and Nevis
|
|
['KP', 'PRK', '408'], // Korea, Democratic People's Republic of
|
|
['KR', 'KOR', '410'], // Korea, Republic of
|
|
['KW', 'KWT', '414'], // Kuwait
|
|
['KY', 'CYM', '136'], // Cayman Islands
|
|
['KZ', 'KAZ', '398'], // Kazakhstan
|
|
['LA', 'LAO', '418'], // Lao People's Democratic Republic
|
|
['LB', 'LBN', '422'], // Lebanon
|
|
['LC', 'LCA', '662'], // Saint Lucia
|
|
['LI', 'LIE', '438'], // Liechtenstein
|
|
['LK', 'LKA', '144'], // Sri Lanka
|
|
['LR', 'LBR', '430'], // Liberia
|
|
['LS', 'LSO', '426'], // Lesotho
|
|
['LT', 'LTU', '440'], // Lithuania
|
|
['LU', 'LUX', '442'], // Luxembourg
|
|
['LV', 'LVA', '428'], // Latvia
|
|
['LY', 'LBY', '434'], // Libya
|
|
['MA', 'MAR', '504'], // Morocco
|
|
['MC', 'MCO', '492'], // Monaco
|
|
['MD', 'MDA', '498'], // Moldova, Republic of
|
|
['ME', 'MNE', '499'], // Montenegro
|
|
['MF', 'MAF', '663'], // Saint Martin (French part)
|
|
['MG', 'MDG', '450'], // Madagascar
|
|
['MH', 'MHL', '584'], // Marshall Islands
|
|
['MI', 'MID', '488'], // Midway Islands
|
|
['MK', 'MKD', '807'], // North Macedonia
|
|
['ML', 'MLI', '466'], // Mali
|
|
['MM', 'MMR', '104'], // Myanmar
|
|
['MN', 'MNG', '496'], // Mongolia
|
|
['MO', 'MAC', '446'], // Macao
|
|
['MP', 'MNP', '580'], // Northern Mariana Islands
|
|
['MQ', 'MTQ', '474'], // Martinique
|
|
['MR', 'MRT', '478'], // Mauritania
|
|
['MS', 'MSR', '500'], // Montserrat
|
|
['MT', 'MLT', '470'], // Malta
|
|
['MU', 'MUS', '480'], // Mauritius
|
|
['MV', 'MDV', '462'], // Maldives
|
|
['MW', 'MWI', '454'], // Malawi
|
|
['MX', 'MEX', '484'], // Mexico
|
|
['MY', 'MYS', '458'], // Malaysia
|
|
['MZ', 'MOZ', '508'], // Mozambique
|
|
['NA', 'NAM', '516'], // Namibia
|
|
['NC', 'NCL', '540'], // New Caledonia
|
|
['NE', 'NER', '562'], // Niger
|
|
['NF', 'NFK', '574'], // Norfolk Island
|
|
['NG', 'NGA', '566'], // Nigeria
|
|
['NH', 'NHB', '548'], // New Hebrides
|
|
['NI', 'NIC', '558'], // Nicaragua
|
|
['NL', 'NLD', '528'], // Netherlands
|
|
['NO', 'NOR', '578'], // Norway
|
|
['NP', 'NPL', '524'], // Nepal
|
|
['NQ', 'ATN', '216'], // Dronning Maud Land
|
|
['NR', 'NRU', '520'], // Nauru
|
|
['NT', 'NTZ', '536'], // Neutral Zone
|
|
['NU', 'NIU', '570'], // Niue
|
|
['NZ', 'NZL', '554'], // New Zealand
|
|
['OM', 'OMN', '512'], // Oman
|
|
['PA', 'PAN', '591'], // Panama
|
|
['PC', 'PCI', '582'], // Pacific Islands (trust territory)
|
|
['PE', 'PER', '604'], // Peru
|
|
['PF', 'PYF', '258'], // French Polynesia
|
|
['PG', 'PNG', '598'], // Papua New Guinea
|
|
['PH', 'PHL', '608'], // Philippines
|
|
['PK', 'PAK', '586'], // Pakistan
|
|
['PL', 'POL', '616'], // Poland
|
|
['PM', 'SPM', '666'], // Saint Pierre and Miquelon
|
|
['PN', 'PCN', '612'], // Pitcairn
|
|
['PR', 'PRI', '630'], // Puerto Rico
|
|
['PS', 'PSE', '275'], // Palestine, State of
|
|
['PT', 'PRT', '620'], // Portugal
|
|
['PU', 'PUS', '849'], // US Miscellaneous Pacific Islands
|
|
['PW', 'PLW', '585'], // Palau
|
|
['PY', 'PRY', '600'], // Paraguay
|
|
['PZ', 'PCZ', null], // Panama Canal Zone
|
|
['QA', 'QAT', '634'], // Qatar
|
|
['RE', 'REU', '638'], // Réunion
|
|
['RH', 'RHO', '716'], // Southern Rhodesia
|
|
['RO', 'ROU', '642'], // Romania
|
|
['RS', 'SRB', '688'], // Serbia
|
|
['RU', 'RUS', '643'], // Russian Federation
|
|
['RW', 'RWA', '646'], // Rwanda
|
|
['SA', 'SAU', '682'], // Saudi Arabia
|
|
['SB', 'SLB', '090'], // Solomon Islands
|
|
['SC', 'SYC', '690'], // Seychelles
|
|
['SD', 'SDN', '729'], // Sudan
|
|
['SE', 'SWE', '752'], // Sweden
|
|
['SG', 'SGP', '702'], // Singapore
|
|
['SH', 'SHN', '654'], // Saint Helena, Ascension and Tristan da Cunha
|
|
['SI', 'SVN', '705'], // Slovenia
|
|
['SJ', 'SJM', '744'], // Svalbard and Jan Mayen
|
|
['SK', 'SKM', null], // Sikkim
|
|
['SK', 'SVK', '703'], // Slovakia
|
|
['SL', 'SLE', '694'], // Sierra Leone
|
|
['SM', 'SMR', '674'], // San Marino
|
|
['SN', 'SEN', '686'], // Senegal
|
|
['SO', 'SOM', '706'], // Somalia
|
|
['SR', 'SUR', '740'], // Suriname
|
|
['SS', 'SSD', '728'], // South Sudan
|
|
['ST', 'STP', '678'], // Sao Tome and Principe
|
|
['SU', 'SUN', '810'], // USSR, Union of Soviet Socialist Republics
|
|
['SV', 'SLV', '222'], // El Salvador
|
|
['SX', 'SXM', '534'], // Sint Maarten (Dutch part)
|
|
['SY', 'SYR', '760'], // Syrian Arab Republic
|
|
['SZ', 'SWZ', '748'], // Eswatini
|
|
['TC', 'TCA', '796'], // Turks and Caicos Islands
|
|
['TD', 'TCD', '148'], // Chad
|
|
['TF', 'ATF', '260'], // French Southern Territories
|
|
['TG', 'TGO', '768'], // Togo
|
|
['TH', 'THA', '764'], // Thailand
|
|
['TJ', 'TJK', '762'], // Tajikistan
|
|
['TK', 'TKL', '772'], // Tokelau
|
|
['TL', 'TLS', '626'], // Timor-Leste
|
|
['TM', 'TKM', '795'], // Turkmenistan
|
|
['TN', 'TUN', '788'], // Tunisia
|
|
['TO', 'TON', '776'], // Tonga
|
|
['TP', 'TMP', '626'], // East Timor
|
|
['TR', 'TUR', '792'], // Turkey
|
|
['TT', 'TTO', '780'], // Trinidad and Tobago
|
|
['TV', 'TUV', '798'], // Tuvalu
|
|
['TW', 'TWN', '158'], // Taiwan, Province of China
|
|
['TZ', 'TZA', '834'], // Tanzania, United Republic of
|
|
['UA', 'UKR', '804'], // Ukraine
|
|
['UG', 'UGA', '800'], // Uganda
|
|
['UM', 'UMI', '581'], // United States Minor Outlying Islands
|
|
['US', 'USA', '840'], // United States
|
|
['UY', 'URY', '858'], // Uruguay
|
|
['UZ', 'UZB', '860'], // Uzbekistan
|
|
['VA', 'VAT', '336'], // Holy See (Vatican City State)
|
|
['VC', 'VCT', '670'], // Saint Vincent and the Grenadines
|
|
['VD', 'VDR', null], // Viet-Nam, Democratic Republic of
|
|
['VE', 'VEN', '862'], // Venezuela, Bolivarian Republic of
|
|
['VG', 'VGB', '092'], // Virgin Islands, British
|
|
['VI', 'VIR', '850'], // Virgin Islands, U.S.
|
|
['VN', 'VNM', '704'], // Viet Nam
|
|
['VU', 'VUT', '548'], // Vanuatu
|
|
['WF', 'WLF', '876'], // Wallis and Futuna
|
|
['WK', 'WAK', '872'], // Wake Island
|
|
['WS', 'WSM', '882'], // Samoa
|
|
['YD', 'YMD', '720'], // Yemen, Democratic, People's Democratic Republic of
|
|
['YE', 'YEM', '887'], // Yemen
|
|
['YT', 'MYT', '175'], // Mayotte
|
|
['YU', 'YUG', '891'], // Yugoslavia, Socialist Federal Republic of
|
|
['ZA', 'ZAF', '710'], // South Africa
|
|
['ZM', 'ZMB', '894'], // Zambia
|
|
['ZR', 'ZAR', '180'], // Zaire, Republic of
|
|
['ZW', 'ZWE', '716'], // Zimbabwe
|
|
];
|
|
|
|
/**
|
|
* @var string
|
|
*/
|
|
private $set;
|
|
|
|
/**
|
|
* Initializes the rule.
|
|
*
|
|
* @throws ComponentException If $set is not a valid set
|
|
*/
|
|
public function __construct(string $set = self::ALPHA2)
|
|
{
|
|
if (!isset(self::SET_INDEXES[$set])) {
|
|
throw new ComponentException(
|
|
sprintf(
|
|
'"%s" is not a valid set for ISO 3166-1 (Available: %s)',
|
|
$set,
|
|
implode(', ', array_keys(self::SET_INDEXES))
|
|
)
|
|
);
|
|
}
|
|
|
|
$this->set = $set;
|
|
}
|
|
|
|
/**
|
|
* {@inheritDoc}
|
|
*/
|
|
protected function getDataSource(): array
|
|
{
|
|
return array_column(self::COUNTRY_CODES, self::SET_INDEXES[$this->set]);
|
|
}
|
|
}
|