money wrapper

Wrapper MoneyPHP

Baseie-se no invólucro de dinheiro

Este é um invólucro para dinheiro.

Este invólucro:

1. Forneça um ajudante de dinheiro - money()
2. Destinado ao Laravel Framework, mas também pode ser usado fora do Laravel Framework.
3. Fornece uso comum, como:

• Para legibilidade humana - RM 1,00, RM 345,00
• Para exibição comum - 1,00, 345,00
• Para Máquina (formato pretendido para armazenar no Banco de Dados - inteiro) - 100, 34500
• Conversão de taxa de câmbio fixa – $ 1> RM 3,87

Instalação

1. Para instalar wujunze/money-wrapper em seu projeto Laravel, basta executar o comando require do compositor em seu terminal:

 $ composer require wujunze/money-wrapper

2. Em seguida, em seu config/app.php adicione o seguinte ao array de provedores:

 wujunze  MoneyWrapper MoneyWrapperServiceProvider::class,

3. No mesmo config/app.php adicione o seguinte ao array de aliases:

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

4. Publicar configuração money wrapper :

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

Você pode adicionar mais detalhes de moeda com base no país. Consulte a seção de contribuições abaixo para obter detalhes.

Uso

Obtenha a instância money wrapper

Por padrão, será usada a moeda MYR, Ringgit da Malásia.

Você pode substituir pelo arquivo .env ou passar o código Alfa 2 do país ao chamar o auxiliar money() .

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

Você pode adicionar mais moedas após publicar o arquivo de configuração money wrapper e adicionar mais moedas suportadas.

Consulte o código do país e seu código e símbolo da moeda na lista de moedas.

Obter formato de dinheiro

 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. 

Converter taxa fixa

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

O tipo de dados recomendado usado no banco de dados é um número inteiro grande

Contribuições

Atualizando a lista de moedas ( config/currency.php ) disponível com base nos seguintes recursos:

1. Use o código ISO alfa 2 do país para a chave conforme definido na lista de países.
2. Consulte a lista de moedas para saber a moeda disponível.
3. Use o símbolo conforme indicado em www.xe.com.

A estrutura será a seguinte:

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

Licença

Este pacote é um software de código aberto licenciado sob a licença MIT.