ranium/laravel-fixerio

Laravel 包/客户端用于 fixer.io API,一个外汇汇率和货币转换 API。

v1.2.0 2020-12-30 09:10 UTC

This package is auto-updated.

Last update: 2024-08-29 05:07:56 UTC


README

Build Status Total Downloads Latest Stable Version License

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 许可证