money wrapper

Envoltorio MoneyPHP

Base en envoltorio de dinero

Este es un envoltorio para dinero.

Este envoltorio:

1. Proporcionar un asistente de dinero: money()
2. Diseñado para Laravel Framework, pero también se puede usar fuera de Laravel Framework.
3. Proporcionar uso común como:

• Para legibilidad humana: RM 1,00, RM 345,00
• Para pantalla común: 1,00, 345,00
• Para máquina (formato previsto para almacenar en la base de datos: entero): 100, 34500
• Conversión de tipo de cambio fijo: 1 dólar > 3,87 RM

Instalación

1. Para instalar wujunze/money-wrapper en su proyecto Laravel, simplemente ejecute el comando require del compositor desde su terminal:

 $ composer require wujunze/money-wrapper

2. Luego, en su config/app.php agregue lo siguiente a la matriz de proveedores:

 wujunze  MoneyWrapper MoneyWrapperServiceProvider::class,

3. En el mismo config/app.php agregue lo siguiente a la matriz de alias:

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

4. Publicar configuración money wrapper :

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

Es posible que desee agregar más detalles de moneda según el país. Consulte la sección de contribuciones a continuación para obtener más detalles.

Uso

Obtener instancia money wrapper

De forma predeterminada, se utilizará MYR, la moneda Ringgit de Malasia.

Puede anularlo mediante el archivo .env o pasar el código Alpha 2 del país al llamar al asistente money() .

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

Puede agregar más monedas después de publicar el archivo de configuración money wrapper y agregar más monedas admitidas.

Consulte el código de país y su código rápido y símbolo de moneda en la Lista de monedas.

Obtener formato de dinero

 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. 

Convertir tasa fija

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

El tipo de datos recomendado utilizado en la base de datos es un entero grande

Contribuciones

Actualización de la lista de monedas ( config/currency.php ) disponible según los siguientes recursos:

1. Utilice el código ISO Alfa 2 del país para la clave tal como se define en la Lista de países.
2. Consulte la lista de divisas para conocer las divisas disponibles.
3. Utilice el símbolo según lo indicado en www.xe.com.

La estructura será la siguiente:

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

Licencia

Este paquete es un software de código abierto con licencia MIT.