v1.0.0.0

StocketBase

← Changes All versions

152 lines · 8.4 KB

<?php
declare(strict_types=1);
final class Currency
{
public const DEFAULT_CODE = 'USD';
private const ZERO_DECIMALS = ['BIF', 'CLP', 'DJF', 'GNF', 'ISK', 'JPY', 'KMF', 'KRW', 'PYG', 'RWF', 'UGX', 'VND', 'VUV', 'XAF', 'XOF', 'XPF'];
private const THREE_DECIMALS = ['BHD', 'IQD', 'JOD', 'KWD', 'LYD', 'OMR', 'TND'];
private const NAMES = [
'AED' => 'UAE Dirham', 'AFN' => 'Afghan Afghani', 'ALL' => 'Albanian Lek', 'AMD' => 'Armenian Dram',
'ANG' => 'Netherlands Antillean Guilder', 'AOA' => 'Angolan Kwanza', 'ARS' => 'Argentine Peso',
'AUD' => 'Australian Dollar', 'AWG' => 'Aruban Florin', 'AZN' => 'Azerbaijani Manat',
'BAM' => 'Bosnia-Herzegovina Convertible Mark', 'BBD' => 'Barbadian Dollar', 'BDT' => 'Bangladeshi Taka',
'BGN' => 'Bulgarian Lev', 'BHD' => 'Bahraini Dinar', 'BIF' => 'Burundian Franc', 'BMD' => 'Bermudian Dollar',
'BND' => 'Brunei Dollar', 'BOB' => 'Bolivian Boliviano', 'BRL' => 'Brazilian Real', 'BSD' => 'Bahamian Dollar',
'BTN' => 'Bhutanese Ngultrum', 'BWP' => 'Botswana Pula', 'BYN' => 'Belarusian Ruble', 'BZD' => 'Belize Dollar',
'CAD' => 'Canadian Dollar', 'CDF' => 'Congolese Franc', 'CHF' => 'Swiss Franc', 'CLP' => 'Chilean Peso',
'CNY' => 'Chinese Yuan', 'COP' => 'Colombian Peso', 'CRC' => 'Costa Rican Colón', 'CUP' => 'Cuban Peso',
'CVE' => 'Cape Verdean Escudo', 'CZK' => 'Czech Koruna', 'DJF' => 'Djiboutian Franc', 'DKK' => 'Danish Krone',
'DOP' => 'Dominican Peso', 'DZD' => 'Algerian Dinar', 'EGP' => 'Egyptian Pound', 'ERN' => 'Eritrean Nakfa',
'ETB' => 'Ethiopian Birr', 'EUR' => 'Euro', 'FJD' => 'Fijian Dollar', 'FKP' => 'Falkland Islands Pound',
'GBP' => 'British Pound', 'GEL' => 'Georgian Lari', 'GHS' => 'Ghanaian Cedi', 'GIP' => 'Gibraltar Pound',
'GMD' => 'Gambian Dalasi', 'GNF' => 'Guinean Franc', 'GTQ' => 'Guatemalan Quetzal', 'GYD' => 'Guyanese Dollar',
'HKD' => 'Hong Kong Dollar', 'HNL' => 'Honduran Lempira', 'HTG' => 'Haitian Gourde', 'HUF' => 'Hungarian Forint',
'IDR' => 'Indonesian Rupiah', 'ILS' => 'Israeli New Shekel', 'INR' => 'Indian Rupee', 'IQD' => 'Iraqi Dinar',
'IRR' => 'Iranian Rial', 'ISK' => 'Icelandic Króna', 'JMD' => 'Jamaican Dollar', 'JOD' => 'Jordanian Dinar',
'JPY' => 'Japanese Yen', 'KES' => 'Kenyan Shilling', 'KGS' => 'Kyrgyzstani Som', 'KHR' => 'Cambodian Riel',
'KMF' => 'Comorian Franc', 'KPW' => 'North Korean Won', 'KRW' => 'South Korean Won', 'KWD' => 'Kuwaiti Dinar',
'KYD' => 'Cayman Islands Dollar', 'KZT' => 'Kazakhstani Tenge', 'LAK' => 'Lao Kip', 'LBP' => 'Lebanese Pound',
'LKR' => 'Sri Lankan Rupee', 'LRD' => 'Liberian Dollar', 'LSL' => 'Lesotho Loti', 'LYD' => 'Libyan Dinar',
'MAD' => 'Moroccan Dirham', 'MDL' => 'Moldovan Leu', 'MGA' => 'Malagasy Ariary', 'MKD' => 'Macedonian Denar',
'MMK' => 'Myanmar Kyat', 'MNT' => 'Mongolian Tögrög', 'MOP' => 'Macanese Pataca', 'MRU' => 'Mauritanian Ouguiya',
'MUR' => 'Mauritian Rupee', 'MVR' => 'Maldivian Rufiyaa', 'MWK' => 'Malawian Kwacha', 'MXN' => 'Mexican Peso',
'MYR' => 'Malaysian Ringgit', 'MZN' => 'Mozambican Metical', 'NAD' => 'Namibian Dollar', 'NGN' => 'Nigerian Naira',
'NIO' => 'Nicaraguan Córdoba', 'NOK' => 'Norwegian Krone', 'NPR' => 'Nepalese Rupee', 'NZD' => 'New Zealand Dollar',
'OMR' => 'Omani Rial', 'PAB' => 'Panamanian Balboa', 'PEN' => 'Peruvian Sol', 'PGK' => 'Papua New Guinean Kina',
'PHP' => 'Philippine Peso', 'PKR' => 'Pakistani Rupee', 'PLN' => 'Polish Złoty', 'PYG' => 'Paraguayan Guaraní',
'QAR' => 'Qatari Riyal', 'RON' => 'Romanian Leu', 'RSD' => 'Serbian Dinar', 'RUB' => 'Russian Ruble',
'RWF' => 'Rwandan Franc', 'SAR' => 'Saudi Riyal', 'SBD' => 'Solomon Islands Dollar', 'SCR' => 'Seychellois Rupee',
'SDG' => 'Sudanese Pound', 'SEK' => 'Swedish Krona', 'SGD' => 'Singapore Dollar', 'SHP' => 'Saint Helena Pound',
'SLE' => 'Sierra Leonean Leone', 'SOS' => 'Somali Shilling', 'SRD' => 'Surinamese Dollar', 'SSP' => 'South Sudanese Pound',
'STN' => 'São Tomé and Príncipe Dobra', 'SVC' => 'Salvadoran Colón', 'SYP' => 'Syrian Pound', 'SZL' => 'Swazi Lilangeni',
'THB' => 'Thai Baht', 'TJS' => 'Tajikistani Somoni', 'TMT' => 'Turkmenistani Manat', 'TND' => 'Tunisian Dinar',
'TOP' => 'Tongan Paʻanga', 'TRY' => 'Turkish Lira', 'TTD' => 'Trinidad and Tobago Dollar', 'TWD' => 'New Taiwan Dollar',
'TZS' => 'Tanzanian Shilling', 'UAH' => 'Ukrainian Hryvnia', 'UGX' => 'Ugandan Shilling', 'USD' => 'US Dollar',
'UYU' => 'Uruguayan Peso', 'UZS' => 'Uzbekistani Som', 'VES' => 'Venezuelan Bolívar', 'VND' => 'Vietnamese Dong',
'VUV' => 'Vanuatu Vatu', 'WST' => 'Samoan Tala', 'XAF' => 'Central African CFA Franc', 'XCD' => 'East Caribbean Dollar',
'XOF' => 'West African CFA Franc', 'XPF' => 'CFP Franc', 'YER' => 'Yemeni Rial', 'ZAR' => 'South African Rand',
'ZMW' => 'Zambian Kwacha', 'ZWL' => 'Zimbabwean Dollar',
];
private const UNITS = [
'USD' => ['dollars', 'cents'], 'CAD' => ['dollars', 'cents'], 'AUD' => ['dollars', 'cents'], 'NZD' => ['dollars', 'cents'],
'HKD' => ['dollars', 'cents'], 'SGD' => ['dollars', 'cents'], 'EUR' => ['euros', 'cents'], 'PLN' => ['złote', 'grosze'],
'GBP' => ['pounds', 'pence'], 'CHF' => ['francs', 'rappen'], 'CZK' => ['koruny', 'haléře'], 'SEK' => ['kronor', 'öre'],
'NOK' => ['kroner', 'øre'], 'DKK' => ['kroner', 'øre'], 'HUF' => ['forints', 'fillér'], 'RON' => ['lei', 'bani'],
'BGN' => ['leva', 'stotinki'], 'UAH' => ['hryvnias', 'kopiykas'], 'TRY' => ['lira', 'kuruş'], 'INR' => ['rupees', 'paise'],
'CNY' => ['yuan', 'fen'], 'BRL' => ['reais', 'centavos'], 'MXN' => ['pesos', 'centavos'], 'RUB' => ['rubles', 'kopecks'],
'ZAR' => ['rand', 'cents'], 'ILS' => ['shekels', 'agorot'], 'JPY' => ['yen', ''], 'KRW' => ['won', ''],
];
public static function searchLabel(string $code): string
{
$name = self::NAMES[$code] ?? $code;
$plain = strtr($name, ['ł' => 'l', 'Ł' => 'L', 'ó' => 'o', 'í' => 'i', 'é' => 'e', 'ö' => 'o', 'ã' => 'a', 'ú' => 'u', 'ʻ' => '', 'ʼ' => '']);
return $plain === $name ? $name : $name . ' / ' . $plain;
}
public static function units(string $code): array
{
$code = self::normalize($code);
return self::UNITS[$code] ?? ['whole units', 'fraction'];
}
public static function clientMap(): array
{
$map = [];
foreach (self::NAMES as $code => $name) {
[$major, $minor] = self::units($code);
$map[$code] = ['d' => self::decimals($code), 'major' => $major, 'minor' => $minor];
}
return $map;
}
public static function toMinor(int $major, int $fraction, string $code): int
{
$decimals = self::decimals($code);
$scale = 10 ** $decimals;
$major = max(0, min(100000000, $major));
$fraction = $decimals === 0 ? 0 : max(0, min($scale - 1, $fraction));
return $major * $scale + $fraction;
}
public static function split(int $minorUnits, string $code): array
{
$scale = 10 ** self::decimals($code);
$minorUnits = max(0, $minorUnits);
return [intdiv($minorUnits, $scale), $minorUnits % $scale];
}
public static function all(): array
{
return self::NAMES;
}
public static function isValid(string $code): bool
{
return isset(self::NAMES[$code]);
}
public static function normalize(string $code): string
{
$code = strtoupper(trim($code));
return self::isValid($code) ? $code : self::DEFAULT_CODE;
}
public static function decimals(string $code): int
{
if (in_array($code, self::ZERO_DECIMALS, true)) {
return 0;
}
return in_array($code, self::THREE_DECIMALS, true) ? 3 : 2;
}
public static function format(int $minorUnits, string $code): string
{
$code = self::normalize($code);
$decimals = self::decimals($code);
$amount = $minorUnits / (10 ** $decimals);
if (class_exists('NumberFormatter')) {
$formatter = new NumberFormatter('en_US', NumberFormatter::CURRENCY);
$formatted = $formatter->formatCurrency($amount, $code);
if (is_string($formatted) && $formatted !== '') {
return $formatted;
}
}
return number_format($amount, $decimals, '.', ',') . ' ' . $code;
}
}