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 和贡献者