money wrapper

MoneyPHP ラッパー

マネーラッパーをベースに

これは Money のラッパーです。

このラッパー:

1. Money ヘルパーを提供しますmoney()
2. Laravel Framework 向けですが、Laravel Framework の外部でも使用できます。
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構成ファイルを公開し、サポートされる通貨を追加した後、さらに通貨を追加できます。

通貨リストの国コードとその通貨のSwiftコードと記号を参照してください。

ゲットマネーフォーマット

 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

データベースで使用される推奨データ型は big integer です

貢献

次のリソースに基づいて利用可能な通貨リスト ( config/currency.php ) を更新します。

1. 国リストで定義されているように、キーの国 ISO Alpha 2 コードを使用します。
2. 利用可能な通貨については通貨リストを参照してください。
3. www.xe.com に記載されているシンボルを使用してください。

構造は次のようになります。

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

ライセンス

このパッケージは、MIT ライセンスに基づいてライセンス供与されたオープンソース ソフトウェアです。