money wrapper

MoneyPHP 包装器

基于金钱包装

这是 Money 的包装。

这个包装：

1. 提供一个理财帮手money()
2. 适用于 Laravel 框架，但也可以在 Laravel 框架之外使用。
3. 提供常见用法，例如：

• 为了人类可读性 - RM 1.00, RM 345.00
• 对于普通显示 - 1.00、345.00
• 对于机器（存储在数据库中的预期格式 - 整数） - 100, 34500
• 固定汇率转换 - 1 美元 > RM 3.87

安装

1. 为了在 Laravel 项目中安装wujunze/money-wrapper ，只需从终端运行composer require命令：

 $ composer require wujunze/money-wrapper

2. 然后在config/app.php中将以下内容添加到提供者数组中：

 wujunze  MoneyWrapper MoneyWrapperServiceProvider::class,

3. 在同一个config/app.php中，将以下内容添加到别名数组中：

 ' MoneyWrapper ' => wujunze  MoneyWrapper MoneyWrapperFacade::class,

4. 发布money wrapper配置：

 $ php artisan vendor:publish --tag=money-wrapper-config

您可能需要根据国家/地区添加更多货币详细信息。有关详细信息，请参阅下面的贡献部分。

用法

获取money wrapper实例

默认情况下，将使用 MYR、马来西亚林吉特货币。

您可以通过.env文件覆盖或在调用money()帮助程序时传递国家/地区 Alpha 2 代码。

 $ money = money (); // by default it will use MY
$ moneyUsd = money ( ' US ' ); // pass the country code - ISO Alpha 2

您可以在发布money wrapper配置文件并添加更多支持的货币后添加更多货币。

请参阅货币列表中的国家代码及其货币快速代码和符号。

获取资金格式

 echo money ()-> toHuman ( 100 ); // RM 1.00, useful for human readability
echo money ()-> toCommon ( 100 ); // 1.00
echo money ()-> toMachine ( ' 1.00 ' ); // 100, always store in database as integer. 

转换固定利率

 $ fixedExchange = [
    ' MYR ' => [
        ' USD ' => 3.87 ,
    ],
];
echo money ()-> convertFixedRate ( $ fixedExchange , 100 , ' USD ' )-> getAmount (); // 387

数据库中推荐使用的数据类型是大整数

贡献

根据以下资源更新可用的货币列表（ config/currency.php ）：

1. 使用国家/地区列表中定义的国家/地区 ISO Alpha 2 代码作为密钥。
2. 请参阅货币列表以了解可用货币。
3. 使用 www.xe.com 中规定的符号。

结构如下：

[
	' MYR ' => [
		' swift_code ' => ' MYR ' ,
		' symbol ' => ' RM '
	]
]

执照

该软件包是根据 MIT 许可证授权的开源软件。