money wrapper

Wrapper MoneyPHP

Base sur un emballage d'argent

Ceci est un emballage pour Money.

Cet emballage :

1. Fournir une aide financière - money()
2. Destiné à Laravel Framework, mais peut également être utilisé en dehors de Laravel Framework.
3. Fournir un usage courant tel que :

• Pour une lisibilité humaine – RM 1,00, RM 345,00
• Pour l'affichage commun - 1,00, 345,00
• Pour Machine (format prévu à stocker dans la base de données - entier) - 100, 34500
• Conversion du taux de change fixe - 1 $ > 3,87 RM

Installation

1. Afin d'installer wujunze/money-wrapper dans votre projet Laravel, exécutez simplement la commande composer require depuis votre terminal :

 $ composer require wujunze/money-wrapper

2. Ensuite, dans votre config/app.php ajoutez ce qui suit au tableau des fournisseurs :

 wujunze  MoneyWrapper MoneyWrapperServiceProvider::class,

3. Dans le même config/app.php ajoutez ce qui suit au tableau des alias :

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

4. Publier la configuration money wrapper :

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

Vous souhaiterez peut-être ajouter plus de détails sur la devise en fonction du pays. Voir la section contributions ci-dessous pour les détails.

Usage

Obtenir une instance money wrapper

Par défaut, la devise MYR, Malaysia Ringgit, sera utilisée.

Vous pouvez remplacer soit par le fichier .env , soit transmettre le code Alpha 2 du pays lorsque vous appelez l'assistant money() .

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

Vous pouvez ajouter plus de devises après avoir publié le fichier de configuration money wrapper et ajouté d'autres devises prises en charge.

Veuillez vous référer au code du pays, au code Swift et au symbole de la devise dans la liste des devises.

Obtenez le format d'argent

 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 taux fixe

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

Le type de données recommandé utilisé dans la base de données est un grand entier

Cotisations

Mise à jour de la liste des devises ( config/currency.php ) disponible en fonction des ressources suivantes :

1. Utilisez le code ISO Alpha 2 du pays pour la clé telle que définie dans la liste des pays.
2. Reportez-vous à la liste des devises pour connaître la devise disponible.
3. Utilisez le symbole comme indiqué sur www.xe.com.

La structure sera la suivante :

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

Licence

Ce package est un logiciel open source sous licence MIT.