Detain\ZipZapper\Validator

Complexity

Total Complexity

12

Size/Duplication

Total Lines	324
Duplicated Lines	0 %

Coupling/Cohesion

Components	2
Dependencies	1

Test Coverage

Coverage

69.23%

Importance

Changes	4
Bugs	0	Features	0

5 Methods

Rating	Name	Duplication	Size	Complexity
B	isValid()	0	19	5
A	getFormats()	0	7	2
A	hasCountry()	0	3	1
A	getFormatPattern()	0	11	2
A	getZipName()	0	7	2

<?php
/*
 * This file is part of the postal-code-validator package
 *
 * @author Joe Huss <detain@interserver.net>
 */

namespace Detain\ZipZapper;

/**
 * Validator.
 *
 * @author Joe Huss <detain@interserver.net>
 */
class Validator {

The property $zip_names is not named in camelCase.

	protected $zip_names = array(
		'BR' => array('name' => 'CEP', 'acronym_text' => 'Código de endereçamento postal (Postal Addressing Code)'),
		'CA' => array('name' => 'Postal Code', 'acronym_text' => ''),
		'CH' => array('name' => 'NPA', 'acronym_text' => "numéro postal d'acheminement in French-speaking Switzerland and numéro postal d'acheminement in Italian-speaking Switzerland"),
		'DE' => array('name' => 'PLZ', 'acronym_text' => 'Postleitzahl (Postal Routing Number)'),
		'IE' => array('name' => 'Eircode', 'acronym_text' => ''),
		'IN' => array('name' => 'PIN code', 'acronym_text' => 'postal index number.'),
		'IT' => array('name' => 'CAP', 'acronym_text' => 'Codice di Avviamento Postale (Postal Expedition Code)'),
		'NL' => array('name' => 'Postcode', 'acronym_text' => ''),
		'US' => array('name' => 'ZIP code', 'acronym_text' => 'Zone Improvement Plan'),
	);

	/*
	 * country code: ISO 3166 2-letter code
	 * format:
	 *     # - numberic 0-9
	 *     @ - alpha a-zA-Z
	 */
	protected $formats = array(
		'AD' => array('CC###'), // Andorra, Notes: Each Parishes of Andorra|parish now has its own post code.
		'AE' => array(), // United Arab Emirates
		'AF' => array('####'), // Afghanistan, Notes: The first two digits (ranging from 10–43) correspond to the province, while the last two digits correspond either to the city/delivery zone (range 01–50) or to the district/delivery zone (range 51–99). (http://postalcode.afghanpost.gov.af/ Afghanistan Postal code lookup)
		'AG' => array(), // Antigua and Barbuda
		'AI' => array('@I-2640'), // Anguilla, Notes: Single code used for all addresses.
		'AL' => array('####'), // Albania, Notes: Introduced in 2006, gradually implemented throughout 2007.
		'AM' => array('####'), // Armenia, Notes: Previously used '''NNNNNN''' system inherited from former Soviet Union.
		'AO' => array(), // Angola
		'AQ' => array('BIQQ 1ZZ'), // British Antarctic Territory, Notes: One code for all addresses (AAAA NAA). UK territory, but not UK postcode.
		'AR' => array('####', '@####@@@'), // Argentina, Notes: 1974-1998 NNNN, and from 1999 ANNNNAAA. Codigo Postal Argentino (CPA), where the first A is the province code as in ISO 3166-2:AR, the four numbers are the old postal codes, the three last letters indicate a side of the block. Previously '''NNNN''' which is the minimum requirement as of 2006.
		'AS' => array('#####', '#####-####'), // American Samoa, Notes: U.S. ZIP codes (range '''96799''')
		'AT' => array('####'), // Austria, Notes: The first digit denotes regions, which are partly identical to one of the nine provinces—called ''Bundesländer''; the last the nearest post office in the area.
		'AU' => array('####'), // Australia, Notes: In general, the first digit identifies the state or territory.
		'AW' => array(), // Aruba
		'AX' => array('#####', 'CC-#####'), // Åland Islands, Notes: With Finland, first two numbers are 22. CC-NNNNN used from abroad
		'AZ' => array('CC####'), // Azerbaijan, Notes: Previously used '''NNNNNN''' system inherited from former Soviet Union.
		'BA' => array('#####'), // Bosnia and Herzegovina
		'BB' => array('CC#####'), // Barbados, Notes: Only one postal code currently assigned. '''11000''' applies to the General Post Office building in Cheapside, Bridgetown, to enable delivery to Barbados by global package delivery companies whose software requires a postal code.
		'BD' => array('####'), // | List of postal codes in Bangladesh|Bangladesh
		'BE' => array('####'), // Belgium, Notes: In general, the first digit gives the province.
		'BF' => array(), // Burkina Faso
		'BG' => array('####'), // Bulgaria
		'BH' => array('###', '####'), // Bahrain, Notes: Valid post code numbers are '''101''' to '''1216''' with gaps in the range. Known as ''block number'' ({{lang-ar|رقم المجمع}}) formally. The first digit in NNN format and the first two digits in NNNN format refer to one of the 12 municipalities of the country. PO Box address doesn't need a block number or city name, just the PO Box number followed by the name of the country, Bahrain.
		'BI' => array(), // Burundi
		'BJ' => array(), // Benin
		'BL' => array('97133'), // Saint Barthélemy, Notes: Overseas Collectivity of France. French codes used.
		'BM' => array('@@ ##', '@@ @@'), // Bermuda, Notes: AA NN for street addresses, AA AA for P.O. Box addresses. The second half of the postcode identifies the street delivery walk (e.g.: Hamilton HM 12) or the PO Box number range (e.g.: Hamilton HM BX).  See Postal codes in Bermuda.
		'BN' => array('@@####'), // Brunei
		'BO' => array(), // Bolivia
		'BQ' => array(), // Bonaire, Sint Eustatius and Saba
		'BR' => array('#####-###'), // Brazil, Notes: NNNNN only from 1971 to 1992. Código de Endereçamento Postal (CEP): -000 to -899 are used for streets, roads, avenues, boulevards; -900 to -959 are used for buildings with a high postal use; -960 to -969 are for promotional use; -970 to -989 are post offices and regular P.O. boxes; and -990 to -998 are used for community P.O. boxes. -999 is used for special services.
		'BS' => array(), // Bahamas
		'BT' => array('#####'), // Bhutan
		'BV' => array(), // Bouvet Island
		'BW' => array(), // Botswana
		'BY' => array('######'), // Belarus, Notes: Retained system inherited from former Soviet Union.
		'BZ' => array(), // Belize
		'CA' => array('@#@ #@#'), // Canada, Notes: The system was gradually introduced starting in April 1971 in Ottawa. The letters D, F, I, O, Q, and U are not used to avoid confusion with other letters or numbers.
		'CC' => array('####'), // Cocos (Keeling) Island, Notes: Part of the Australian postal code system.
		'CD' => array(), // Congo, Democratic Republic
		'CF' => array(), // Central African Republic
		'CG' => array(), // Congo (Brazzaville)
		'CH' => array('####'), // Switzerland, Notes: With Liechtenstein, ordered from west to east. In Geneva and other big cities, like Basel, Bern, Zurich, there may be one or two digits after the name of the city when the generic City code (1211) is used instead of the area-specific code (1201, 1202...), e.g.: 1211 Geneva 13. The digit identifies the post office. This addressing is generally used for P.O. box deliveries. Büsingen (Germany) and Campione (Italy) have also a Swiss postal code.
		'CI' => array(), // Côte d'Ivoire (Ivory Coast)
		'CK' => array(), // Cook Islands
		'CL' => array('#######', '###-####'), // Chile, Notes: May only be required for bulk mail.
		'CM' => array(), // Cameroon
		'CN' => array('######'), // China, Notes: A postal code or ''youbian'' (邮编) in a subordinate division will have the same first two digits as its governing one (see Administrative divisions of the People's Republic of China#Levels|Political divisions of China. The postal services in Macau or Hong Kong Special Administrative Region of the People's Republic of China|Special Administrative Regions remain separate from Mainland China, with no post code system currently used.
		'CO' => array('######'), // Colombia, Notes: First NN = 32 departments of Colombia|departments<ref>{{cite web|url=http://english.4-72.com.co/?q=content/postal-codes |title=Postal Codes |publisher=Colombian Postal Network 4-72 |accessdate=2010-03-04 }}</ref> [http://www.codigopostal4-72.com.co/codigosPostales/ Códigos Postales | 4-72]
		'CR' => array('#####', '#####-####'), // Costa Rica, Notes: Was NNNN until 2007. First codes the provinces, next two the canton, last two the district.
		'CU' => array('#####'), // Cuba, Notes: May only be required for bulk mail. The letters CP are frequently used before the postal code. This is not a country code, but an abbreviation for "codigo postal" or postal code.
		'CV' => array('####'), // Cape Verde, Notes: The first digit indicates the island.
		'CW' => array(), // Curaçao
		'CX' => array('####'), // Christmas Island, Notes: Part of the Australian postal code system.
		'CY' => array('####'), // Cyprus, Notes: The postal code system covers the whole island, but is not used on mail to Northern Cyprus. Northern Cyprus uses a 5-digit code commencing 99, introduced in 2013. For mail sent there from abroad, the line "Mersin 10" is written on the line above that containing the postal code, and the country name used is "Turkey".
		'CZ' => array('### ##'), // Czech Republic, Notes: With Slovak Republic, Poštovní směrovací číslo (PSČ) - postal routing number.
		'DE' => array('#####'), // Germany, Notes: Known as Postleitzahl (PLZ), introduced after the German reunification. Between 1989 and 1993 the old separate 4-digit postal codes of former West-Germany|West- and East-Germany were distinguished by preceding "W-" ('West') or "O-" ({{lang|de|'Ost'}} for East).
		'DJ' => array(), // Djibouti
		'DK' => array('####'), // Denmark, Notes: Numbering follows the dispatch of postal trains from Copenhagen.<ref>http://www.denstoredanske.dk/It,_teknik_og_naturvidenskab/Elektronik,_teletrafik_og_kommunikation/Postforsendelser/postnummer?highlight=postnummer</ref> Also used by Greenland, e.g.: Nuuk|DK-3900 Nuuk.
		'DM' => array(), // Dominica
		'DO' => array('#####'), // Dominican Republic
		'DZ' => array('#####'), // Algeria, Notes: First two as in ISO 3166-2:DZ
		'EC' => array('######'), // Ecuador
		'EE' => array('#####'), // Estonia
		'EG' => array('#####'), // Egypt
		'EH' => array(), // Western Sahara
		'ER' => array(), // Eritrea
		'ES' => array('#####'), // Spain, Notes: First two indicate the province, range 01-52
		'ET' => array('####'), // Ethiopia, Notes: The code is only used on a trial basis for Addis Ababa addresses.
		'FI' => array('#####'), // Finland, Notes: A lower first digit indicates a place in south (for example 00100 Helsinki), a higher indicates a place further to north (99800 in Ivalo). The last digit is usually 0, except for postal codes for PO Box number ranges, in which case it is 1. Country code for Finland: "FI". In the Åland Islands, the postal code is prefixed with "AX", not "FI". Some postal codes for rural settlements may end with 5, and there are some unique postal codes for large companies and institutions, e.g. 00014 HELSINGIN YLIOPISTO (university), 00102 EDUSKUNTA (parliament), 00020 NORDEA (a major Scandinavian bank).
		'FJ' => array(), // Fiji
		'FK' => array('FIQQ 1ZZ'), // Falkland Islands, Notes: Single code (AAAA NAA). UK territory, but not UK postcode
		'FM' => array('#####', '#####-####'), // Micronesia, Notes: U.S. ZIP codes. Range '''96941''' - '''96944'''.
		'FO' => array('###'), // Faroe Islands, Notes: Self-governing territory within the Kingdom of Denmark, but not Danish postcode.
		'FR' => array('#####'), // France, Notes: The first two digits give the ''département in France|département'' number, while in Paris, Lyon and Marseille, the last two digits of the postal code indicates the Municipal arrondissement in France|arrondissement. Both of the 2 Corsican départements use "20" as the first two digits. Also used by French overseas departments and territories. Monaco is also part of the French postal code system, but the country code MC- is used for Monegasque addresses.
		'GA' => array(), // Gabon
		'GB' => array('@#', '@##', '@@#', '@@##', '@#@', '@@#@', '@@@', '@# #@@', '@## #@@', '@@# #@@', '@@## #@@', '@#@ #@@', '@@#@ #@@', '@@@ #@@'), // | Postcodes in the United Kingdom|United Kingdom, Notes: Known as the UK postcodes|postcode. The first letter(s) indicate the List of postcode areas in the United Kingdom|postal area, such as the town or part of London. Placed on a separate line below the city (or county, if used). The UK postcode is made up of two parts separated by a space.  These are known as the '''outward postcode''' and the '''inward postcode'''. The outward postcode is always one of the following formats: AN, ANN, AAN, AANN, ANA, AANA, AAA.  The inward postcode is always formatted as NAA.  A valid inward postcode never contains the letters: C, I, K, M, O or V.  The British Forces Post Office has a different system, but as of 2012 has also adopted UK-style postcodes that begin with "BF1" for electronic compatibility.
		'GD' => array(), // Grenada
		'GE' => array('####'), // Georgia
		'GF' => array('973##'), // French Guiana, Notes: Overseas Department of France. French codes used. Range '''97300''' - '''97390'''.
		'GG' => array('@@# #@@', '@@## #@@'), // | GY postcode area|Guernsey, Notes: UK-format postcode (first two letters are always GY)
		'GH' => array(), // Ghana, Notes: {{citation needed|date=January 2011}}
		'GI' => array('GX11 1@@'), // Gibraltar, Notes: Single code used for all addresses.
		'GL' => array('####'), // Greenland, Notes: Part of the Danish postal code system.
		'GM' => array(), // Gambia
		'GN' => array('###'), // Guinea
		'GP' => array('971##'), // Guadeloupe, Notes: Overseas Department of France. French codes used. Range '''97100''' - '''97190'''.
		'GQ' => array(), // Equatorial Guinea
		'GR' => array('### ##'), // Greece
		'GS' => array('SIQQ 1ZZ'), // South Georgia and the South Sandwich Islands, Notes: One code for all addresses.
		'GT' => array('#####'), // Guatemala, Notes: The first two numbers identify the department, the third number the route and the last two the office.
		'GU' => array('#####', '#####-####'), // Guam, Notes: U.S. ZIP codes. Range '''96910''' - '''96932'''.
		'GW' => array('####'), // Guinea Bissau
		'GY' => array(), // Guyana
		'HK' => array(), // Hong Kong, Notes: [http://www.upu.int/fileadmin/documentsFiles/activities/addressingUnit/hkgEn.pdf] The dummy postal code of Hong Kong is 999077.
		'HM' => array(), // Heard and McDonald Islands
		'HN' => array('CC#####'), // Honduras
		'HR' => array('#####'), // Croatia
		'HT' => array('####'), // Haiti
		'HU' => array('####'), // Hungary, Notes: The code defines an area, usually one code per settlement except the six largest towns. One code can identify more (usually) small settlements as well.
		'ID' => array('#####'), // Indonesia, Notes: Kode Pos. Included East Timor (ranges 88xxx and 89xxx) until 1999, no longer used. For Indonesia postal code information visit [http://kodepos.posindonesia.co.id <nowiki>[2]</nowiki>]
		'IE' => array('@## @#@#', '@## @@##', '@## @#@@', '@#W @#@#', '@#W @@##', '@#W @#@@'), // Ireland, Notes: Ireland's postcode system (called Eircode) refers to individual properties - not to streets/areas. The first 3 characters are a routing key referring to an area's postal district, and the second 4 characters are an individual property identifier. "see www.eircode.ie for more information"'' See also Republic of Ireland postal addresses.''
		'IL' => array('#######'), // Israel, Notes: In 2013, after the introduction of the 7 digit codes, 5 digit codes were still being used widely.
		'IM' => array('CC# #@@', 'CC## #@@'), // | IM postcode area|Isle of Man, Notes: UK-format postcode. The first two letters are always IM.
		'IN' => array('######', '## ###'), // India
		'IO' => array('BB#D 1ZZ'), // British Indian Ocean Territory, Notes: One code for all addresses (AAAA NAA). UK territory, but not UK postcode.
		'IQ' => array('#####'), // Iraq
		'IR' => array('##########'), // Iran, Notes: (Persian language|Persian: کد پستی)
		'IS' => array('###'), // Iceland
		'IT' => array('#####'), // Italy, Notes: Codice di Avviamento Postale (CAP). Also used by San Marino and Vatican City. First two digits identify province with some exceptions, because there are more than 100 provinces.
		'JE' => array('CC# #@@', 'CC## #@@'), // | JE postcode area|Jersey, Notes: UK-format postcode. The first two letters are always JE.
		'JM' => array('##'), // Jamaica, Notes: Before suspension: CCAAANN. Jamaica currently has no national postal code system, except for Kingston and Lower St. Andrew, which are divided into postal districts numbered '''1'''-'''20'''<ref>[http://www.jamaicapost.gov.jm/corporate_news/pressrelease_07.htm Postal Corporation of Jamaica Press Releases 2007 - POST CODE PROJECT SUSPENDED INDEFINITELY (12 February 2007)]</ref>
		'JO' => array('#####'), // Jordan, Notes: Deliveries to PO Boxes only.
		'JP' => array('###-####'), // Japan, Notes: See also Japanese addressing system.
		'KE' => array('#####'), // Kenya, Notes: Deliveries to PO Boxes only. The postal code refers to the post office at which the receiver's P. O. Box is located.
		'KG' => array('######'), // Kyrgyzstan
		'KH' => array('#####'), // Cambodia
		'KI' => array(), // Kiribati
		'KM' => array(), // Comoros
		'KN' => array(), // Saint Kitts and Nevis
		'KP' => array(), // Korea, North
		'KR' => array('#####'), // | List of postal codes in South Korea|Korea, South, Notes: Previously NNN-NNN (1988~2015), NNN-NN (1970~1988)
		'KW' => array('#####'), // Kuwait, Notes: The first two digits represent the sector and the last three digits represents the post office.
		'KY' => array('CC#-####'), // Cayman Islands
		'KZ' => array('######'), // Kazakhstan, Notes: <ref>[http://eshop.kazpost.kz/QueryForm.php Kazakhstan's postal codes]</ref>
		'LA' => array('#####'), // Laos
		'LB' => array('#####', '#### ####'), // Lebanon, Notes: The first four digits represent the region or postal zone,the last four digits represent the building see also [http://postal-codes.net/lebanon_postal_codes/ Lebanon Postal code website].
		'LC' => array('LC##  ###'), // Saint Lucia, Notes: The first two letters are always LC. There are two spaces between the second and third digits.
		'LI' => array('####'), // Liechtenstein, Notes: With Switzerland, ordered from west to east. Range '''9485''' - '''9498'''.
		'LK' => array('#####'), // Sri Lanka, Notes: Reference: http://mohanjith.net/ZIPLook/ Incorporates Colombo postal districts, e.g.: Colombo 1 is "00100". You can search for specific postal codes [http://www.slpost.gov.lk here].
		'LR' => array('####'), // Liberia, Notes: Two digit postal zone after city name.
		'LS' => array('###'), // Lesotho
		'LT' => array('CC-#####'), // Lithuania, Notes: References: http://www.post.lt/en/help/postal-code-search. Previously '''9999''' which was actually the old Soviet Union|Soviet '''999999''' format code with the first 2 digits dropped.
		'LU' => array('####'), // Luxembourg, Notes: References: http://www.upu.int/post_code/en/countries/LUX.pdf
		'LV' => array('CC-####'), // Latvia
		'LY' => array(), // Libya
		'MA' => array('#####'), // Morocco
		'MC' => array('980##'), // Monaco, Notes: Uses the French Postal System, but with an "MC" Prefix for Monaco. Code range 98000-98099
		'MD' => array('CC####', 'CC-####'), // Moldova
		'ME' => array('#####'), // Montenegro
		'MF' => array('97150'), // Saint Martin, Notes: Overseas Collectivity of France. French codes used.
		'MG' => array('###'), // Madagascar
		'MH' => array('#####', '#####-####'), // Marshall Islands, Notes: U.S. ZIP codes. Range '''96960''' - '''96970'''.
		'MK' => array('####'), // Macedonia
		'ML' => array(), // Mali
		'MM' => array('#####'), // Myanmar
		'MN' => array('######'), // Mongolia, Notes: First digit: region / zone, Second digit: province / district, Last three digits: locality / delivery block<ref>http://en.youbianku.com/Mongolia</ref>
		'MO' => array(), // Macau, Notes: [http://www.upu.int/fileadmin/userUpload/damFileSystem/universalPostalUnion/activities/addressing/postalAddressingSystemsInMemberCountries/sheetsEn/MAC.pdf]<!-- Please DON'T add any post code information. ALL postcode sources are WRONG, and Macau doesn't use postcodes. See the addressing guide from Universal Postal Union (link above) BEFORE editing. -->
		'MP' => array('#####', '#####-####'), // Northern Mariana Islands, Notes: U.S. ZIP codes. Range '''96950''' - '''96952'''.
		'MQ' => array('972##'), // Martinique, Notes: Overseas Department of France. French codes used. Range '''97200''' - '''97290'''.
		'MR' => array(), // Mauritania
		'MS' => array('MSR 1110-1350'), // Montserrat
		'MT' => array('@@@ ####'), // Malta, Notes: Kodiċi Postali
		'MU' => array('#####'), // Mauritius
		'MV' => array('#####'), // Maldives
		'MW' => array(), // Malawi
		'MX' => array('#####'), // Mexico, Notes: The first two digits identify the States of Mexico|state (or a part thereof), except for Nos. 00 to 16, which indicate ''delegaciones'' (boroughs) of the Mexican Federal District|Federal District (Mexico City).
		'MY' => array('#####'), // Malaysia
		'MZ' => array('####'), // Mozambique
		'NA' => array(), // Namibia, Notes: Formerly used South African postal code ranges from 9000-9299.<ref name="panorama">[https://books.google.co.uk/books?id=rMtBAAAAYAAJ&dq=Post+Codes+introduced+in+South+Africa+in+1973&focus=searchwithinvolume&q=9000 ''South African Panorama'' – Volume 22), South African Information Service, 1977, page 9</ref>  Withdrawn from use after independence in 1990.<ref>[https://books.google.co.uk/books?id=1c63AAAAIAAJ&dq=Postal+codes+in+Namibia&focus=searchwithinvolume&q=%22postal+codes%22 ''The comprehensive handbook of the postmarks of German South West Africa, South West Africa, Namibia''), Ralph F. Putzel, R.F. Putzel, 1991, page 173</ref> A five-digit postal code system is under consideration.<ref>[http://www.upu.int/fileadmin/documentsFiles/activities/addressingUnit/namEn.pdf Namibia), Universal Postal Union, May 2014</ref>
		'NC' => array('988##'), // New Caledonia, Notes: Overseas Collectivity of France. French codes used. Range '''98800''' - '''98890'''.
		'NE' => array('####'), // Niger
		'NF' => array('####'), // Norfolk Island, Notes: Part of the Australian postal code system.
		'NG' => array('######'), // Nigeria
		'NI' => array('#####'), // Nicaragua
		'NL' => array('#### @@'), // Netherlands, Notes: The combination of the postal code and the house number gives a unique identifier of the address. The four numbers indicate an area, the two letters indicate a group of some 25 habitations, offices, factories or post office boxes.
		'NO' => array('####'), // Norway, Notes: From south to north
		'NP' => array('#####'), // | List of postal codes in Nepal|Nepal
		'NR' => array(), // Nauru
		'NU' => array(), // Niue
		'NZ' => array('####'), // New Zealand, Notes: Postcodes were originally intended for bulk mailing and were not needed for addressing individual items. However, new post codes for general use were phased in from June 2006 and came into force by July 2008.
		'OM' => array('###'), // Oman, Notes: Deliveries to P.O. Boxes only.
		'PA' => array('####'), // Panama
		'PE' => array('#####', 'CC ####'), // | List of postal codes in Peru|Peru
		'PF' => array('987##'), // French Polynesia, Notes: Overseas Collectivity of France. French codes used. Range '''98700''' - '''98790'''.
		'PG' => array('###'), // Papua New Guinea
		'PH' => array('####'), // Philippines
		'PK' => array('#####'), // | List of postal codes of Pakistan|Pakistan, Notes: [https://trackpost.org/ Pakistan postal codes list]
		'PL' => array('##-###'), // Poland
		'PM' => array('97500'), // Saint Pierre and Miquelon, Notes: Overseas Collectivity of France. French codes used.
		'PN' => array('PCR# 1ZZ'), // Pitcairn Islands, Notes: Single code used(AAAA NAA). UK territory, but not UK postcode
		'PR' => array('#####', '#####-####'), // Puerto Rico, Notes: U.S. ZIP codes. ZIP codes 006XX for NW PR, 007XX for SE PR, in which XX designates the town or post office and 009XX for the San Juan Metropolitan Area, in which XX designates the area or borough of San Juan. The last four digits identify an area within the post office. For example 00716-2604: 00716-for the east section of the city of Ponce and 2604 for Aceitillo St. in the neighborhood of Los Caobos. US Post office is changing the PR address format to the American one: 1234 No Name Avenue, San Juan, PR 00901.
		'PS' => array('###'), // Palestine, Notes: not yet implemented in practice. Codes '''100-899''' are in the Westbank, '''900-999''' in the Gaza Strip
		'PT' => array('####-###', '####'), // Portugal
		'PW' => array('#####', '#####-####'), // Palau, Notes: U.S. ZIP codes. All locations '''96940'''.
		'PY' => array('####'), // | List of postal codes of Paraguay|Paraguay
		'QA' => array(), // Qatar
		'RE' => array('974##'), // Réunion, Notes: Overseas Department of France. French codes used. Range '''97400''' - '''97490'''.
		'RO' => array('######'), // Romania, Notes: Previously '''99999''' in Bucharest and '''9999''' in rest of country.
		'RS' => array('#####'), // Serbia, Notes: Poštanski adresni kod (PAK)
		'RU' => array('######'), // Russia, Notes: Placed on a line of its own.
		'RW' => array(), // Rwanda
		'SA' => array('#####-####', '#####'), // Saudi Arabia, Notes: NNNNN for PO Boxes. NNNNN-NNNN for home delivery. A complete 13-digit code has 5-digit number representing region, sector, city, and zone; 4-digit X between 2000 and 5999; 4-digit Y between 6000 and 9999 [http://www.esri.com/news/arcnews/winter1011articles/saudi-arabia.html]. Digits of 5-digit code may represent postal region, sector, branch,  section, and block respectively [http://youbianku.com/files/upu/SAU.pdf].
		'SB' => array(), // Solomon Islands
		'SC' => array(), // Seychelles
		'SD' => array('#####'), // Sudan
		'SE' => array('### ##'), // Sweden, Notes: The lowest number is '''100 00''' and the highest number is '''984 99'''.
		'SG' => array('######'), // Singapore, Notes: Each building has its own unique postcode.
		'SH' => array('@@@@ 1ZZ'), // Saint Helena, Ascension and Tristan da Cunha, Notes: Part of UK system (AAAA NAA). Saint Helena, Ascension and Tristan da Cunha|Saint Helena uses one code STHL 1ZZ, Ascension Island|Ascension uses one code ASCN 1ZZ, Tristan da Cunha uses one code TDCU 1ZZ.
		'SI' => array('####', 'CC-####'), // Slovenia
		'SJ' => array('####'), // | Svalbard and Jan Mayen, Notes: Norway postal codes
		'SK' => array('### ##'), // Slovakia, Notes: with Czech Republic from west to east, Poštové smerovacie číslo (PSČ) - postal routing number.
		'SL' => array(), // Sierra Leone
		'SM' => array('4789#'), // San Marino, Notes: With Italy, uses a five-digit numeric CAP of Emilia Romagna. Range 47890 and 47899
		'SN' => array('#####'), // Senegal, Notes: The letters CP or C.P. are often written in front of the postcode. This is not a country code, but simply an abbreviation for "code postal".
		'SO' => array('@@ #####'), // Somalia, Notes: Two letter postal codes for each of the nation's 18 Administrative divisions of Somalia|administrative regions (e.g. AW for Awdal, BN for Banaadir, BR for Bari, Somalia|Bari and SL for Sool, Somalia|Sool).<ref name="Wsptsg">{{cite news|title=Weekly Statement: Progress of the Somali Government|url=http://diplomat.so/2014/10/11/weekly-statement-progress-of-the-somali-government-3/|accessdate=12 October 2014|agency=Diplomat News Network|date=11 October 2014}}</ref>
		'SR' => array(), // Suriname
		'SS' => array(), // South Sudan
		'ST' => array(), // Sao Tome and Principe
		'SV' => array('####'), // El Salvador
		'SX' => array(), // Sint Maarten
		'SY' => array(), // Syria, Notes: A 4-digit system has been announced. Status unknown.
		'SZ' => array('@###'), // Swaziland, Notes: The letter identifies one of the country's four districts.
		'TC' => array('TKC@ 1ZZ'), // Turks and Caicos Islands, Notes: Single code used for all addresses.
		'TD' => array(), // Chad
		'TF' => array(), // French Southern and Antarctic Territories, Notes: French codes in the '''98400''' range have been reserved.
		'TG' => array(), // Togo
		'TH' => array('#####'), // Thailand, Notes: The first two specify the province, numbers as in ISO 3166-2:TH, the third and fourth digits specify a district (amphoe)
		'TJ' => array('######'), // Tajikistan, Notes: Retained system from former Soviet Union.
		'TK' => array(), // Tokelau
		'TL' => array(), // East Timor, Notes: No postal code system in use since Indonesian withdrawal in 1999.
		'TM' => array('######'), // Turkmenistan, Notes: Retained system from former Soviet Union.
		'TN' => array('####'), // Tunisia
		'TO' => array(), // Tonga
		'TR' => array('#####'), // Turkey, Notes: First two digits are the city numbers.<ref>http://www.postakodumne.com | Posta Kodum Ne - Postal Code Reference for Turkey</ref>
		'TT' => array('######'), // Trinidad and Tobago, Notes: First two digits specify a postal district (one of 72), next two digits a carrier route, last two digits a building or zone along that route
		'TV' => array(), // Tuvalu
		'TW' => array('###', '###-##'), // Taiwan, Notes: The first three digits of the postal code are required; the last two digits are optional. Codes are known as ''youdi quhao'' (郵遞區號), and are also assigned to Senkaku Islands (''Diaoyutai''), though Japanese-administered,  the Pratas Islands and the Spratly Islands. See List of postal codes in Taiwan.
		'TZ' => array('#####'), // Tanzania
		'UA' => array('#####'), // Ukraine
		'UG' => array(), // Uganda
		'UM' => array(), // United States Minor Outlying Islands
		'US' => array('#####', '#####-####'), // | ZIP code|United States, Notes: Known as the ZIP Code with five digits '''99999*''' or the ZIP+4 Code with nine digits '''99999-9999*''' (while the minimum requirement is the first five digits, the U.S. Postal Service encourages everyone to use all nine). Also used by the former US Pacific Territories: Federated States of Micronesia; Palau; and the Marshall Islands, as well as in current US territories American Samoa, Guam, Northern Mariana Islands, Puerto Rico, and the United States Virgin Islands.  An individual delivery point may be represented as an 11-digit number, but these are usually represented by Intelligent Mail barcode or formerly POSTNET bar code.
		'UY' => array('#####'), // Uruguay
		'UZ' => array('######'), // Uzbekistan, Notes: [http://www.aci.uz/ru/online_services/postal_indexes/ Почтовые индексы]
		'VA' => array('00120'), // Vatican, Notes: Single code used for all addresses. Part of the Italian postal code system.
		'VC' => array('CC####'), // Saint Vincent and the Grenadines
		'VE' => array('####', '####-@'), // Venezuela
		'VG' => array('CC####'), // British Virgin Islands, Notes: Specifically, VG1110 through VG1160<ref>http://www.finance.gov.vg/AboutUs/Departments/BVIPostOffice.aspx</ref>
		'VI' => array('#####', '#####-####'), // U.S. Virgin Islands, Notes: U.S. ZIP codes. Range '''00801''' - '''00851'''.
		'VN' => array('######'), // Vietnam, Notes: First two indicate a provinces of Vietnam|province.
		'VU' => array(), // Vanuatu
		'WF' => array('986##'), // Wallis and Futuna, Notes: Overseas Collectivity of France. French codes used. Range '''98600''' - '''98690'''.
		'WS' => array('CC####'), // Samoa
		'XK' => array('#####'), // Kosovo, Notes: A separate postal code for Kosovo was introduced by the UNMIK postal administration in 2004. Serbian postcodes are still widely used in the Serbian enclaves. No country code has been assigned.
		'YE' => array(), // Yemen, Notes: System for Sana'a Governorate using geocoding "عنواني" based on the Postal addresses in the Republic of Ireland#OpenPostcode|OpenPostcode algorithm is inaugurated in 2014.<ref>http://www.althawranews.net/pdf/main/2014-01-02/02.pdf</ref>
		'YT' => array('976##'), // Mayotte, Notes: Overseas Department of France. French codes used. Range '''97600''' - '''97690'''.
		'ZA' => array('####'), // South Africa, Notes: Postal codes are allocated to individual Post Office branches, some have two codes to differentiate between P.O. Boxes and street delivery addresses. Included Namibia (ranges 9000-9299) until 1992, no longer used.
		'ZM' => array('#####'), // Zambia
		'ZW' => array(), // Zimbabwe, Notes: System is being planned.
	);

	public function isValid($countryCode, $postalCode, $ignoreSpaces = false) {
		//$postalCode = str_replace('-', '', $postalCode);
		if (!isset($this->formats[$countryCode])) {
			throw new ValidationException(sprintf('Invalid country code: "%s"', $countryCode));
		}

		foreach ($this->formats[$countryCode] as $format) {
			#echo $postalCode . ' - ' . $this->getFormatPattern($format)."\n";

Perl-style comments are not allowed. Use "// Comment." or "/* comment */" instead.

			if (preg_match($this->getFormatPattern($format, $ignoreSpaces), $postalCode)) {
				return true;
			}
		}

		if (!count($this->formats[$countryCode])) {

This if statement, and the following return statement can be replaced with return !count($this->formats[$countryCode]);.

			return true;
		}

		return false;
	}

	public function getFormats($countryCode) {

The return type could not be reliably inferred; please add a @return annotation.

		if (!isset($this->formats[$countryCode])) {
			throw new ValidationException(sprintf('Invalid country code: "%s"', $countryCode));
		}

		return $this->formats[$countryCode];
	}

	public function hasCountry($countryCode) {
		return (isset($this->formats[$countryCode]));
	}

	protected function getFormatPattern($format, $ignoreSpaces = false) {
		//$format = str_replace('-', '', $format);
		$pattern = str_replace('#', '\d', $format);
		$pattern = str_replace('@', '[a-zA-Z]', $pattern);

		if ($ignoreSpaces) {
			$pattern = str_replace(' ', ' ?', $pattern);
		}

		return '/^'.$pattern.'$/';
	}

	public function getZipName($countryCode) {

The return type could not be reliably inferred; please add a @return annotation.

		if (isset($this->zip_names[$countryCode]))
			$name = $this->zip_names[$countryCode]['name'];
		else
			$name = 'Postal Code';
		return $name;
	}
}