money wrapper

MoneyPHP-Wrapper

Basis auf Geldumschlag

Dies ist eine Hülle für Geld.

Dieser Wrapper:

1. Stellen Sie einen Money-Helfer bereit - money()
2. Gedacht für das Laravel Framework, kann aber auch außerhalb des Laravel Frameworks verwendet werden.
3. Stellen Sie allgemeine Verwendungszwecke bereit, z. B.:

• Für die menschliche Lesbarkeit – RM 1,00, RM 345,00
• Für gemeinsame Anzeige – 1,00, 345,00
• Für Maschine (vorgesehenes Format zum Speichern in der Datenbank – Ganzzahl) – 100, 34500
• Fester Wechselkurs: 1 $ > 3,87 RM

Installation

1. Um wujunze/money-wrapper in Ihrem Laravel-Projekt zu installieren, führen Sie einfach den Composer-Befehl require von Ihrem Terminal aus:

 $ composer require wujunze/money-wrapper

2. Fügen Sie dann in Ihrer config/app.php Folgendes zum Provider-Array hinzu:

 wujunze  MoneyWrapper MoneyWrapperServiceProvider::class,

3. Fügen Sie in derselben config/app.php Folgendes zum Aliases-Array hinzu:

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

4. money wrapper Konfiguration veröffentlichen:

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

Möglicherweise möchten Sie je nach Land weitere Währungsdetails hinzufügen. Einzelheiten finden Sie im Abschnitt „Beiträge“ weiter unten.

Verwendung

Holen Sie sich money wrapper -Instanz

Standardmäßig wird die Währung MYR und Malaysischer Ringgit verwendet.

Sie können entweder eine .env Datei überschreiben oder den Länder-Alpha-2-Code übergeben, wenn Sie money() Helper aufrufen.

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

Sie können weitere Währungen hinzufügen, nachdem Sie die money wrapper -Konfigurationsdatei veröffentlicht und weitere unterstützte Währungen hinzugefügt haben.

Bitte beachten Sie den Ländercode sowie den Währungs-Swift-Code und das Währungssymbol in der Währungsliste.

Holen Sie sich das Geldformat

 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. 

Konvertieren Sie den Festpreis

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

Der empfohlene Datentyp für die Datenbank ist Big Integer

Beiträge

Die Aktualisierung der verfügbaren Währungsliste ( config/currency.php ) basiert auf den folgenden Ressourcen:

1. Verwenden Sie den Länder-ISO-Alpha-2-Code für den Schlüssel, wie in der Länderliste definiert.
2. Die verfügbare Währung finden Sie in der Währungsliste.
3. Verwenden Sie das Symbol gemäß den Angaben auf www.xe.com.

Die Struktur wird wie folgt sein:

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

Lizenz

Bei diesem Paket handelt es sich um Open-Source-Software, die unter der MIT-Lizenz lizenziert ist.