ranium / laravel-fixerio
Laravel 包/客户端用于 fixer.io API,一个外汇汇率和货币转换 API。
v1.2.0
2020-12-30 09:10 UTC
Requires
- php: ^7.2|^8.0
- laravel/framework: ^6.0|^7.0|^8.0
- ranium/fixerio-php-client: 1.*
Requires (Dev)
- orchestra/testbench: ^3.8|^4.0|^5.0|^6.0
- phpunit/phpunit: ^8.0|^9.0
README
Laravel Fixer.io
提供用于 fixer.io 交换率和货币转换 JSON API 的简单易用的 Laravel 包。这基本上是 ranium/fixerio-php-client 的 Laravel 包装器。
安装
在 Laravel 应用的根目录下运行以下命令
composer require ranium/laravel-fixerio
配置
发布配置文件
php artisan vendor:publish --tag=laravel-fixerio
编辑 config/fixerio.php
并输入您的访问密钥,并根据需要调整其他配置选项。注意,secure
选项仅适用于 fixer.io 的付费计划。
使用
// Resolve the client class instance out of the service container $fixerio = app(\Ranium\LaravelFixerio\Client::class); // Find latest rates $latestRates = $fixerio->latest(); echo $latestRates['rates']['INR']; // Find historical rates $historicalRates = $fixerio->historical(['date' => '2019-01-01']); echo $historicalRates['rates']['INR'];
您还可以使用提供的 Facade
use Fixerio; $latestRates = Fixerio::latest();
由于对 fixer.io 的请求数量有严格限制,此包提供了缓存响应的简单方法。默认缓存存储用于缓存。
修改 config/fixerio.php
以启用缓存。
'cache' => [ 'enabled' => true, 'expire_after' => 60, // In minutes, change this as per requirement ];
您可以在运行时禁用缓存。
use Fixerio; Fixerio::disableCache(); $latestRates = Fixerio::latest(); // Enable cache again for other calls Fixerio::enableCache(); // Other calls to the API...
有关所有可用 API 调用和其他详细信息,请参阅 ranium/fixerio-php-client。
上述所有调用的响应将是一个 Guzzle 命令结果对象。有关各种端点、请求参数和响应对象的其他详细信息,请参阅 fixer.io 的 文档。
许可证
此包是开源软件,许可协议为 MIT 许可证。