From 17ad09121f8f25a6f6b6da7954833a4680a641cc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1=C5=A1=20Neumaier?= Date: Wed, 19 Nov 2025 16:09:19 +0100 Subject: [PATCH 1/5] Support historical currencies --- .gitignore | 1 + composer.json | 3 +- data/country-to-currency-historical.php | 105 ++ data/country-to-currency.php | 8 +- data/iso-currencies.php | 2196 +++++++++++++++++++++-- data/numeric-to-currency.php | 81 +- import-currencies.php | 380 +++- src/Currency.php | 49 +- src/CurrencyType.php | 12 + src/ISOCurrencyProvider.php | 108 +- tests/AbstractTestCase.php | 4 +- tests/CurrencyTest.php | 52 +- tests/ISOCurrencyProviderTest.php | 77 +- 13 files changed, 2798 insertions(+), 278 deletions(-) create mode 100644 data/country-to-currency-historical.php create mode 100644 src/CurrencyType.php diff --git a/.gitignore b/.gitignore index d9ac4579..278fc77a 100644 --- a/.gitignore +++ b/.gitignore @@ -1,6 +1,7 @@ /vendor /composer.lock /.phpunit.cache +/.idea/ /tools/* !/tools/ecs/composer.json diff --git a/composer.json b/composer.json index 21d33d8c..ff1631a1 100644 --- a/composer.json +++ b/composer.json @@ -10,7 +10,8 @@ "license": "MIT", "require": { "php": "^8.1", - "brick/math": "~0.12.0|~0.13.0|~0.14.0" + "brick/math": "~0.12.0|~0.13.0|~0.14.0", + "symfony/deprecation-contracts": "^2.2|^3.0" }, "require-dev": { "ext-dom": "*", diff --git a/data/country-to-currency-historical.php b/data/country-to-currency-historical.php new file mode 100644 index 00000000..2b75c699 --- /dev/null +++ b/data/country-to-currency-historical.php @@ -0,0 +1,105 @@ + ['ADP', 'ESP', 'FRF'], + 'AF' => ['AFA'], + 'AL' => ['ALK'], + 'AM' => ['RUR'], + 'AN' => ['ANG'], + 'AO' => ['AOK', 'AON', 'AOR'], + 'AR' => ['ARA', 'ARP', 'ARY'], + 'AT' => ['ATS'], + 'AX' => ['FIM'], + 'AZ' => ['AYM', 'AZM', 'RUR'], + 'BA' => ['BAD'], + 'BE' => ['BEC', 'BEF', 'BEL'], + 'BG' => ['BGJ', 'BGK', 'BGL'], + 'BL' => ['FRF'], + 'BQ' => ['BOP'], + 'BR' => ['BRB', 'BRC', 'BRE', 'BRN', 'BRR'], + 'BU' => ['BUK'], + 'BY' => ['BYB', 'BYR', 'RUR'], + 'CH' => ['CHC'], + 'CS' => ['CSJ', 'CSK', 'CSD', 'EUR'], + 'CU' => ['CUC'], + 'CW' => ['ANG'], + 'CY' => ['CYP'], + 'DD' => ['DDM'], + 'DE' => ['DEM'], + 'EC' => ['ECS', 'ECV'], + 'EE' => ['EEK'], + 'ES' => ['ESA', 'ESB', 'ESP'], + 'FI' => ['FIM'], + 'FQ' => ['FRF'], + 'FR' => ['FRF'], + 'GE' => ['GEK', 'RUR'], + 'GF' => ['FRF'], + 'GH' => ['GHC', 'GHP'], + 'GN' => ['GNE', 'GNS'], + 'GP' => ['FRF'], + 'GQ' => ['GQE'], + 'GR' => ['GRD'], + 'GW' => ['GWE', 'GWP'], + 'HR' => ['HRD', 'HRK'], + 'IE' => ['IEP'], + 'IL' => ['ILP', 'ILR'], + 'IS' => ['ISJ'], + 'IT' => ['ITL'], + 'KG' => ['RUR'], + 'KZ' => ['RUR'], + 'LA' => ['LAJ'], + 'LS' => ['LSM', 'ZAL'], + 'LT' => ['LTL', 'LTT'], + 'LU' => ['LUC', 'LUF', 'LUL'], + 'LV' => ['LVL', 'LVR'], + 'MC' => ['FRF'], + 'MD' => ['RUR'], + 'MF' => ['FRF'], + 'MG' => ['MGF'], + 'ML' => ['MLF'], + 'MQ' => ['FRF'], + 'MR' => ['MRO'], + 'MT' => ['MTL', 'MTP'], + 'MV' => ['MVQ'], + 'MW' => ['MWK'], + 'MX' => ['MXP'], + 'MZ' => ['MZE', 'MZM'], + 'NI' => ['NIC'], + 'NL' => ['NLG'], + 'PE' => ['PEH', 'PEI', 'PEN', 'PES'], + 'PL' => ['PLZ'], + 'PM' => ['FRF'], + 'PT' => ['PTE'], + 'RE' => ['FRF'], + 'RH' => ['RHD'], + 'RO' => ['ROK', 'ROL', 'RON'], + 'RU' => ['RUR'], + 'SD' => ['SDD', 'SDP'], + 'SI' => ['SIT'], + 'SK' => ['SKK'], + 'SL' => ['SLL'], + 'SM' => ['ITL'], + 'SR' => ['SRG'], + 'SS' => ['SDG'], + 'ST' => ['STD'], + 'SU' => ['SUR'], + 'SX' => ['ANG'], + 'SZ' => ['SZL'], + 'TJ' => ['RUR', 'TJR'], + 'TL' => ['IDR', 'TPE'], + 'TM' => ['RUR', 'TMM'], + 'TR' => ['TRL', 'TRY'], + 'UA' => ['UAK'], + 'UG' => ['UGS', 'UGW'], + 'US' => ['USS'], + 'UY' => ['UYN', 'UYP'], + 'UZ' => ['RUR'], + 'VA' => ['ITL'], + 'VE' => ['VEB', 'VEF'], + 'VN' => ['VNC'], + 'YD' => ['YDD'], + 'YT' => ['FRF'], + 'YU' => ['YUD', 'YUM', 'YUN'], + 'ZA' => ['ZAL'], + 'ZM' => ['ZMK'], + 'ZR' => ['ZRN', 'ZRZ'], + 'ZW' => ['ZWC', 'ZWD', 'ZWN', 'ZWR', 'ZWL'], +]; diff --git a/data/country-to-currency.php b/data/country-to-currency.php index 09ed6183..00f36786 100644 --- a/data/country-to-currency.php +++ b/data/country-to-currency.php @@ -48,9 +48,9 @@ 'CN' => ['CNY'], 'CO' => ['COP'], 'CR' => ['CRC'], - 'CU' => ['CUP', 'CUC'], + 'CU' => ['CUP'], 'CV' => ['CVE'], - 'CW' => ['ANG'], + 'CW' => ['XCG'], 'CX' => ['AUD'], 'CY' => ['EUR'], 'CZ' => ['CZK'], @@ -206,7 +206,7 @@ 'SS' => ['SSP'], 'ST' => ['STN'], 'SV' => ['SVC', 'USD'], - 'SX' => ['ANG'], + 'SX' => ['XCG'], 'SY' => ['SYP'], 'SZ' => ['SZL'], 'TC' => ['USD'], @@ -244,5 +244,5 @@ 'YT' => ['EUR'], 'ZA' => ['ZAR'], 'ZM' => ['ZMW'], - 'ZW' => ['ZWG'] + 'ZW' => ['ZWG'], ]; diff --git a/data/iso-currencies.php b/data/iso-currencies.php index a9d0c7ac..858ae417 100644 --- a/data/iso-currencies.php +++ b/data/iso-currencies.php @@ -1,168 +1,2032 @@ ['AED', 784, 'UAE Dirham', 2], - 'AFN' => ['AFN', 971, 'Afghani', 2], - 'ALL' => ['ALL', 8, 'Lek', 2], - 'AMD' => ['AMD', 51, 'Armenian Dram', 2], - 'ANG' => ['ANG', 532, 'Netherlands Antillean Guilder', 2], - 'AOA' => ['AOA', 973, 'Kwanza', 2], - 'ARS' => ['ARS', 32, 'Argentine Peso', 2], - 'AUD' => ['AUD', 36, 'Australian Dollar', 2], - 'AWG' => ['AWG', 533, 'Aruban Florin', 2], - 'AZN' => ['AZN', 944, 'Azerbaijan Manat', 2], - 'BAM' => ['BAM', 977, 'Convertible Mark', 2], - 'BBD' => ['BBD', 52, 'Barbados Dollar', 2], - 'BDT' => ['BDT', 50, 'Taka', 2], - 'BGN' => ['BGN', 975, 'Bulgarian Lev', 2], - 'BHD' => ['BHD', 48, 'Bahraini Dinar', 3], - 'BIF' => ['BIF', 108, 'Burundi Franc', 0], - 'BMD' => ['BMD', 60, 'Bermudian Dollar', 2], - 'BND' => ['BND', 96, 'Brunei Dollar', 2], - 'BOB' => ['BOB', 68, 'Boliviano', 2], - 'BOV' => ['BOV', 984, 'Mvdol', 2], - 'BRL' => ['BRL', 986, 'Brazilian Real', 2], - 'BSD' => ['BSD', 44, 'Bahamian Dollar', 2], - 'BTN' => ['BTN', 64, 'Ngultrum', 2], - 'BWP' => ['BWP', 72, 'Pula', 2], - 'BYN' => ['BYN', 933, 'Belarusian Ruble', 2], - 'BZD' => ['BZD', 84, 'Belize Dollar', 2], - 'CAD' => ['CAD', 124, 'Canadian Dollar', 2], - 'CDF' => ['CDF', 976, 'Congolese Franc', 2], - 'CHE' => ['CHE', 947, 'WIR Euro', 2], - 'CHF' => ['CHF', 756, 'Swiss Franc', 2], - 'CHW' => ['CHW', 948, 'WIR Franc', 2], - 'CLF' => ['CLF', 990, 'Unidad de Fomento', 4], - 'CLP' => ['CLP', 152, 'Chilean Peso', 0], - 'CNY' => ['CNY', 156, 'Yuan Renminbi', 2], - 'COP' => ['COP', 170, 'Colombian Peso', 2], - 'COU' => ['COU', 970, 'Unidad de Valor Real', 2], - 'CRC' => ['CRC', 188, 'Costa Rican Colon', 2], - 'CUC' => ['CUC', 931, 'Peso Convertible', 2], - 'CUP' => ['CUP', 192, 'Cuban Peso', 2], - 'CVE' => ['CVE', 132, 'Cabo Verde Escudo', 2], - 'CZK' => ['CZK', 203, 'Czech Koruna', 2], - 'DJF' => ['DJF', 262, 'Djibouti Franc', 0], - 'DKK' => ['DKK', 208, 'Danish Krone', 2], - 'DOP' => ['DOP', 214, 'Dominican Peso', 2], - 'DZD' => ['DZD', 12, 'Algerian Dinar', 2], - 'EGP' => ['EGP', 818, 'Egyptian Pound', 2], - 'ERN' => ['ERN', 232, 'Nakfa', 2], - 'ETB' => ['ETB', 230, 'Ethiopian Birr', 2], - 'EUR' => ['EUR', 978, 'Euro', 2], - 'FJD' => ['FJD', 242, 'Fiji Dollar', 2], - 'FKP' => ['FKP', 238, 'Falkland Islands Pound', 2], - 'GBP' => ['GBP', 826, 'Pound Sterling', 2], - 'GEL' => ['GEL', 981, 'Lari', 2], - 'GHS' => ['GHS', 936, 'Ghana Cedi', 2], - 'GIP' => ['GIP', 292, 'Gibraltar Pound', 2], - 'GMD' => ['GMD', 270, 'Dalasi', 2], - 'GNF' => ['GNF', 324, 'Guinean Franc', 0], - 'GTQ' => ['GTQ', 320, 'Quetzal', 2], - 'GYD' => ['GYD', 328, 'Guyana Dollar', 2], - 'HKD' => ['HKD', 344, 'Hong Kong Dollar', 2], - 'HNL' => ['HNL', 340, 'Lempira', 2], - 'HTG' => ['HTG', 332, 'Gourde', 2], - 'HUF' => ['HUF', 348, 'Forint', 2], - 'IDR' => ['IDR', 360, 'Rupiah', 2], - 'ILS' => ['ILS', 376, 'New Israeli Sheqel', 2], - 'INR' => ['INR', 356, 'Indian Rupee', 2], - 'IQD' => ['IQD', 368, 'Iraqi Dinar', 3], - 'IRR' => ['IRR', 364, 'Iranian Rial', 2], - 'ISK' => ['ISK', 352, 'Iceland Krona', 0], - 'JMD' => ['JMD', 388, 'Jamaican Dollar', 2], - 'JOD' => ['JOD', 400, 'Jordanian Dinar', 3], - 'JPY' => ['JPY', 392, 'Yen', 0], - 'KES' => ['KES', 404, 'Kenyan Shilling', 2], - 'KGS' => ['KGS', 417, 'Som', 2], - 'KHR' => ['KHR', 116, 'Riel', 2], - 'KMF' => ['KMF', 174, 'Comorian Franc ', 0], - 'KPW' => ['KPW', 408, 'North Korean Won', 2], - 'KRW' => ['KRW', 410, 'Won', 0], - 'KWD' => ['KWD', 414, 'Kuwaiti Dinar', 3], - 'KYD' => ['KYD', 136, 'Cayman Islands Dollar', 2], - 'KZT' => ['KZT', 398, 'Tenge', 2], - 'LAK' => ['LAK', 418, 'Lao Kip', 2], - 'LBP' => ['LBP', 422, 'Lebanese Pound', 2], - 'LKR' => ['LKR', 144, 'Sri Lanka Rupee', 2], - 'LRD' => ['LRD', 430, 'Liberian Dollar', 2], - 'LSL' => ['LSL', 426, 'Loti', 2], - 'LYD' => ['LYD', 434, 'Libyan Dinar', 3], - 'MAD' => ['MAD', 504, 'Moroccan Dirham', 2], - 'MDL' => ['MDL', 498, 'Moldovan Leu', 2], - 'MGA' => ['MGA', 969, 'Malagasy Ariary', 2], - 'MKD' => ['MKD', 807, 'Denar', 2], - 'MMK' => ['MMK', 104, 'Kyat', 2], - 'MNT' => ['MNT', 496, 'Tugrik', 2], - 'MOP' => ['MOP', 446, 'Pataca', 2], - 'MRU' => ['MRU', 929, 'Ouguiya', 2], - 'MUR' => ['MUR', 480, 'Mauritius Rupee', 2], - 'MVR' => ['MVR', 462, 'Rufiyaa', 2], - 'MWK' => ['MWK', 454, 'Malawi Kwacha', 2], - 'MXN' => ['MXN', 484, 'Mexican Peso', 2], - 'MXV' => ['MXV', 979, 'Mexican Unidad de Inversion (UDI)', 2], - 'MYR' => ['MYR', 458, 'Malaysian Ringgit', 2], - 'MZN' => ['MZN', 943, 'Mozambique Metical', 2], - 'NAD' => ['NAD', 516, 'Namibia Dollar', 2], - 'NGN' => ['NGN', 566, 'Naira', 2], - 'NIO' => ['NIO', 558, 'Cordoba Oro', 2], - 'NOK' => ['NOK', 578, 'Norwegian Krone', 2], - 'NPR' => ['NPR', 524, 'Nepalese Rupee', 2], - 'NZD' => ['NZD', 554, 'New Zealand Dollar', 2], - 'OMR' => ['OMR', 512, 'Rial Omani', 3], - 'PAB' => ['PAB', 590, 'Balboa', 2], - 'PEN' => ['PEN', 604, 'Sol', 2], - 'PGK' => ['PGK', 598, 'Kina', 2], - 'PHP' => ['PHP', 608, 'Philippine Peso', 2], - 'PKR' => ['PKR', 586, 'Pakistan Rupee', 2], - 'PLN' => ['PLN', 985, 'Zloty', 2], - 'PYG' => ['PYG', 600, 'Guarani', 0], - 'QAR' => ['QAR', 634, 'Qatari Rial', 2], - 'RON' => ['RON', 946, 'Romanian Leu', 2], - 'RSD' => ['RSD', 941, 'Serbian Dinar', 2], - 'RUB' => ['RUB', 643, 'Russian Ruble', 2], - 'RWF' => ['RWF', 646, 'Rwanda Franc', 0], - 'SAR' => ['SAR', 682, 'Saudi Riyal', 2], - 'SBD' => ['SBD', 90, 'Solomon Islands Dollar', 2], - 'SCR' => ['SCR', 690, 'Seychelles Rupee', 2], - 'SDG' => ['SDG', 938, 'Sudanese Pound', 2], - 'SEK' => ['SEK', 752, 'Swedish Krona', 2], - 'SGD' => ['SGD', 702, 'Singapore Dollar', 2], - 'SHP' => ['SHP', 654, 'Saint Helena Pound', 2], - 'SLE' => ['SLE', 925, 'Leone', 2], - 'SOS' => ['SOS', 706, 'Somali Shilling', 2], - 'SRD' => ['SRD', 968, 'Surinam Dollar', 2], - 'SSP' => ['SSP', 728, 'South Sudanese Pound', 2], - 'STN' => ['STN', 930, 'Dobra', 2], - 'SVC' => ['SVC', 222, 'El Salvador Colon', 2], - 'SYP' => ['SYP', 760, 'Syrian Pound', 2], - 'SZL' => ['SZL', 748, 'Lilangeni', 2], - 'THB' => ['THB', 764, 'Baht', 2], - 'TJS' => ['TJS', 972, 'Somoni', 2], - 'TMT' => ['TMT', 934, 'Turkmenistan New Manat', 2], - 'TND' => ['TND', 788, 'Tunisian Dinar', 3], - 'TOP' => ['TOP', 776, 'Pa’anga', 2], - 'TRY' => ['TRY', 949, 'Turkish Lira', 2], - 'TTD' => ['TTD', 780, 'Trinidad and Tobago Dollar', 2], - 'TWD' => ['TWD', 901, 'New Taiwan Dollar', 2], - 'TZS' => ['TZS', 834, 'Tanzanian Shilling', 2], - 'UAH' => ['UAH', 980, 'Hryvnia', 2], - 'UGX' => ['UGX', 800, 'Uganda Shilling', 0], - 'USD' => ['USD', 840, 'US Dollar', 2], - 'USN' => ['USN', 997, 'US Dollar (Next day)', 2], - 'UYI' => ['UYI', 940, 'Uruguay Peso en Unidades Indexadas (UI)', 0], - 'UYU' => ['UYU', 858, 'Peso Uruguayo', 2], - 'UYW' => ['UYW', 927, 'Unidad Previsional', 4], - 'UZS' => ['UZS', 860, 'Uzbekistan Sum', 2], - 'VED' => ['VED', 926, 'Bolívar Soberano', 2], - 'VES' => ['VES', 928, 'Bolívar Soberano', 2], - 'VND' => ['VND', 704, 'Dong', 0], - 'VUV' => ['VUV', 548, 'Vatu', 0], - 'WST' => ['WST', 882, 'Tala', 2], - 'XAF' => ['XAF', 950, 'CFA Franc BEAC', 0], - 'XCD' => ['XCD', 951, 'East Caribbean Dollar', 2], - 'XOF' => ['XOF', 952, 'CFA Franc BCEAO', 0], - 'XPF' => ['XPF', 953, 'CFP Franc', 0], - 'YER' => ['YER', 886, 'Yemeni Rial', 2], - 'ZAR' => ['ZAR', 710, 'Rand', 2], - 'ZMW' => ['ZMW', 967, 'Zambian Kwacha', 2], - 'ZWG' => ['ZWG', 924, 'Zimbabwe Gold', 2] + 'ADP' => [ + 'ADP', + 20, + 'Andorran Peseta', + 0, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'AED' => [ + 'AED', + 784, + 'UAE Dirham', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'AFA' => [ + 'AFA', + 4, + 'Afghani', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'AFN' => [ + 'AFN', + 971, + 'Afghani', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'ALK' => [ + 'ALK', + 8, + 'Old Lek', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'ALL' => [ + 'ALL', + 8, + 'Lek', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'AMD' => [ + 'AMD', + 51, + 'Armenian Dram', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'ANG' => [ + 'ANG', + 532, + 'Netherlands Antillean Guilder', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'AOA' => [ + 'AOA', + 973, + 'Kwanza', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'AOK' => [ + 'AOK', + 24, + 'Kwanza', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'AON' => [ + 'AON', + 24, + 'New Kwanza', + 0, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'AOR' => [ + 'AOR', + 982, + 'Kwanza Reajustado', + 0, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'ARA' => [ + 'ARA', + 32, + 'Austral', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'ARP' => [ + 'ARP', + 32, + 'Peso Argentino', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'ARS' => [ + 'ARS', + 32, + 'Argentine Peso', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'ARY' => [ + 'ARY', + 32, + 'Peso', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'ATS' => [ + 'ATS', + 40, + 'Schilling', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'AUD' => [ + 'AUD', + 36, + 'Australian Dollar', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'AWG' => [ + 'AWG', + 533, + 'Aruban Florin', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'AYM' => [ + 'AYM', + 945, + 'Azerbaijan Manat', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'AZM' => [ + 'AZM', + 31, + 'Azerbaijanian Manat', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'AZN' => [ + 'AZN', + 944, + 'Azerbaijan Manat', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'BAD' => [ + 'BAD', + 70, + 'Dinar', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'BAM' => [ + 'BAM', + 977, + 'Convertible Mark', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'BBD' => [ + 'BBD', + 52, + 'Barbados Dollar', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'BDT' => [ + 'BDT', + 50, + 'Taka', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'BEC' => [ + 'BEC', + 993, + 'Convertible Franc', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'BEF' => [ + 'BEF', + 56, + 'Belgian Franc', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'BEL' => [ + 'BEL', + 992, + 'Financial Franc', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'BGJ' => [ + 'BGJ', + 100, + 'Lev A/52', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'BGK' => [ + 'BGK', + 100, + 'Lev A/62', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'BGL' => [ + 'BGL', + 100, + 'Lev', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'BGN' => [ + 'BGN', + 975, + 'Bulgarian Lev', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'BHD' => [ + 'BHD', + 48, + 'Bahraini Dinar', + 3, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'BIF' => [ + 'BIF', + 108, + 'Burundi Franc', + 0, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'BMD' => [ + 'BMD', + 60, + 'Bermudian Dollar', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'BND' => [ + 'BND', + 96, + 'Brunei Dollar', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'BOB' => [ + 'BOB', + 68, + 'Boliviano', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'BOP' => [ + 'BOP', + 68, + 'Peso boliviano', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'BOV' => [ + 'BOV', + 984, + 'Mvdol', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'BRB' => [ + 'BRB', + 76, + 'Cruzeiro', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'BRC' => [ + 'BRC', + 76, + 'Cruzado', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'BRE' => [ + 'BRE', + 76, + 'Cruzeiro', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'BRL' => [ + 'BRL', + 986, + 'Brazilian Real', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'BRN' => [ + 'BRN', + 76, + 'New Cruzado', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'BRR' => [ + 'BRR', + 987, + 'Cruzeiro Real', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'BSD' => [ + 'BSD', + 44, + 'Bahamian Dollar', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'BTN' => [ + 'BTN', + 64, + 'Ngultrum', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'BUK' => [ + 'BUK', + 104, + 'Kyat', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'BWP' => [ + 'BWP', + 72, + 'Pula', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'BYB' => [ + 'BYB', + 112, + 'Belarusian Ruble', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'BYN' => [ + 'BYN', + 933, + 'Belarusian Ruble', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'BYR' => [ + 'BYR', + 974, + 'Belarusian Ruble', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'BZD' => [ + 'BZD', + 84, + 'Belize Dollar', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'CAD' => [ + 'CAD', + 124, + 'Canadian Dollar', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'CDF' => [ + 'CDF', + 976, + 'Congolese Franc', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'CHC' => [ + 'CHC', + 948, + 'WIR Franc (for electronic)', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'CHE' => [ + 'CHE', + 947, + 'WIR Euro', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'CHF' => [ + 'CHF', + 756, + 'Swiss Franc', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'CHW' => [ + 'CHW', + 948, + 'WIR Franc', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'CLF' => [ + 'CLF', + 990, + 'Unidad de Fomento', + 4, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'CLP' => [ + 'CLP', + 152, + 'Chilean Peso', + 0, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'CNY' => [ + 'CNY', + 156, + 'Yuan Renminbi', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'COP' => [ + 'COP', + 170, + 'Colombian Peso', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'COU' => [ + 'COU', + 970, + 'Unidad de Valor Real', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'CRC' => [ + 'CRC', + 188, + 'Costa Rican Colon', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'CSD' => [ + 'CSD', + 891, + 'Serbian Dinar', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'CSJ' => [ + 'CSJ', + 203, + 'Krona A/53', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'CSK' => [ + 'CSK', + 200, + 'Koruna', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'CUC' => [ + 'CUC', + 931, + 'Peso Convertible', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'CUP' => [ + 'CUP', + 192, + 'Cuban Peso', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'CVE' => [ + 'CVE', + 132, + 'Cabo Verde Escudo', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'CYP' => [ + 'CYP', + 196, + 'Cyprus Pound', + 3, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'CZK' => [ + 'CZK', + 203, + 'Czech Koruna', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'DDM' => [ + 'DDM', + 278, + 'Mark der DDR', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'DEM' => [ + 'DEM', + 276, + 'Deutsche Mark', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'DJF' => [ + 'DJF', + 262, + 'Djibouti Franc', + 0, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'DKK' => [ + 'DKK', + 208, + 'Danish Krone', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'DOP' => [ + 'DOP', + 214, + 'Dominican Peso', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'DZD' => [ + 'DZD', + 12, + 'Algerian Dinar', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'ECS' => [ + 'ECS', + 218, + 'Sucre', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'ECV' => [ + 'ECV', + 983, + 'Unidad de Valor Constante (UVC)', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'EEK' => [ + 'EEK', + 233, + 'Kroon', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'EGP' => [ + 'EGP', + 818, + 'Egyptian Pound', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'ERN' => [ + 'ERN', + 232, + 'Nakfa', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'ESA' => [ + 'ESA', + 996, + 'Spanish Peseta', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'ESB' => [ + 'ESB', + 995, + '"A" Account (convertible Peseta Account)', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'ESP' => [ + 'ESP', + 724, + 'Spanish Peseta', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'ETB' => [ + 'ETB', + 230, + 'Ethiopian Birr', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'EUR' => [ + 'EUR', + 978, + 'Euro', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'FIM' => [ + 'FIM', + 246, + 'Markka', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'FJD' => [ + 'FJD', + 242, + 'Fiji Dollar', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'FKP' => [ + 'FKP', + 238, + 'Falkland Islands Pound', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'FRF' => [ + 'FRF', + 250, + 'French Franc', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'GBP' => [ + 'GBP', + 826, + 'Pound Sterling', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'GEK' => [ + 'GEK', + 268, + 'Georgian Coupon', + 0, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'GEL' => [ + 'GEL', + 981, + 'Lari', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'GHC' => [ + 'GHC', + 288, + 'Cedi', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'GHP' => [ + 'GHP', + 939, + 'Ghana Cedi', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'GHS' => [ + 'GHS', + 936, + 'Ghana Cedi', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'GIP' => [ + 'GIP', + 292, + 'Gibraltar Pound', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'GMD' => [ + 'GMD', + 270, + 'Dalasi', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'GNE' => [ + 'GNE', + 324, + 'Syli', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'GNF' => [ + 'GNF', + 324, + 'Guinean Franc', + 0, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'GNS' => [ + 'GNS', + 324, + 'Syli', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'GQE' => [ + 'GQE', + 226, + 'Ekwele', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'GRD' => [ + 'GRD', + 300, + 'Drachma', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'GTQ' => [ + 'GTQ', + 320, + 'Quetzal', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'GWE' => [ + 'GWE', + 624, + 'Guinea Escudo', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'GWP' => [ + 'GWP', + 624, + 'Guinea-Bissau Peso', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'GYD' => [ + 'GYD', + 328, + 'Guyana Dollar', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'HKD' => [ + 'HKD', + 344, + 'Hong Kong Dollar', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'HNL' => [ + 'HNL', + 340, + 'Lempira', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'HRD' => [ + 'HRD', + 191, + 'Croatian Dinar', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'HRK' => [ + 'HRK', + 191, + 'Croatian Kuna', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'HTG' => [ + 'HTG', + 332, + 'Gourde', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'HUF' => [ + 'HUF', + 348, + 'Forint', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'IDR' => [ + 'IDR', + 360, + 'Rupiah', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'IEP' => [ + 'IEP', + 372, + 'Irish Pound', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'ILP' => [ + 'ILP', + 376, + 'Pound', + 3, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'ILR' => [ + 'ILR', + 376, + 'Old Shekel', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'ILS' => [ + 'ILS', + 376, + 'New Israeli Sheqel', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'INR' => [ + 'INR', + 356, + 'Indian Rupee', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'IQD' => [ + 'IQD', + 368, + 'Iraqi Dinar', + 3, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'IRR' => [ + 'IRR', + 364, + 'Iranian Rial', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'ISJ' => [ + 'ISJ', + 352, + 'Old Krona', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'ISK' => [ + 'ISK', + 352, + 'Iceland Krona', + 0, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'ITL' => [ + 'ITL', + 380, + 'Italian Lira', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'JMD' => [ + 'JMD', + 388, + 'Jamaican Dollar', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'JOD' => [ + 'JOD', + 400, + 'Jordanian Dinar', + 3, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'JPY' => [ + 'JPY', + 392, + 'Yen', + 0, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'KES' => [ + 'KES', + 404, + 'Kenyan Shilling', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'KGS' => [ + 'KGS', + 417, + 'Som', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'KHR' => [ + 'KHR', + 116, + 'Riel', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'KMF' => [ + 'KMF', + 174, + 'Comorian Franc ', + 0, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'KPW' => [ + 'KPW', + 408, + 'North Korean Won', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'KRW' => [ + 'KRW', + 410, + 'Won', + 0, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'KWD' => [ + 'KWD', + 414, + 'Kuwaiti Dinar', + 3, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'KYD' => [ + 'KYD', + 136, + 'Cayman Islands Dollar', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'KZT' => [ + 'KZT', + 398, + 'Tenge', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'LAJ' => [ + 'LAJ', + 418, + 'Pathet Lao Kip', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'LAK' => [ + 'LAK', + 418, + 'Lao Kip', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'LBP' => [ + 'LBP', + 422, + 'Lebanese Pound', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'LKR' => [ + 'LKR', + 144, + 'Sri Lanka Rupee', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'LRD' => [ + 'LRD', + 430, + 'Liberian Dollar', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'LSL' => [ + 'LSL', + 426, + 'Loti', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'LSM' => [ + 'LSM', + 426, + 'Loti', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'LTL' => [ + 'LTL', + 440, + 'Lithuanian Litas', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'LTT' => [ + 'LTT', + 440, + 'Talonas', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'LUC' => [ + 'LUC', + 989, + 'Luxembourg Convertible Franc', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'LUF' => [ + 'LUF', + 442, + 'Luxembourg Franc', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'LUL' => [ + 'LUL', + 988, + 'Luxembourg Financial Franc', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'LVL' => [ + 'LVL', + 428, + 'Latvian Lats', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'LVR' => [ + 'LVR', + 428, + 'Latvian Ruble', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'LYD' => [ + 'LYD', + 434, + 'Libyan Dinar', + 3, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'MAD' => [ + 'MAD', + 504, + 'Moroccan Dirham', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'MDL' => [ + 'MDL', + 498, + 'Moldovan Leu', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'MGA' => [ + 'MGA', + 969, + 'Malagasy Ariary', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'MGF' => [ + 'MGF', + 450, + 'Malagasy Franc', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'MKD' => [ + 'MKD', + 807, + 'Denar', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'MLF' => [ + 'MLF', + 466, + 'Mali Franc', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'MMK' => [ + 'MMK', + 104, + 'Kyat', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'MNT' => [ + 'MNT', + 496, + 'Tugrik', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'MOP' => [ + 'MOP', + 446, + 'Pataca', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'MRO' => [ + 'MRO', + 478, + 'Ouguiya', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'MRU' => [ + 'MRU', + 929, + 'Ouguiya', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'MTL' => [ + 'MTL', + 470, + 'Maltese Lira', + 3, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'MTP' => [ + 'MTP', + 470, + 'Maltese Pound', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'MUR' => [ + 'MUR', + 480, + 'Mauritius Rupee', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'MVQ' => [ + 'MVQ', + 462, + 'Maldive Rupee', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'MVR' => [ + 'MVR', + 462, + 'Rufiyaa', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'MWK' => [ + 'MWK', + 454, + 'Malawi Kwacha', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'MXN' => [ + 'MXN', + 484, + 'Mexican Peso', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'MXP' => [ + 'MXP', + 484, + 'Mexican Peso', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'MXV' => [ + 'MXV', + 979, + 'Mexican Unidad de Inversion (UDI)', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'MYR' => [ + 'MYR', + 458, + 'Malaysian Ringgit', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'MZE' => [ + 'MZE', + 508, + 'Mozambique Escudo', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'MZM' => [ + 'MZM', + 508, + 'Mozambique Metical', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'MZN' => [ + 'MZN', + 943, + 'Mozambique Metical', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'NAD' => [ + 'NAD', + 516, + 'Namibia Dollar', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'NGN' => [ + 'NGN', + 566, + 'Naira', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'NIC' => [ + 'NIC', + 558, + 'Cordoba', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'NIO' => [ + 'NIO', + 558, + 'Cordoba Oro', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'NLG' => [ + 'NLG', + 528, + 'Netherlands Guilder', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'NOK' => [ + 'NOK', + 578, + 'Norwegian Krone', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'NPR' => [ + 'NPR', + 524, + 'Nepalese Rupee', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'NZD' => [ + 'NZD', + 554, + 'New Zealand Dollar', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'OMR' => [ + 'OMR', + 512, + 'Rial Omani', + 3, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'PAB' => [ + 'PAB', + 590, + 'Balboa', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'PEH' => [ + 'PEH', + 604, + 'Sol', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'PEI' => [ + 'PEI', + 604, + 'Inti', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'PEN' => [ + 'PEN', + 604, + 'Sol', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'PES' => [ + 'PES', + 604, + 'Sol', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'PGK' => [ + 'PGK', + 598, + 'Kina', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'PHP' => [ + 'PHP', + 608, + 'Philippine Peso', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'PKR' => [ + 'PKR', + 586, + 'Pakistan Rupee', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'PLN' => [ + 'PLN', + 985, + 'Zloty', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'PLZ' => [ + 'PLZ', + 616, + 'Zloty', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'PTE' => [ + 'PTE', + 620, + 'Portuguese Escudo', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'PYG' => [ + 'PYG', + 600, + 'Guarani', + 0, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'QAR' => [ + 'QAR', + 634, + 'Qatari Rial', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'RHD' => [ + 'RHD', + 716, + 'Rhodesian Dollar', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'ROK' => [ + 'ROK', + 642, + 'Leu A/52', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'ROL' => [ + 'ROL', + 642, + 'Old Leu', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'RON' => [ + 'RON', + 946, + 'Romanian Leu', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'RSD' => [ + 'RSD', + 941, + 'Serbian Dinar', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'RUB' => [ + 'RUB', + 643, + 'Russian Ruble', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'RUR' => [ + 'RUR', + 810, + 'Russian Ruble', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'RWF' => [ + 'RWF', + 646, + 'Rwanda Franc', + 0, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'SAR' => [ + 'SAR', + 682, + 'Saudi Riyal', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'SBD' => [ + 'SBD', + 90, + 'Solomon Islands Dollar', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'SCR' => [ + 'SCR', + 690, + 'Seychelles Rupee', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'SDD' => [ + 'SDD', + 736, + 'Sudanese Dinar', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'SDG' => [ + 'SDG', + 938, + 'Sudanese Pound', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'SDP' => [ + 'SDP', + 736, + 'Sudanese Pound', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'SEK' => [ + 'SEK', + 752, + 'Swedish Krona', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'SGD' => [ + 'SGD', + 702, + 'Singapore Dollar', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'SHP' => [ + 'SHP', + 654, + 'Saint Helena Pound', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'SIT' => [ + 'SIT', + 705, + 'Tolar', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'SKK' => [ + 'SKK', + 703, + 'Slovak Koruna', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'SLE' => [ + 'SLE', + 925, + 'Leone', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'SLL' => [ + 'SLL', + 694, + 'Leone', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'SOS' => [ + 'SOS', + 706, + 'Somali Shilling', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'SRD' => [ + 'SRD', + 968, + 'Surinam Dollar', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'SRG' => [ + 'SRG', + 740, + 'Surinam Guilder', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'SSP' => [ + 'SSP', + 728, + 'South Sudanese Pound', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'STD' => [ + 'STD', + 678, + 'Dobra', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'STN' => [ + 'STN', + 930, + 'Dobra', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'SUR' => [ + 'SUR', + 810, + 'Rouble', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'SVC' => [ + 'SVC', + 222, + 'El Salvador Colon', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'SYP' => [ + 'SYP', + 760, + 'Syrian Pound', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'SZL' => [ + 'SZL', + 748, + 'Lilangeni', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'THB' => [ + 'THB', + 764, + 'Baht', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'TJR' => [ + 'TJR', + 762, + 'Tajik Ruble', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'TJS' => [ + 'TJS', + 972, + 'Somoni', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'TMM' => [ + 'TMM', + 795, + 'Turkmenistan Manat', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'TMT' => [ + 'TMT', + 934, + 'Turkmenistan New Manat', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'TND' => [ + 'TND', + 788, + 'Tunisian Dinar', + 3, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'TOP' => [ + 'TOP', + 776, + 'Pa’anga', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'TPE' => [ + 'TPE', + 626, + 'Timor Escudo', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'TRL' => [ + 'TRL', + 792, + 'Old Turkish Lira', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'TRY' => [ + 'TRY', + 949, + 'Turkish Lira', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'TTD' => [ + 'TTD', + 780, + 'Trinidad and Tobago Dollar', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'TWD' => [ + 'TWD', + 901, + 'New Taiwan Dollar', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'TZS' => [ + 'TZS', + 834, + 'Tanzanian Shilling', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'UAH' => [ + 'UAH', + 980, + 'Hryvnia', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'UAK' => [ + 'UAK', + 804, + 'Karbovanet', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'UGS' => [ + 'UGS', + 800, + 'Uganda Shilling', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'UGW' => [ + 'UGW', + 800, + 'Old Shilling', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'UGX' => [ + 'UGX', + 800, + 'Uganda Shilling', + 0, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'USD' => [ + 'USD', + 840, + 'US Dollar', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'USN' => [ + 'USN', + 997, + 'US Dollar (Next day)', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'USS' => [ + 'USS', + 998, + 'US Dollar (Same day)', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'UYI' => [ + 'UYI', + 940, + 'Uruguay Peso en Unidades Indexadas (UI)', + 0, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'UYN' => [ + 'UYN', + 858, + 'Old Uruguay Peso', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'UYP' => [ + 'UYP', + 858, + 'Uruguayan Peso', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'UYU' => [ + 'UYU', + 858, + 'Peso Uruguayo', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'UYW' => [ + 'UYW', + 927, + 'Unidad Previsional', + 4, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'UZS' => [ + 'UZS', + 860, + 'Uzbekistan Sum', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'VEB' => [ + 'VEB', + 862, + 'Bolivar', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'VED' => [ + 'VED', + 926, + 'Bolívar Soberano', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'VEF' => [ + 'VEF', + 937, + 'Bolivar Fuerte', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'VES' => [ + 'VES', + 928, + 'Bolívar Soberano', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'VNC' => [ + 'VNC', + 704, + 'Old Dong', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'VND' => [ + 'VND', + 704, + 'Dong', + 0, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'VUV' => [ + 'VUV', + 548, + 'Vatu', + 0, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'WST' => [ + 'WST', + 882, + 'Tala', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'XAD' => [ + 'XAD', + 396, + 'Arab Accounting Dinar', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'XAF' => [ + 'XAF', + 950, + 'CFA Franc BEAC', + 0, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'XCD' => [ + 'XCD', + 951, + 'East Caribbean Dollar', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'XCG' => [ + 'XCG', + 532, + 'Caribbean Guilder', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'XOF' => [ + 'XOF', + 952, + 'CFA Franc BCEAO', + 0, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'XPF' => [ + 'XPF', + 953, + 'CFP Franc', + 0, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'YDD' => [ + 'YDD', + 720, + 'Yemeni Dinar', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'YER' => [ + 'YER', + 886, + 'Yemeni Rial', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'YUD' => [ + 'YUD', + 890, + 'New Yugoslavian Dinar', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'YUM' => [ + 'YUM', + 891, + 'New Dinar', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'YUN' => [ + 'YUN', + 890, + 'Yugoslavian Dinar', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'ZAL' => [ + 'ZAL', + 991, + 'Financial Rand', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'ZAR' => [ + 'ZAR', + 710, + 'Rand', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'ZMK' => [ + 'ZMK', + 894, + 'Zambian Kwacha', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'ZMW' => [ + 'ZMW', + 967, + 'Zambian Kwacha', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'ZRN' => [ + 'ZRN', + 180, + 'New Zaire', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'ZRZ' => [ + 'ZRZ', + 180, + 'Zaire', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'ZWC' => [ + 'ZWC', + 716, + 'Rhodesian Dollar', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'ZWD' => [ + 'ZWD', + 716, + 'Zimbabwe Dollar (old)', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'ZWG' => [ + 'ZWG', + 924, + 'Zimbabwe Gold', + 2, + Brick\Money\CurrencyType::IsoCurrent, + ], + 'ZWL' => [ + 'ZWL', + 932, + 'Zimbabwe Dollar', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'ZWN' => [ + 'ZWN', + 942, + 'Zimbabwe Dollar (new)', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], + 'ZWR' => [ + 'ZWR', + 935, + 'Zimbabwe Dollar', + 2, + Brick\Money\CurrencyType::IsoHistorical, + ], ]; diff --git a/data/numeric-to-currency.php b/data/numeric-to-currency.php index 25a4498c..189a2e02 100644 --- a/data/numeric-to-currency.php +++ b/data/numeric-to-currency.php @@ -1,22 +1,32 @@ 'AFA', 8 => 'ALL', 12 => 'DZD', + 20 => 'ADP', + 24 => 'AOK', + 31 => 'AZM', 32 => 'ARS', 36 => 'AUD', + 40 => 'ATS', 44 => 'BSD', 48 => 'BHD', 50 => 'BDT', 51 => 'AMD', 52 => 'BBD', + 56 => 'BEF', 60 => 'BMD', 64 => 'BTN', 68 => 'BOB', + 70 => 'BAD', 72 => 'BWP', + 76 => 'BRB', 84 => 'BZD', 90 => 'SBD', 96 => 'BND', + 100 => 'BGJ', 104 => 'MMK', 108 => 'BIF', + 112 => 'BYB', 116 => 'KHR', 124 => 'CAD', 132 => 'CVE', @@ -26,19 +36,33 @@ 156 => 'CNY', 170 => 'COP', 174 => 'KMF', + 180 => 'ZRN', 188 => 'CRC', + 191 => 'HRD', 192 => 'CUP', + 196 => 'CYP', + 200 => 'CSK', 203 => 'CZK', 208 => 'DKK', 214 => 'DOP', + 218 => 'ECS', 222 => 'SVC', + 226 => 'GQE', 230 => 'ETB', 232 => 'ERN', + 233 => 'EEK', 238 => 'FKP', 242 => 'FJD', + 246 => 'FIM', + 250 => 'FRF', 262 => 'DJF', + 268 => 'GEK', 270 => 'GMD', + 276 => 'DEM', + 278 => 'DDM', + 288 => 'GHC', 292 => 'GIP', + 300 => 'GRD', 320 => 'GTQ', 324 => 'GNF', 328 => 'GYD', @@ -51,9 +75,12 @@ 360 => 'IDR', 364 => 'IRR', 368 => 'IQD', + 372 => 'IEP', 376 => 'ILS', + 380 => 'ITL', 388 => 'JMD', 392 => 'JPY', + 396 => 'XAD', 398 => 'KZT', 400 => 'JOD', 404 => 'KES', @@ -64,21 +91,30 @@ 418 => 'LAK', 422 => 'LBP', 426 => 'LSL', + 428 => 'LVL', 430 => 'LRD', 434 => 'LYD', + 440 => 'LTL', + 442 => 'LUF', 446 => 'MOP', + 450 => 'MGF', 454 => 'MWK', 458 => 'MYR', 462 => 'MVR', + 466 => 'MLF', + 470 => 'MTL', + 478 => 'MRO', 480 => 'MUR', 484 => 'MXN', 496 => 'MNT', 498 => 'MDL', 504 => 'MAD', + 508 => 'MZE', 512 => 'OMR', 516 => 'NAD', 524 => 'NPR', - 532 => 'ANG', + 528 => 'NLG', + 532 => 'XCG', 533 => 'AWG', 548 => 'VUV', 554 => 'NZD', @@ -91,36 +127,59 @@ 600 => 'PYG', 604 => 'PEN', 608 => 'PHP', + 616 => 'PLZ', + 620 => 'PTE', + 624 => 'GWE', + 626 => 'TPE', 634 => 'QAR', + 642 => 'ROK', 643 => 'RUB', 646 => 'RWF', 654 => 'SHP', + 678 => 'STD', 682 => 'SAR', 690 => 'SCR', + 694 => 'SLL', 702 => 'SGD', + 703 => 'SKK', 704 => 'VND', + 705 => 'SIT', 706 => 'SOS', 710 => 'ZAR', + 716 => 'RHD', + 720 => 'YDD', + 724 => 'ESP', 728 => 'SSP', + 736 => 'SDD', + 740 => 'SRG', 748 => 'SZL', 752 => 'SEK', 756 => 'CHF', 760 => 'SYP', + 762 => 'TJR', 764 => 'THB', 776 => 'TOP', 780 => 'TTD', 784 => 'AED', 788 => 'TND', + 792 => 'TRL', + 795 => 'TMM', 800 => 'UGX', + 804 => 'UAK', 807 => 'MKD', + 810 => 'RUR', 818 => 'EGP', 826 => 'GBP', 834 => 'TZS', 840 => 'USD', 858 => 'UYU', 860 => 'UZS', + 862 => 'VEB', 882 => 'WST', 886 => 'YER', + 890 => 'YUD', + 891 => 'CSD', + 894 => 'ZMK', 901 => 'TWD', 924 => 'ZWG', 925 => 'SLE', @@ -130,14 +189,20 @@ 929 => 'MRU', 930 => 'STN', 931 => 'CUC', + 932 => 'ZWL', 933 => 'BYN', 934 => 'TMT', + 935 => 'ZWR', 936 => 'GHS', + 937 => 'VEF', 938 => 'SDG', + 939 => 'GHP', 940 => 'UYI', 941 => 'RSD', + 942 => 'ZWN', 943 => 'MZN', 944 => 'AZN', + 945 => 'AYM', 946 => 'RON', 947 => 'CHE', 948 => 'CHW', @@ -153,6 +218,7 @@ 971 => 'AFN', 972 => 'TJS', 973 => 'AOA', + 974 => 'BYR', 975 => 'BGN', 976 => 'CDF', 977 => 'BAM', @@ -160,9 +226,20 @@ 979 => 'MXV', 980 => 'UAH', 981 => 'GEL', + 982 => 'AOR', + 983 => 'ECV', 984 => 'BOV', 985 => 'PLN', 986 => 'BRL', + 987 => 'BRR', + 988 => 'LUL', + 989 => 'LUC', 990 => 'CLF', - 997 => 'USN' + 991 => 'ZAL', + 992 => 'BEL', + 993 => 'BEC', + 995 => 'ESB', + 996 => 'ESA', + 997 => 'USN', + 998 => 'USS', ]; diff --git a/import-currencies.php b/import-currencies.php index 99f61ab2..b57a69b8 100644 --- a/import-currencies.php +++ b/import-currencies.php @@ -9,10 +9,9 @@ declare(strict_types=1); +use Brick\Money\CurrencyType; use Brick\VarExporter\VarExporter; -use const PHP_EOL; - require __DIR__ . '/vendor/autoload.php'; /** @@ -32,6 +31,7 @@ 'ANGUILLA' => 'AI', 'ANTARCTICA' => 'AQ', 'ANTIGUA AND BARBUDA' => 'AG', + 'ARAB MONETARY FUND' => null, 'ARGENTINA' => 'AR', 'ARMENIA' => 'AM', 'ARUBA' => 'AW', @@ -274,91 +274,361 @@ 'ZIMBABWE' => 'ZW', ]; -$data = file_get_contents('https://www.six-group.com/dam/download/financial-information/data-center/iso-currrency/lists/list-one.xml'); +/** + * List of additional historical names of countries. + * Countries have ceased to exist or changed their official names. + */ +$historicalCountryCodes = [ + 'BOLIVIA' => 'BQ', + 'BURMA' => 'BU', + 'CZECHOSLOVAKIA' => 'CS', + 'FRENCH SOUTHERN TERRITORIES' => 'FQ', + 'GERMAN DEMOCRATIC REPUBLIC' => 'DD', + 'HOLY SEE (VATICAN CITY STATE)' => 'VA', + 'LAO' => 'LA', + 'MOLDOVA, REPUBLIC OF' => 'MD', + 'NETHERLANDS' => 'NL', + 'NETHERLANDS ANTILLES' => 'AN', + 'RUSSIAN FEDERATION' => 'RU', + 'SAINT MARTIN' => 'MF', + 'SAINT-BARTHÉLEMY' => 'BL', + 'SERBIA AND MONTENEGRO' => 'CS', + 'SOUTHERN RHODESIA' => 'RH', + 'SUDAN' => 'SD', + 'SWAZILAND' => 'SZ', + 'TURKEY' => 'TR', + 'UNION OF SOVIET SOCIALIST REPUBLICS' => 'SU', + 'UNITED STATES' => 'US', + 'VENEZUELA' => 'VE', + 'VIETNAM' => 'VN', + 'YEMEN, DEMOCRATIC' => 'YD', + 'YUGOSLAVIA' => 'YU', + 'ZAIRE' => 'ZR', +]; -$document = new DOMDocument(); -$success = $document->loadXML($data); +/** + * Minor units of historical currencies are not listed within list-three file. They have to be reconstructed manually from additional sources. + * This list has to be up to date, otherwise import will fail. Use null for undefined minor units. + * + * @var array $historicalMinorUnits + */ +$historicalMinorUnits = [ + 'ADP' => 0, + 'AFA' => 2, + 'ALK' => 2, + 'ANG' => 2, + 'AOK' => 2, + 'AON' => 0, + 'AOR' => 0, + 'ARA' => 2, + 'ARP' => 2, + 'ARY' => 2, + 'ATS' => 2, + 'AYM' => 2, + 'AZM' => 2, + 'BAD' => 2, + 'BEC' => 2, + 'BEF' => 2, + 'BEL' => 2, + 'BGJ' => 2, + 'BGK' => 2, + 'BGL' => 2, + 'BOP' => 2, + 'BRB' => 2, + 'BRC' => 2, + 'BRE' => 2, + 'BRN' => 2, + 'BRR' => 2, + 'BUK' => 2, + 'BYB' => 2, + 'BYR' => 2, + 'CHC' => 2, + 'CSD' => 2, + 'CSJ' => 2, + 'CSK' => 2, + 'CUC' => 2, + 'CYP' => 3, + 'DDM' => 2, + 'DEM' => 2, + 'ECS' => 2, + 'ECV' => 2, + 'EEK' => 2, + 'ESA' => 2, + 'ESB' => 2, + 'ESP' => 2, + 'EUR' => 2, + 'FIM' => 2, + 'FRF' => 2, + 'GEK' => 0, + 'GHC' => 2, + 'GHP' => 2, + 'GNE' => 2, + 'GNS' => 2, + 'GQE' => 2, + 'GRD' => 2, + 'GWE' => 2, + 'GWP' => 2, + 'HRD' => 2, + 'HRK' => 2, + 'IDR' => 2, + 'IEP' => 2, + 'ILP' => 3, + 'ILR' => 2, + 'ISJ' => 2, + 'ITL' => 2, + 'LAJ' => 2, + 'LSM' => 2, + 'LTL' => 2, + 'LTT' => 2, + 'LUC' => 2, + 'LUF' => 2, + 'LUL' => 2, + 'LVL' => 2, + 'LVR' => 2, + 'MGF' => 2, + 'MLF' => 2, + 'MRO' => 2, + 'MTL' => 3, + 'MTP' => 2, + 'MVQ' => 2, + 'MWK' => 2, + 'MXP' => 2, + 'MZE' => 2, + 'MZM' => 2, + 'NIC' => 2, + 'NLG' => 2, + 'PEH' => 2, + 'PEI' => 2, + 'PEN' => 2, + 'PES' => 2, + 'PLZ' => 2, + 'PTE' => 2, + 'RHD' => 2, + 'ROK' => 2, + 'ROL' => 2, + 'RON' => 2, + 'RUR' => 2, + 'SDD' => 2, + 'SDG' => 2, + 'SDP' => 2, + 'SIT' => 2, + 'SKK' => 2, + 'SLL' => 2, + 'SRG' => 2, + 'STD' => 2, + 'SUR' => 2, + 'SZL' => 2, + 'TJR' => 2, + 'TMM' => 2, + 'TPE' => 2, + 'TRL' => 2, + 'TRY' => 2, + 'UAK' => 2, + 'UGS' => 2, + 'UGW' => 2, + 'USS' => 2, + 'UYN' => 2, + 'UYP' => 2, + 'VEB' => 2, + 'VEF' => 2, + 'VNC' => 2, + 'XEU' => null, + 'XFO' => null, + 'XFU' => null, + 'XRE' => null, + 'YDD' => 2, + 'YUD' => 2, + 'YUM' => 2, + 'YUN' => 2, + 'ZAL' => 2, + 'ZMK' => 2, + 'ZRN' => 2, + 'ZRZ' => 2, + 'ZWC' => 2, + 'ZWD' => 2, + 'ZWL' => 2, + 'ZWN' => 2, + 'ZWR' => 2, +]; -if (! $success) { - echo "Failed to load XML file.\n"; - exit(1); -} +$currentCurrencyDatafile = file_get_contents('https://www.six-group.com/dam/download/financial-information/data-center/iso-currrency/lists/list-one.xml'); +$historicalCurrencyDatafile = file_get_contents('https://www.six-group.com/dam/download/financial-information/data-center/iso-currrency/lists/list-three.xml'); -$countries = $document->getElementsByTagName('CcyNtry'); $currencies = []; - $numericToCurrency = []; -$countryToCurrency = []; +$countryToCurrencyCurrent = []; +$countryToCurrencyHistorical = []; $countryNamesFound = []; -foreach ($countries as $country) { - /** @var DOMElement $country */ - $countryName = getDomElementString($country, 'CtryNm'); - $currencyName = getDomElementString($country, 'CcyNm'); - $currencyCode = getDomElementString($country, 'Ccy'); - $numericCode = getDomElementString($country, 'CcyNbr'); - $minorUnits = getDomElementString($country, 'CcyMnrUnts'); +$processCurrentDatafile = function ($file) use ($countryCodes, $historicalCountryCodes, &$currencies, &$numericToCurrency, &$countryNamesFound, &$countryToCurrencyCurrent): void { + $countryToCurrencyCurrent = []; + + $document = new DOMDocument(); + $success = $document->loadXML($file); + + if (! $success) { + echo "Failed to load XML file.\n"; + exit(1); + } + + $countries = $document->getElementsByTagName('CcyNtry'); + foreach ($countries as $country) { + /** @var DOMElement $country */ + $countryName = getDomElementString($country, 'CtryNm'); + $currencyName = getDomElementString($country, 'CcyNm'); + $currencyCode = getDomElementString($country, 'Ccy'); + $numericCode = getDomElementString($country, 'CcyNbr'); + $minorUnits = getDomElementString($country, 'CcyMnrUnts'); + + $countryNamesFound[$countryName] = true; - $countryNamesFound[$countryName] = true; + $isFund = $country->getElementsByTagName('CcyNm')->item(0)->getAttribute('IsFund') === 'true'; + + if ($currencyName === null || $currencyCode === null && $numericCode === null && $minorUnits == null) { + continue; + } - $isFund = $country->getElementsByTagName('CcyNm')->item(0)->getAttribute('IsFund') === 'true'; + if ($minorUnits === 'N.A.') { + continue; + } + + if (! array_key_exists($countryName, $countryCodes)) { + throw new RuntimeException('No country code found for ' . $countryName); + } - if ($currencyName === null || $currencyCode === null && $numericCode === null && $minorUnits == null) { - continue; + $countryCode = $countryCodes[$countryName]; + + if ($countryCode !== null) { + if (! $isFund) { + $countryToCurrencyCurrent[$countryCode][] = $currencyCode; + } + } + + $currencyName = checkCurrencyName($currencyName); + $currencyCode = checkCurrencyCode($currencyCode); + $numericCode = checkNumericCode($numericCode); + $minorUnits = checkMinorUnits($minorUnits); + + $value = [$currencyCode, $numericCode, $currencyName, $minorUnits, CurrencyType::IsoCurrent]; + + if (isset($currencies[$currencyCode])) { + if ($currencies[$currencyCode] !== $value) { + throw new RuntimeException('Inconsistent values found for currency code ' . $currencyCode); + } + } else { + $currencies[$currencyCode] = $value; + $numericToCurrency[$numericCode] = $currencyCode; + } } - if ($minorUnits === 'N.A.') { - continue; + foreach ($countryCodes as $countryName => $countryCode) { + if (! isset($countryNamesFound[$countryName])) { + echo 'Warning: ' . $countryName . ' not found in current ISO file.', PHP_EOL; + } } +}; + +$processHistoricDatafile = function ($file) use ($countryCodes, $historicalCountryCodes, $historicalMinorUnits, &$currencies, &$numericToCurrency, &$countryNamesFound, &$countryToCurrencyHistorical): void { + $document = new DOMDocument(); + $success = $document->loadXML($file); - if (! array_key_exists($countryName, $countryCodes)) { - throw new RuntimeException('No country code found for ' . $countryName); + if (! $success) { + echo "Failed to load XML file.\n"; + exit(1); } - $countryCode = $countryCodes[$countryName]; + $countries = $document->getElementsByTagName('HstrcCcyNtry'); - if ($countryCode !== null) { - if (! $isFund) { - $countryToCurrency[$countryCode][] = $currencyCode; + foreach ($countries as $country) { + /** @var DOMElement $country */ + $countryName = getDomElementString($country, 'CtryNm'); + $currencyName = getDomElementString($country, 'CcyNm'); + $currencyCode = getDomElementString($country, 'Ccy'); + $numericCode = getDomElementString($country, 'CcyNbr'); + + if (! array_key_exists($currencyCode, $historicalMinorUnits)) { + throw new RuntimeException('Missing minor unit definition for currency ' . $currencyCode); } - } + $minorUnits = $historicalMinorUnits[$currencyCode]; - $currencyName = checkCurrencyName($currencyName); - $currencyCode = checkCurrencyCode($currencyCode); - $numericCode = checkNumericCode($numericCode); - $minorUnits = checkMinorUnits($minorUnits); + $countryNamesFound[$countryName] = true; - $value = [$currencyCode, $numericCode, $currencyName, $minorUnits]; + $isFund = $country->getElementsByTagName('CcyNm')->item(0)->getAttribute('IsFund') === 'true'; - if (isset($currencies[$currencyCode])) { - if ($currencies[$currencyCode] !== $value) { - throw new RuntimeException('Inconsistent values found for currency code ' . $currencyCode); + if ($currencyName === null || $currencyCode === null && $numericCode === null && $minorUnits == null) { + continue; + } + + if ($minorUnits === 'N.A.' || $minorUnits === null) { + continue; + } + + // Historical data are messy + $countryName = str_replace([' ', ' '], ['', ' '], $countryName); + + if (! array_key_exists($countryName, $countryCodes) && ! array_key_exists($countryName, $historicalCountryCodes)) { + throw new RuntimeException('No country code found for ' . $countryName); + } + + $countryCode = $countryCodes[$countryName] ?? $historicalCountryCodes[$countryName]; + + if ($countryCode !== null) { + if (! $isFund) { + if (! in_array($currencyCode, $countryToCurrencyHistorical[$countryCode] ?? [], true)) { + $countryToCurrencyHistorical[$countryCode][] = $currencyCode; + } + } + } + + $currencyName = checkCurrencyName($currencyName); + $currencyCode = checkCurrencyCode($currencyCode); + $numericCode = checkNumericCode($numericCode); + $minorUnits = checkMinorUnits($minorUnits); + + $value = [$currencyCode, $numericCode, $currencyName, $minorUnits, CurrencyType::IsoHistorical]; + + if (! isset($currencies[$currencyCode])) { + $currencies[$currencyCode] = $value; + } + if (! isset($numericToCurrency[$numericCode])) { + $numericToCurrency[$numericCode] = $currencyCode; } - } else { - $currencies[$currencyCode] = $value; - $numericToCurrency[$numericCode] = $currencyCode; } -} -foreach ($countryCodes as $countryName => $countryCode) { - if (! isset($countryNamesFound[$countryName])) { - echo 'Warning: ' . $countryName . ' not found in ISO file.', PHP_EOL; + foreach ($countryCodes as $countryName => $countryCode) { + if (! isset($countryNamesFound[$countryName])) { + echo 'Warning: ' . $countryName . ' not found in current ISO file.', PHP_EOL; + } } -} +}; + +$processCurrentDatafile($currentCurrencyDatafile); +$processHistoricDatafile($historicalCurrencyDatafile); ksort($currencies); ksort($numericToCurrency); -ksort($countryToCurrency); +ksort($countryToCurrencyCurrent); +ksort($countryToCurrencyHistorical); exportToFile(__DIR__ . '/data/iso-currencies.php', $currencies); exportToFile(__DIR__ . '/data/numeric-to-currency.php', $numericToCurrency); -exportToFile(__DIR__ . '/data/country-to-currency.php', $countryToCurrency); +exportToFile(__DIR__ . '/data/country-to-currency.php', $countryToCurrencyCurrent); +exportToFile(__DIR__ . '/data/country-to-currency-historical.php', $countryToCurrencyHistorical); -printf('Exported %d currencies in %d countries.' . PHP_EOL, count($currencies), count($countryToCurrency)); +$currentCurrenciesCount = count(array_filter($currencies, fn ($currency) => ! $currency[4])); +$historicalCurrenciesCount = count(array_filter($currencies, fn ($currency) => $currency[4])); + +printf( + 'Exported %d current currencies and %d historical currencies in %d existing countries and %d historic countries.' . PHP_EOL, + $currentCurrenciesCount, + $historicalCurrenciesCount, + count($countryToCurrencyCurrent), + count($countryToCurrencyHistorical), +); function exportToFile(string $file, array $data): void { - $data = 'numericCode = $numericCode; $this->name = $name; $this->defaultFractionDigits = $defaultFractionDigits; + $this->currencyType = $currencyType; } /** @@ -96,6 +107,23 @@ public static function ofCountry(string $countryCode): Currency return ISOCurrencyProvider::getInstance()->getCurrencyForCountry($countryCode); } + /** + * Returns a Currency instance matching the given ISO currency code. + * + * Note: Numeric codes often mirror the ISO 3166-1 numeric code of the issuing + * country/territory, so they may outlive a particular currency and be kept/reused + * across currency changes. The resolved Currency therefore depends on the ISO 4217 + * dataset version and may change after an update in a minor version. + * + * @param int $currencyCode The numeric ISO 4217 currency code. + * + * @throws UnknownCurrencyException If an unknown currency code is given. + */ + public static function ofNumericCode(int $currencyCode): Currency + { + return ISOCurrencyProvider::getInstance()->getCurrencyByNumericCode($currencyCode); + } + /** * Returns the currency code. * @@ -156,6 +184,17 @@ public function is(Currency|string|int $currency): bool || ($this->numericCode !== 0 && $this->numericCode === (int) $currency); } + /** + * Returns the type of this currency. + * + * For ISO currencies, this will be either IsoCurrent (in use) or IsoHistorical (withdrawn). + * For application-defined currencies, the type is Custom. + */ + public function getCurrencyType(): CurrencyType + { + return $this->currencyType; + } + final public function jsonSerialize(): string { return $this->currencyCode; diff --git a/src/CurrencyType.php b/src/CurrencyType.php new file mode 100644 index 00000000..ffe56adc --- /dev/null +++ b/src/CurrencyType.php @@ -0,0 +1,12 @@ + + * @var array */ private readonly array $currencyData; @@ -33,14 +34,24 @@ final class ISOCurrencyProvider */ private ?array $numericToCurrency = null; + /** + * An associative array of country code to current currency codes. + * + * This property is set on-demand, as soon as required. + * + * @var array>|null + */ + private ?array $countryToCurrencyCurrent = null; + /** * An associative array of country code to currency codes. + * Contains only historical currencies. The countries may no longer exist. * * This property is set on-demand, as soon as required. * * @var array>|null */ - private ?array $countryToCurrency = null; + private ?array $countryToCurrencyHistorical = null; /** * The Currency instances. @@ -90,15 +101,9 @@ public static function getInstance(): ISOCurrencyProvider public function getCurrency(string|int $currencyCode): Currency { if (is_int($currencyCode)) { - if ($this->numericToCurrency === null) { - $this->numericToCurrency = require __DIR__ . '/../data/numeric-to-currency.php'; - } + trigger_deprecation('brick/money', '0.11.0', 'Calling "%s()" with integer argument is deprecated, call getCurrentCurrencyByNumericCode() instead.', __METHOD__); - if (isset($this->numericToCurrency[$currencyCode])) { - return $this->getCurrency($this->numericToCurrency[$currencyCode]); - } - - throw UnknownCurrencyException::unknownCurrency($currencyCode); + return $this->getCurrencyByNumericCode($currencyCode); } if (isset($this->currencies[$currencyCode])) { @@ -114,6 +119,33 @@ public function getCurrency(string|int $currencyCode): Currency return $this->currencies[$currencyCode] = $currency; } + /** + * Returns a Currency instance matching the given ISO currency code. + * + * Note: Numeric codes often mirror the ISO 3166-1 numeric code of the issuing + * country/territory, so they may outlive a particular currency and be kept/reused + * across currency changes. The resolved Currency therefore depends on the ISO 4217 + * dataset version and may change after an update in a minor version. + * + * @param int $currencyCode The numeric ISO 4217 currency code. + * + * @return Currency The currency. + * + * @throws UnknownCurrencyException If the currency code is not known. + */ + public function getCurrencyByNumericCode(int $currencyCode): Currency + { + if ($this->numericToCurrency === null) { + $this->numericToCurrency = require __DIR__ . '/../data/numeric-to-currency.php'; + } + + if (isset($this->numericToCurrency[$currencyCode])) { + return $this->getCurrency($this->numericToCurrency[$currencyCode]); + } + + throw UnknownCurrencyException::unknownCurrency($currencyCode); + } + /** * Returns all the available currencies. * @@ -137,7 +169,7 @@ public function getAvailableCurrencies(): array } /** - * Returns the currency for the given ISO country code. + * Returns the current currency for the given ISO country code. * * @param string $countryCode The 2-letter ISO 3166-1 country code. * @@ -145,7 +177,7 @@ public function getAvailableCurrencies(): array */ public function getCurrencyForCountry(string $countryCode): Currency { - $currencies = $this->getCurrenciesForCountry($countryCode); + $currencies = $this->getCurrentCurrenciesForCountry($countryCode); $count = count($currencies); @@ -171,20 +203,64 @@ public function getCurrencyForCountry(string $countryCode): Currency * * If the country code is not known, or if the country has no official currency, an empty array is returned. * + * @deprecated Use getCurrentCurrenciesForCountry() instead. + * * @param string $countryCode The 2-letter ISO 3166-1 country code. * * @return Currency[] */ public function getCurrenciesForCountry(string $countryCode): array { - if ($this->countryToCurrency === null) { - $this->countryToCurrency = require __DIR__ . '/../data/country-to-currency.php'; + trigger_deprecation('brick/money', '0.11.0', 'Calling "%s()" is deprecated, call getCurrentCurrenciesForCountry() instead.', __METHOD__); + + return $this->getCurrentCurrenciesForCountry($countryCode); + } + + /** + * Returns the current currencies for the given ISO country code. + * + * If the country code is not known, or if the country has no official currency, an empty array is returned. + * + * @param string $countryCode The 2-letter ISO 3166-1 country code. + * + * @return Currency[] + */ + public function getCurrentCurrenciesForCountry(string $countryCode): array + { + if ($this->countryToCurrencyCurrent === null) { + $this->countryToCurrencyCurrent = require __DIR__ . '/../data/country-to-currency.php'; + } + + $result = []; + + if (isset($this->countryToCurrencyCurrent[$countryCode])) { + foreach ($this->countryToCurrencyCurrent[$countryCode] as $currencyCode) { + $result[] = $this->getCurrency($currencyCode); + } + } + + return $result; + } + + /** + * Returns the historical currencies for the given ISO country code. + * + * If the country code is not known, or if the country has no official currency, an empty array is returned. + * + * @param string $countryCode The 2-letter ISO 3166-1 country code. + * + * @return Currency[] + */ + public function getHistoricalCurrenciesForCountry(string $countryCode): array + { + if ($this->countryToCurrencyHistorical === null) { + $this->countryToCurrencyHistorical = require __DIR__ . '/../data/country-to-currency-historical.php'; } $result = []; - if (isset($this->countryToCurrency[$countryCode])) { - foreach ($this->countryToCurrency[$countryCode] as $currencyCode) { + if (isset($this->countryToCurrencyHistorical[$countryCode])) { + foreach ($this->countryToCurrencyHistorical[$countryCode] as $currencyCode) { $result[] = $this->getCurrency($currencyCode); } } diff --git a/tests/AbstractTestCase.php b/tests/AbstractTestCase.php index e23a8822..622578e7 100644 --- a/tests/AbstractTestCase.php +++ b/tests/AbstractTestCase.php @@ -9,6 +9,7 @@ use Brick\Math\BigRational; use Brick\Money\Context; use Brick\Money\Currency; +use Brick\Money\CurrencyType; use Brick\Money\Money; use Brick\Money\MoneyBag; use Brick\Money\RationalMoney; @@ -96,12 +97,13 @@ final protected function assertRationalMoneyEquals(string $expected, RationalMon self::assertSame($expected, (string) $actual); } - final protected function assertCurrencyEquals(string $currencyCode, int $numericCode, string $name, int $defaultFractionDigits, Currency $currency): void + final protected function assertCurrencyEquals(string $currencyCode, int $numericCode, string $name, int $defaultFractionDigits, CurrencyType $currencyType, Currency $currency): void { self::assertSame($currencyCode, $currency->getCurrencyCode()); self::assertSame($numericCode, $currency->getNumericCode()); self::assertSame($name, $currency->getName()); self::assertSame($defaultFractionDigits, $currency->getDefaultFractionDigits()); + self::assertSame($currencyType, $currency->getCurrencyType()); } final protected function isExceptionClass(mixed $value): bool diff --git a/tests/CurrencyTest.php b/tests/CurrencyTest.php index 6c803a68..3ef99eab 100644 --- a/tests/CurrencyTest.php +++ b/tests/CurrencyTest.php @@ -5,6 +5,7 @@ namespace Brick\Money\Tests; use Brick\Money\Currency; +use Brick\Money\CurrencyType; use Brick\Money\Exception\UnknownCurrencyException; use InvalidArgumentException; use PHPUnit\Framework\Attributes\DataProvider; @@ -16,30 +17,25 @@ */ class CurrencyTest extends AbstractTestCase { - /** - * @param string $currencyCode The currency code. - * @param int $numericCode The currency's numeric code. - * @param int $fractionDigits The currency's default fraction digits. - * @param string $name The currency's name. - */ #[DataProvider('providerOf')] - public function testOf(string $currencyCode, int $numericCode, int $fractionDigits, string $name): void + public function testOf(string $currencyCode, int $numericCode, int $fractionDigits, string $name, CurrencyType $currencyType): void { $currency = Currency::of($currencyCode); - $this->assertCurrencyEquals($currencyCode, $numericCode, $name, $fractionDigits, $currency); + $this->assertCurrencyEquals($currencyCode, $numericCode, $name, $fractionDigits, $currencyType, $currency); $currency = Currency::of($numericCode); - $this->assertCurrencyEquals($currencyCode, $numericCode, $name, $fractionDigits, $currency); + $this->assertCurrencyEquals($currencyCode, $numericCode, $name, $fractionDigits, $currencyType, $currency); } public static function providerOf(): array { return [ - ['USD', 840, 2, 'US Dollar'], - ['EUR', 978, 2, 'Euro'], - ['GBP', 826, 2, 'Pound Sterling'], - ['JPY', 392, 0, 'Yen'], - ['DZD', 12, 2, 'Algerian Dinar'], + ['USD', 840, 2, 'US Dollar', CurrencyType::IsoCurrent], + ['EUR', 978, 2, 'Euro', CurrencyType::IsoCurrent], + ['GBP', 826, 2, 'Pound Sterling', CurrencyType::IsoCurrent], + ['JPY', 392, 0, 'Yen', CurrencyType::IsoCurrent], + ['DZD', 12, 2, 'Algerian Dinar', CurrencyType::IsoCurrent], + ['SKK', 703, 2, 'Slovak Koruna', CurrencyType::IsoHistorical], ]; } @@ -61,7 +57,7 @@ public static function providerOfUnknownCurrencyCode(): array public function testConstructor(): void { $bitCoin = new Currency('BTC', -1, 'BitCoin', 8); - $this->assertCurrencyEquals('BTC', -1, 'BitCoin', 8, $bitCoin); + $this->assertCurrencyEquals('BTC', -1, 'BitCoin', 8, CurrencyType::Custom, $bitCoin); } public function testOfReturnsSameInstance(): void @@ -96,11 +92,35 @@ public static function providerOfCountry(): array ['IT', 'EUR'], ['US', 'USD'], ['AQ', UnknownCurrencyException::class], // no currency - ['CU', UnknownCurrencyException::class], // 2 currencies + ['BT', UnknownCurrencyException::class], // 2 currencies ['XX', UnknownCurrencyException::class], // unknown ]; } + #[DataProvider('providerOfNumericCode')] + public function testOfNumericCode(int $currencyCode, string $expected): void + { + if ($this->isExceptionClass($expected)) { + $this->expectException($expected); + } + + $actual = Currency::ofNumericCode($currencyCode); + + if (! $this->isExceptionClass($expected)) { + self::assertInstanceOf(Currency::class, $actual); + self::assertSame($expected, $actual->getCurrencyCode()); + } + } + + public static function providerOfNumericCode(): array + { + return [ + [203, 'CZK'], + [840, 'USD'], + [1, UnknownCurrencyException::class], // unknown currency + ]; + } + public function testCreateWithNegativeFractionDigits(): void { $this->expectException(InvalidArgumentException::class); diff --git a/tests/ISOCurrencyProviderTest.php b/tests/ISOCurrencyProviderTest.php index 4c4b7dec..89bcfcc6 100644 --- a/tests/ISOCurrencyProviderTest.php +++ b/tests/ISOCurrencyProviderTest.php @@ -5,6 +5,7 @@ namespace Brick\Money\Tests; use Brick\Money\Currency; +use Brick\Money\CurrencyType; use Brick\Money\Exception\UnknownCurrencyException; use Brick\Money\ISOCurrencyProvider; use PHPUnit\Framework\Attributes\DataProvider; @@ -31,30 +32,35 @@ public static function setUpBeforeClass(): void } #[DataProvider('providerGetCurrency')] - public function testGetCurrency(string $currencyCode, int $numericCode, string $name, int $defaultFractionDigits): void + public function testGetCurrency(string $currencyCode, int $numericCode, string $name, int $defaultFractionDigits, CurrencyType $currencyType): void { $provider = ISOCurrencyProvider::getInstance(); $currency = $provider->getCurrency($currencyCode); - $this->assertCurrencyEquals($currencyCode, $numericCode, $name, $defaultFractionDigits, $currency); + $this->assertCurrencyEquals($currencyCode, $numericCode, $name, $defaultFractionDigits, $currencyType, $currency); - $currency = $provider->getCurrency($numericCode); - $this->assertCurrencyEquals($currencyCode, $numericCode, $name, $defaultFractionDigits, $currency); + // Library does not support numeric currency codes of historical currencies + if ($currencyType === CurrencyType::IsoCurrent) { + $currency = $provider->getCurrencyByNumericCode($numericCode); + $this->assertCurrencyEquals($currencyCode, $numericCode, $name, $defaultFractionDigits, $currencyType, $currency); + } } public static function providerGetCurrency(): array { return [ - ['EUR', 978, 'Euro', 2], - ['GBP', 826, 'Pound Sterling', 2], - ['USD', 840, 'US Dollar', 2], - ['CAD', 124, 'Canadian Dollar', 2], - ['AUD', 36, 'Australian Dollar', 2], - ['NZD', 554, 'New Zealand Dollar', 2], - ['JPY', 392, 'Yen', 0], - ['TND', 788, 'Tunisian Dinar', 3], - ['DZD', 12, 'Algerian Dinar', 2], - ['ALL', 8, 'Lek', 2], + ['EUR', 978, 'Euro', 2, CurrencyType::IsoCurrent], + ['GBP', 826, 'Pound Sterling', 2, CurrencyType::IsoCurrent], + ['USD', 840, 'US Dollar', 2, CurrencyType::IsoCurrent], + ['CAD', 124, 'Canadian Dollar', 2, CurrencyType::IsoCurrent], + ['AUD', 36, 'Australian Dollar', 2, CurrencyType::IsoCurrent], + ['NZD', 554, 'New Zealand Dollar', 2, CurrencyType::IsoCurrent], + ['JPY', 392, 'Yen', 0, CurrencyType::IsoCurrent], + ['TND', 788, 'Tunisian Dinar', 3, CurrencyType::IsoCurrent], + ['DZD', 12, 'Algerian Dinar', 2, CurrencyType::IsoCurrent], + ['ALL', 8, 'Lek', 2, CurrencyType::IsoCurrent], + ['ITL', 380, 'Italian Lira', 2, CurrencyType::IsoHistorical], + ['VNC', 704, 'Old Dong', 2, CurrencyType::IsoHistorical], ]; } @@ -70,6 +76,8 @@ public static function providerUnknownCurrency(): array return [ ['XXX'], [-1], + ['XFO'], + ['XEU'], ]; } @@ -93,4 +101,45 @@ public function testGetAvailableCurrencies(): void self::assertSame($gbp, $availableCurrencies['GBP']); self::assertSame($usd, $availableCurrencies['USD']); } + + #[DataProvider('providerHistoricalCurrencies')] + public function testGetHistoricalCurrencies(string $countryCode, array $currencyCodes): void + { + $provider = ISOCurrencyProvider::getInstance(); + + $currencies = $provider->getHistoricalCurrenciesForCountry($countryCode); + + self::assertSameSize($currencyCodes, $currencies); + + $retrievedCurrencyCodes = []; + foreach ($currencies as $currency) { + self::assertInstanceOf(Currency::class, $currency); + $retrievedCurrencyCodes[] = $currency->getCurrencyCode(); + } + + self::assertEquals($currencyCodes, $retrievedCurrencyCodes); + } + + public static function providerHistoricalCurrencies(): array + { + return [ + ['ES', ['ESA', 'ESB', 'ESP']], + ['AD', ['ADP', 'ESP', 'FRF']], + ['IT', ['ITL']], + ]; + } + + public function testNoHistoricalCurrencyPresentInCurrentCurrencies(): void + { + $provider = ISOCurrencyProvider::getInstance(); + + $currencies = $provider->getCurrentCurrenciesForCountry('PA'); + self::assertCount(2, $currencies); + + $retrievedCurrencies = []; + foreach ($currencies as $currency) { + $retrievedCurrencies[] = $currency->getCurrencyCode(); + } + self::assertEquals(['PAB', 'USD'], $retrievedCurrencies); + } } From da5280cd51d706b6bba94d2995008a1993b5c680 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1=C5=A1=20Neumaier?= Date: Mon, 5 Jan 2026 18:20:05 +0100 Subject: [PATCH 2/5] Update Bulgaria --- data/country-to-currency-historical.php | 2 +- data/country-to-currency.php | 2 +- data/iso-currencies.php | 2 +- import-currencies.php | 1 + 4 files changed, 4 insertions(+), 3 deletions(-) diff --git a/data/country-to-currency-historical.php b/data/country-to-currency-historical.php index 2b75c699..f858e9c3 100644 --- a/data/country-to-currency-historical.php +++ b/data/country-to-currency-historical.php @@ -11,7 +11,7 @@ 'AZ' => ['AYM', 'AZM', 'RUR'], 'BA' => ['BAD'], 'BE' => ['BEC', 'BEF', 'BEL'], - 'BG' => ['BGJ', 'BGK', 'BGL'], + 'BG' => ['BGJ', 'BGK', 'BGL', 'BGN'], 'BL' => ['FRF'], 'BQ' => ['BOP'], 'BR' => ['BRB', 'BRC', 'BRE', 'BRN', 'BRR'], diff --git a/data/country-to-currency.php b/data/country-to-currency.php index 00f36786..2845fa1b 100644 --- a/data/country-to-currency.php +++ b/data/country-to-currency.php @@ -19,7 +19,7 @@ 'BD' => ['BDT'], 'BE' => ['EUR'], 'BF' => ['XOF'], - 'BG' => ['BGN'], + 'BG' => ['EUR'], 'BH' => ['BHD'], 'BI' => ['BIF'], 'BJ' => ['XOF'], diff --git a/data/iso-currencies.php b/data/iso-currencies.php index 858ae417..66e04d85 100644 --- a/data/iso-currencies.php +++ b/data/iso-currencies.php @@ -228,7 +228,7 @@ 975, 'Bulgarian Lev', 2, - Brick\Money\CurrencyType::IsoCurrent, + Brick\Money\CurrencyType::IsoHistorical, ], 'BHD' => [ 'BHD', diff --git a/import-currencies.php b/import-currencies.php index b57a69b8..98a892f0 100644 --- a/import-currencies.php +++ b/import-currencies.php @@ -332,6 +332,7 @@ 'BEL' => 2, 'BGJ' => 2, 'BGK' => 2, + 'BGN' => 2, 'BGL' => 2, 'BOP' => 2, 'BRB' => 2, From 6548e887d8f2eee56054b0707e59637dd3892b22 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1=C5=A1=20Neumaier?= Date: Tue, 6 Jan 2026 12:59:29 +0100 Subject: [PATCH 3/5] Remove currency codes still in use from historical files --- data/country-to-currency-historical.php | 8 +++----- import-currencies.php | 12 +++++++++--- src/ISOCurrencyProvider.php | 2 +- 3 files changed, 13 insertions(+), 9 deletions(-) diff --git a/data/country-to-currency-historical.php b/data/country-to-currency-historical.php index f858e9c3..13477eb3 100644 --- a/data/country-to-currency-historical.php +++ b/data/country-to-currency-historical.php @@ -59,18 +59,17 @@ 'MR' => ['MRO'], 'MT' => ['MTL', 'MTP'], 'MV' => ['MVQ'], - 'MW' => ['MWK'], 'MX' => ['MXP'], 'MZ' => ['MZE', 'MZM'], 'NI' => ['NIC'], 'NL' => ['NLG'], - 'PE' => ['PEH', 'PEI', 'PEN', 'PES'], + 'PE' => ['PEH', 'PEI', 'PES'], 'PL' => ['PLZ'], 'PM' => ['FRF'], 'PT' => ['PTE'], 'RE' => ['FRF'], 'RH' => ['RHD'], - 'RO' => ['ROK', 'ROL', 'RON'], + 'RO' => ['ROK', 'ROL'], 'RU' => ['RUR'], 'SD' => ['SDD', 'SDP'], 'SI' => ['SIT'], @@ -82,11 +81,10 @@ 'ST' => ['STD'], 'SU' => ['SUR'], 'SX' => ['ANG'], - 'SZ' => ['SZL'], 'TJ' => ['RUR', 'TJR'], 'TL' => ['IDR', 'TPE'], 'TM' => ['RUR', 'TMM'], - 'TR' => ['TRL', 'TRY'], + 'TR' => ['TRL'], 'UA' => ['UAK'], 'UG' => ['UGS', 'UGW'], 'US' => ['USS'], diff --git a/import-currencies.php b/import-currencies.php index 98a892f0..84250a02 100644 --- a/import-currencies.php +++ b/import-currencies.php @@ -529,7 +529,7 @@ } }; -$processHistoricDatafile = function ($file) use ($countryCodes, $historicalCountryCodes, $historicalMinorUnits, &$currencies, &$numericToCurrency, &$countryNamesFound, &$countryToCurrencyHistorical): void { +$processHistoricDatafile = function ($file) use ($countryCodes, $historicalCountryCodes, $historicalMinorUnits, &$currencies, &$numericToCurrency, &$countryNamesFound, &$countryToCurrencyHistorical, &$countryToCurrencyCurrent): void { $document = new DOMDocument(); $success = $document->loadXML($file); @@ -575,6 +575,12 @@ if ($countryCode !== null) { if (! $isFund) { + // Renaming a currency will cause it to be marked as withdrawn, while retaining its ISO code. Skip these records if the currency code is still in use in that country. + // Note: If there is a change of country, keep the record. + if (isset($countryToCurrencyCurrent[$countryCode]) && in_array($currencyCode, $countryToCurrencyCurrent[$countryCode], true)) { + continue; + } + if (! in_array($currencyCode, $countryToCurrencyHistorical[$countryCode] ?? [], true)) { $countryToCurrencyHistorical[$countryCode][] = $currencyCode; } @@ -616,8 +622,8 @@ exportToFile(__DIR__ . '/data/country-to-currency.php', $countryToCurrencyCurrent); exportToFile(__DIR__ . '/data/country-to-currency-historical.php', $countryToCurrencyHistorical); -$currentCurrenciesCount = count(array_filter($currencies, fn ($currency) => ! $currency[4])); -$historicalCurrenciesCount = count(array_filter($currencies, fn ($currency) => $currency[4])); +$currentCurrenciesCount = count(array_filter($currencies, fn ($currency) => $currency[4] === CurrencyType::IsoCurrent)); +$historicalCurrenciesCount = count(array_filter($currencies, fn ($currency) => $currency[4] === CurrencyType::IsoHistorical)); printf( 'Exported %d current currencies and %d historical currencies in %d existing countries and %d historic countries.' . PHP_EOL, diff --git a/src/ISOCurrencyProvider.php b/src/ISOCurrencyProvider.php index 18689656..2a8b85c7 100644 --- a/src/ISOCurrencyProvider.php +++ b/src/ISOCurrencyProvider.php @@ -101,7 +101,7 @@ public static function getInstance(): ISOCurrencyProvider public function getCurrency(string|int $currencyCode): Currency { if (is_int($currencyCode)) { - trigger_deprecation('brick/money', '0.11.0', 'Calling "%s()" with integer argument is deprecated, call getCurrentCurrencyByNumericCode() instead.', __METHOD__); + trigger_deprecation('brick/money', '0.11.0', 'Calling "%s()" with integer argument is deprecated, call getCurrencyByNumericCode() instead.', __METHOD__); return $this->getCurrencyByNumericCode($currencyCode); } From 6a2ad0efc212550624e4b2d8c6c1a3642d6146aa Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1=C5=A1=20Neumaier?= Date: Wed, 7 Jan 2026 09:36:43 +0100 Subject: [PATCH 4/5] Drop "current" from method signatures, add note instead --- src/Currency.php | 4 +++- src/ISOCurrencyProvider.php | 24 +++++------------------- tests/ISOCurrencyProviderTest.php | 2 +- 3 files changed, 9 insertions(+), 21 deletions(-) diff --git a/src/Currency.php b/src/Currency.php index b9faee0d..de3ca625 100644 --- a/src/Currency.php +++ b/src/Currency.php @@ -96,7 +96,9 @@ public static function of(string|int $currencyCode): Currency } /** - * Returns a Currency instance for the given ISO country code. + * Returns the current currency for the given ISO country code. + * + * Note: This value may change in minor releases, as countries may change their official currency. * * @param string $countryCode The 2-letter ISO 3166-1 country code. * diff --git a/src/ISOCurrencyProvider.php b/src/ISOCurrencyProvider.php index 2a8b85c7..ecc800ae 100644 --- a/src/ISOCurrencyProvider.php +++ b/src/ISOCurrencyProvider.php @@ -171,13 +171,15 @@ public function getAvailableCurrencies(): array /** * Returns the current currency for the given ISO country code. * + * Note: This value may change in minor releases, as countries may change their official currency. + * * @param string $countryCode The 2-letter ISO 3166-1 country code. * * @throws UnknownCurrencyException If the country code is not known, or the country has no single currency. */ public function getCurrencyForCountry(string $countryCode): Currency { - $currencies = $this->getCurrentCurrenciesForCountry($countryCode); + $currencies = $this->getCurrenciesForCountry($countryCode); $count = count($currencies); @@ -199,33 +201,17 @@ public function getCurrencyForCountry(string $countryCode): Currency } /** - * Returns the currencies for the given ISO country code. + * Returns the current currencies for the given ISO country code. * * If the country code is not known, or if the country has no official currency, an empty array is returned. * - * @deprecated Use getCurrentCurrenciesForCountry() instead. + * Note: This value may change in minor releases, as countries may change their official currencies. * * @param string $countryCode The 2-letter ISO 3166-1 country code. * * @return Currency[] */ public function getCurrenciesForCountry(string $countryCode): array - { - trigger_deprecation('brick/money', '0.11.0', 'Calling "%s()" is deprecated, call getCurrentCurrenciesForCountry() instead.', __METHOD__); - - return $this->getCurrentCurrenciesForCountry($countryCode); - } - - /** - * Returns the current currencies for the given ISO country code. - * - * If the country code is not known, or if the country has no official currency, an empty array is returned. - * - * @param string $countryCode The 2-letter ISO 3166-1 country code. - * - * @return Currency[] - */ - public function getCurrentCurrenciesForCountry(string $countryCode): array { if ($this->countryToCurrencyCurrent === null) { $this->countryToCurrencyCurrent = require __DIR__ . '/../data/country-to-currency.php'; diff --git a/tests/ISOCurrencyProviderTest.php b/tests/ISOCurrencyProviderTest.php index 89bcfcc6..3f9c5c4e 100644 --- a/tests/ISOCurrencyProviderTest.php +++ b/tests/ISOCurrencyProviderTest.php @@ -133,7 +133,7 @@ public function testNoHistoricalCurrencyPresentInCurrentCurrencies(): void { $provider = ISOCurrencyProvider::getInstance(); - $currencies = $provider->getCurrentCurrenciesForCountry('PA'); + $currencies = $provider->getCurrenciesForCountry('PA'); self::assertCount(2, $currencies); $retrievedCurrencies = []; From 57fdb3af628081002926952b20eaace5346f583e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1=C5=A1=20Neumaier?= Date: Wed, 7 Jan 2026 09:41:11 +0100 Subject: [PATCH 5/5] Improve deprecation notes to avoid trigger from inner code --- src/Currency.php | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/src/Currency.php b/src/Currency.php index de3ca625..badba51a 100644 --- a/src/Currency.php +++ b/src/Currency.php @@ -9,6 +9,9 @@ use JsonSerializable; use Stringable; +use function is_int; +use function trigger_deprecation; + /** * A currency. This class is immutable. */ @@ -92,6 +95,12 @@ public function __construct(string $currencyCode, int $numericCode, string $name */ public static function of(string|int $currencyCode): Currency { + if (is_int($currencyCode)) { + trigger_deprecation('brick/money', '0.11.0', 'Calling "%s()" with integer argument is deprecated, call ofNumericCode() instead.', __METHOD__); + + return self::ofNumericCode($currencyCode); + } + return ISOCurrencyProvider::getInstance()->getCurrency($currencyCode); }