lilessam/currencies

Laravel 的简易货币包

1.0.4 2017-12-09 16:56 UTC

This package is not auto-updated.

Last update: 2024-09-29 05:01:26 UTC


README

Laravel 货币包

此包提供了两个简单的助手函数,可以将金额从一种货币转换为另一种货币,并获取任何货币今天的汇率。

包中的助手函数使用外部API,该API提供实时汇率。

安装

通过 composer

composer require lilessam/currencies

然后,将 Lilessam\Currencies\CurrenciesServiceProvider 添加到 config/app.php 文件中的 providers 数组中。

使用此包

您可以使用助手函数 convert_currency,它需要三个参数。第一个是金额,第二个是当前货币,第三个是想将金额转换成的货币。

// This will convert 10 from USD to EUR with today's price
$amount = convert_currency(10, 'USD', 'EUR');

您还可以使用 get_rates 助手函数来获取今天的汇率对象。其第一个参数是必需的,即基础货币。第二个参数是可选的,其类型为数组,允许您传递想要获取汇率的货币。

// This will return an object of all USD currencies today's rates
$rates = get_rates('USD');
// This will return an object of Euro, Indian Rubles and Arab Emirates Dirham rates for USD.
$rates = get_rates('USD', ['EUR', 'INR', 'AUD']);

缓存设置

现在,该包使用 Laravel 缓存系统来缓存来自外部API的数据,以尽可能减少API调用。因此,您可以使用以下命令发布包配置文件,并更改您希望保留缓存数据的分钟数。

php artisan vendor:publish --provider=Lilessam\Currencies\CurrenciesServiceProvider

默认情况下,该包缓存数据为60分钟。

该包几乎在30分钟内开发完成,因此如果发现问题,请发布问题或提交拉取请求。谢谢!