currency fx

PHP currency fx庫

PHP 函式庫可以輕鬆處理currency fx （匯率和換算）。含電池？ ？

也適用於 Laravel。

厭倦了實施這些並與第三服務整合？讓CurrencyFX 幫助您做到這一點。經過單元測試和實戰測試！

可用服務/電池

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

支援

• PHP 8.1+

依賴關係

• 大量 API 請求
• NeverThrow 用於直接的 OK/Error 回應。

用法

只需使用所需的參數初始化類別即可。並且可以立即使用。

 $ 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 容器中綁定了服務，因此您所要做的就是更新 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 種測試案例：

• 單元測試
• 整合測試
• 端對端測試

查看 TEST-README.md 以了解更多資訊！

為專案做出貢獻

• 所有變更必須遵循 PSR-1 / PSR-12 編碼約定。
• 單元測試是必須的，盡可能涵蓋盡可能多的內容。

隨意添加更多驅動程式並將其分享給整個 PHP 社群嗎？

這個函式庫有用嗎？

謝謝，請給它️️️支持這個項目。

不要忘記與您的朋友和同事分享，這樣他們也可以建立自己的 SaaS 產品

執照

麻省理工學院許可證

貢獻者

ShipSaas、Seth Phat 和貢獻者