README

PHP 中处理货币的库，简单且轻量

适用于任何电商、金融科技或需要 💰 的任何应用程序。

要求

• PHP >= 8.2

安装

使用 composer 安装此包

composer require macmotp/currencies

此包是其他 2 个包的主要依赖

• macmotp/money;
• macmotp/locale;

用法

创建货币对象

use Macmotp\Currency;
use Macmotp\Currencies\Support\CurrencyCode;
use Macmotp\Currencies\Support\CurrencyName;

// All Currencies adopt ISO 4217 standard
$currencyCode = CurrencyCode::USD;

// Create the object
$currency = new Currency($currencyCode);

// You can also input the code as string:
$currency = new Currency('USD');

// Alternative methods:
$currency = Currency::make($currencyCode);
$currency = Currency::fromCode($currencyCode);

echo $currency->toArray();

// [
//    'name' => 'United States Dollar',
//    'code' => 'USD',
//    'symbol' => '$',
//    'flag' => 'us',
//    'format' => [
//       'show_code' => false,
//       'show_symbol' => true,
//       'show_space' => false,
//       'show_symbol_or_code_on_left' => true,
//       'show_decimals' => true,
//       'decimal_separator' => '.',
//       'thousands_separator' => ',',
//       'number_of_decimals' => 2,
//       'subunit_level' => 2,
//    ],
// ]

基本方法列表

• getName(): 返回名称；
• getCode(): 返回代码；
• getSymbol(): 返回符号；
• getFlag(): 返回标志（国家代码）；
• getFormat(): 返回货币格式；
• toArray(): 将对象转换为数组；

包中的货币列表

use Macmotp\Currency;

$list = Currency::all();
// This will return a Illuminate\Support\Collection

以下是实现的货币

• AED: 阿联酋迪拉姆
• AFN: 阿富汗尼
• ALL: 阿尔巴尼亚列克
• AMD: 亚美尼亚德拉姆
• ANG: 荷兰安的列斯盾
• AOA: 安哥拉宽扎
• ARS: 阿根廷比索
• AUD: 澳大利亚元
• AWG: 阿鲁巴弗罗林
• AZN: 阿塞拜疆马纳特
• BAM: 波斯尼亚和黑塞哥维那可转换马克
• BBD: 巴巴多斯元
• BDT: 孟加拉塔卡
• BGN: 保加利亚列弗
• BHD: 巴林第纳尔
• BIF: 布隆迪法郎
• BMD: 百慕大元
• BND: 文莱元
• BOB: 玻利维亚诺
• BRL: 巴西雷亚尔
• BSD: 巴哈马元
• BTC: 比特币
• BTN: 不丹努尔特鲁姆
• BWP: 博茨瓦纳普拉
• BYN: 白俄罗斯卢布
• BZD: 伯利兹元
• CAD: 加拿大元
• CDF: 刚果法郎
• CHF: 瑞士法郎
• CLP: 智利比索
• CNY: 中国元 - 人民币
• COP: 哥伦比亚比索
• CRC: 哥斯达黎加科朗
• CUP: 古巴比索
• CVE: 佛得角埃斯库多
• CZK: 捷克克朗
• DJF: 吉布提法郎
• DKK: 丹麦克朗
• DOP: 多米尼加比索
• DZD: 阿尔及利亚第纳尔
• EGP: 埃及镑
• ERN: 厄立特里亚纳克法
• ETB: 埃塞俄比亚比尔
• EUR: 欧元
• FJD: 斐济元
• FKP: 福克兰群岛镑
• GBP: 英镑
• GEL: 格鲁吉亚拉里
• GHS: 加纳塞地
• GIP: 直布罗陀镑
• GMD: 冈比亚达拉西
• GNF: 几内亚法郎
• GTQ: 危地马拉格查尔
• GYD: 圭亚那元
• HKD: 港元
• HNL: 洪都拉斯伦皮拉
• HTG: 海地古德
• HUF: 匈牙利福林
• IDR: 印尼盾
• ILS: 以色列新谢克尔
• INR: 印度卢比
• IQD: 伊拉克第纳尔
• IRR: 伊朗里亚尔
• ISK: 冰岛克朗
• JMD: 牙买加元
• JOD: 约旦第纳尔
• JPY: 日元
• KES: 肯尼亚先令
• KGS: 吉尔吉斯斯坦索姆
• KHR: 柬埔寨瑞尔
• KMF: 科摩罗法郎
• KPW: 朝鲜元
• KRW: 韩元
• KWD: 科威特第纳尔
• KYD: 开曼群岛元
• KZT: 哈萨克斯坦坚戈
• LAK: 老挝基普
• LBP: 黎巴嫩镑
• LKR: 斯里兰卡卢比
• LRD: 利比里亚元
• LSL: 莱索托洛蒂
• LYD: 利比亚第纳尔
• MAD: 摩洛哥迪拉姆
• MDL: 摩尔多瓦列伊
• MGA: 马达加斯加阿里亚里
• MKD: 马其顿第纳尔
• MMK: 缅甸元
• MNT: 蒙古图格里克
• MOP: 澳门元
• MRU: 毛里塔尼亚乌吉亚
• MUR: 毛里求斯卢比
• MVR: 马尔代夫拉菲亚
• MWK: 马拉维克瓦查
• MXN: 墨西哥比索
• MYR: 马来西亚林吉特
• MZN: 莫桑比克梅蒂卡尔
• NAD: 纳米比亚元
• NGN: 尼日利亚奈拉
• NIO: 尼加拉瓜科多巴
• NOK: 挪威克朗
• NPR: 尼泊尔卢比
• NZD: 新西兰元
• OMR: 阿曼里亚尔
• PAB: 巴拿马巴波亚
• PEN: 秘鲁索尔
• PGK: 巴布亚新几内亚基那
• PHP: 菲律宾比索
• PKR: 巴基斯坦卢比
• PLN: 波兰兹罗提
• PYG: 巴拉圭瓜拉尼
• QAR: 卡塔尔里亚尔
• RON: 罗马尼亚列伊
• RSD: 塞尔维亚第纳尔
• RUB: 俄罗斯卢布
• RWF: 卢旺达法郎
• SAR: 沙特里亚尔
• SBD: 所罗门群岛元
• SCR: 塞舌尔卢比
• SDG: 苏丹镑
• SEK: 瑞典克朗
• SGD: 新加坡元
• SHP: 圣赫勒拿镑
• SLE: 塞拉利昂利昂
• SOS: 索马里先令
• SRD: 苏里南元
• SSP: 南苏丹镑
• STN: 圣多美和普林西比多布拉
• SYP: 叙利亚镑
• SZL: 斯威士兰里兰吉尼
• THB: 泰铢
• TJS: 塔吉克斯坦索莫尼
• TMT: 土库曼斯坦马纳特
• TND: 突尼斯第纳尔
• TOP: 汤加潘加
• TRY: 土耳其里拉
• TTD: 特立尼达和多巴哥元
• TWD: 新台币
• TZS: 坦桑尼亚先令
• UAH: 乌克兰格里夫纳
• UGX: 乌干达先令
• USD: 美元
• UYU: 乌拉圭比索
• UZS: 乌兹别克斯坦苏姆
• VES: 委内瑞拉主权玻利瓦尔
• VND: 越南盾
• VUV: 瓦努阿图瓦图
• WST: 萨摩亚塔拉
• XAF: 中非金融合作法郎
• XCD: 东加勒比元
• XOF: 西非金融合作法郎
• XPF: 太平洋法郎
• YER: 也门里亚尔
• ZAR: 南非兰特
• ZMW: 赞比亚克瓦查
• ZWG: 津巴布韦金元

如需添加其他货币，请提交一个问题。

测试

composer test

变更日志

请参阅变更日志，了解最近的变化。

贡献

请参阅贡献指南以获取详细信息。

安全漏洞

请查阅我们的安全策略了解如何报告安全漏洞。

致谢

• Marco Gava

许可证

MIT许可证（MIT）。请参阅许可证文件获取更多信息。