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 許可證授權的開源軟體。