currency fx

PHP- currency fx Bibliothek

Eine PHP-Bibliothek verwaltet problemlos currency fx (Kurse und Umrechnungen). Batterie im Lieferumfang enthalten ???.

Auch für Laravel verfügbar.

Sind Sie es leid, diese zu implementieren und in Drittanbieterdienste zu integrieren? Lassen Sie uns von CurrencyFX dabei helfen. Abgedeckt durch Unit-Tests und kampferprobt!

Verfügbare Dienste / Batterien

• https://exchangeratesapi.io/
• https://exchangerate.host/
• https://fixer.io/
• https://currencylayer.com/
• https://www.currencycloud.com/

Unterstützt

• PHP 8.1+

Abhängigkeiten

• Fressen Sie sich auf API-Anfragen
• NeverThrow für eine unkomplizierte OK/Fehler-Antwort.

Verwendung

Initialisieren Sie einfach die Klasse mit den erforderlichen Parametern. Und es ist im Handumdrehen einsatzbereit.

 $ service = new CurrencyCloudService ( $ host , $ loginId , $ apiKey );
$ rateResponse = $ service -> getRates ( ' USD ' , ' SGD ' );

if (! $ rateResponse -> isOk ()) {
    // failed to get the rate from third party service
    // do something here
}

$ rate = $ rateResponse -> getOkResult ()-> rate ; // float (1.4xxx) 

Laravel-Integration

Voraussetzung: Laravel 10+

Installieren Sie einfach das Paket und lassen Sie die Magie der Laravel-Entdeckung geschehen?

Da wir die Dienste bereits im Laravel Container binden, müssen Sie nur noch die ENVs aktualisieren und das ist alles.

Exportieren Sie die Konfiguration

php artisan vendor:publish --tag=currency-fx-configs

ENVs aktualisieren

Überprüfen Sie nach der Veröffentlichung der Konfiguration die configs/currency-fx.php .

Wir haben bereits einige ENVs-Schlüssel definiert, die Sie hinzufügen können ?.

Verwendung

 use CurrencyFX  Services  CurrencyLayerService ;
use CurrencyFX  Services  ExchangerRatesApiIoService ;

// global access
app (CurrencyLayerService::class)-> getRates ( ' USD ' , ' EUR ' );

// DI
class TransferService
{
    public function __construct (
        private ExchangerRatesApiIoService $ rateService
    ) {
    }
    
    public function transfer (): TransferResult
    {
        $ rateRes = $ this -> rateService -> getRates ( ' EUR ' , ' GBP ' );
        if ( $ rateRes -> isError ()) {
            return TransferResult:: error (...);
        }

        $ rate = $ rateRes -> getOkResult ()-> rate ;
    }
}

Tests

Wir lieben Tests, immer. Wir haben 3 Arten von Testfällen:

• Unit-Tests
• Integrationstests
• E2E-Tests

Schauen Sie sich TEST-README.md an, um mehr zu erfahren!

Tragen Sie zum Projekt bei

• Alle Änderungen müssen den Codierungskonventionen PSR-1/PSR-12 entsprechen.
• Unit-Tests sind ein Muss. Decken Sie die Dinge so weit wie möglich ab.

Fühlen Sie sich frei, weitere Treiber hinzuzufügen und diese mit der gesamten PHP-Community zu teilen?

Ist diese Bibliothek nützlich?

Vielen Dank, bitte geben Sie ihm ein ️️️, um das Projekt zu unterstützen.

Vergessen Sie nicht, es mit Ihren Freunden und Kollegen zu teilen, damit auch diese ihre eigenen SaaS-Produkte entwickeln können

Lizenz

MIT LIZENZ

Mitwirkende

ShipSaas, Seth Phat und Mitwirkende