currency fx

PHP currency fxライブラリ

PHP ライブラリはcurrency fx (レートと換算) を簡単に処理します。電池付属???。

Laravelでも利用可能です。

これらを実装して 3 番目のサービスと統合することにうんざりしていませんか? CurrencyFX がそれをお手伝いします。単体テストと実戦テストでカバーされています!

利用可能なサービス/バッテリー

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

サポート

• PHP 8.1+

依存関係

• API リクエストの Guzzle
• NeverThrow による単純な OK/エラー応答。

使用法

必要なパラメータを指定してクラスを初期化するだけです。そしてすぐに使用できるようになります。

 $ 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の統合

要件: Laravel 10+

パッケージをインストールするだけで、Laravel 発見の魔法が起こります。

Laravel Container でサービスをすでにバインドしているため、必要なのは ENV を更新することだけです。

設定をエクスポートする

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

ENV を更新する

構成を公開した後、 configs/currency-fx.phpチェックアウトします。

? を追加できるように、いくつかの ENV キーをすでに定義しました。

使用法

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

テスト

私たちはいつもテストが大好きです。 3 種類のテスト ケースがあります。

• 単体テスト
• 結合テスト
• E2E テスト

詳細については、TEST-README.md をご覧ください。

プロジェクトに貢献する

• すべての変更は PSR-1 / PSR-12 コーディング規約に従う必要があります。
• 単体テストは必須であり、できる限り多くのことをカバーします。

自由にドライバーを追加して、PHP コミュニティ全体と共有してください。

このライブラリは役に立ちますか?

ありがとうございます、️️️ を押してプロジェクトをサポートしてください。

友人や同僚と共有することを忘れないでください。そうすれば、彼らも独自の SaaS 製品を構築することができます。

ライセンス

MITライセンス

貢献者

ShipSaas、Seth Phat、および寄稿者