money wrapper

MoneyPHP-обертка

На основе денежной обертки

Это обертка для денег.

Эта обертка:

1. Предоставьте помощника по работе с деньгами — money()
2. Предназначен для Laravel Framework, но может использоваться и вне Laravel Framework.
3. Обеспечьте общее использование, например:

• За удобочитаемость — 1,00 ринггитов, 345,00 ринггитов
• Для общего отображения - 1.00, 345.00
• Для машины (предназначенный формат для хранения в базе данных — целое число) — 100, 34500
• Конвертация фиксированного обменного курса — 1 доллар США > 3,87 ринггитов

Установка

1. Чтобы установить wujunze/money-wrapper в свой проект Laravel, просто запустите команду 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 , либо передать код страны Alpha 2 при вызове помощника money() .

 $ 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.