currency fx

Bibliothèque currency fx PHP

Une bibliothèque PHP gère facilement currency fx (taux et conversions). Batterie-incluse ???.

Disponible également pour Laravel.

Vous en avez assez de les mettre en œuvre et de les intégrer à des services tiers ? Laissez CurrencyFX vous aider à le faire. Couvert par les tests unitaires et testé au combat !

Services disponibles / Piles

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

Prise en charge

• PHP8.1+

Dépendances

• Guzzle pour les requêtes API
• NeverThrow pour une réponse simple OK/Erreur.

Usage

Initialisez simplement la classe avec les paramètres requis. Et il est prêt à l'emploi en un rien de temps.

 $ 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) 

Intégration Laravel

Exigence : Laravel 10+

Installez simplement le package et laissez la magie de la découverte de Laravel se produire ?

Puisque nous lions déjà les services dans Laravel Container, tout ce que vous avez à faire est de mettre à jour les ENV et c'est tout.

Exporter la configuration

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

Mettre à jour les ENV

Après avoir publié la configuration, consultez le configs/currency-fx.php .

Nous avons déjà défini quelques clés ENV que vous pouvez ajouter ?.

Usage

 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 ;
    }
}

Essais

Nous aimons les tests, toujours. Nous avons 3 types de cas de tests :

• Tests unitaires
• Tests d'intégration
• Tests E2E

Consultez le TEST-README.md pour en savoir plus !

Contribuer au projet

• Toutes les modifications doivent suivre les conventions de codage PSR-1/PSR-12.
• Les tests unitaires sont indispensables, couvrent les choses autant que possible.

N'hésitez pas à ajouter plus de pilotes et à les partager avec toute la communauté PHP ?

Cette bibliothèque est utile ?

Merci, merci de lui donner un ️️️ pour soutenir le projet.

N'oubliez pas de partager avec vos amis et collègues, afin qu'ils puissent également créer leurs propres produits SaaS.

Licence

LICENCE MIT

Contributeurs

ShipSaas, Seth Phat et les contributeurs