解决汇率数据获取与转换难题：ashallendesign/laravel-exchange-rates让你的Laravel应用更国际化-composer-PHP中文网

解决汇率数据获取与转换难题：ashallendesign/laravel-exchange-rates让你的Laravel应用更国际化

心靈之曲

发布： 2025-10-26 09:47:01

原创

262人浏览过

解决汇率数据获取与转换难题：ashallendesign/laravel-exchange-rates让你的laravel应用更国际化

可以通过一下地址学习composer：学习地址

汇率管理：一个国际化应用的痛点

想象一下，你正在开发一个面向全球用户的在线商店。用户来自世界各地，他们希望在浏览商品时能看到自己本地货币的价格。这意味着你的应用需要：

实时获取汇率： 确保商品价格始终基于最新的汇率。
支持多种货币： 不仅仅是美元、欧元，还需要支持日元、英镑、澳元等。
历史汇率查询： 可能需要查看特定日期的汇率，例如用于订单归档或历史数据分析。
货币转换： 将基础货币金额准确地转换为目标货币。
性能与稳定性： 频繁的 API 调用可能导致限流，需要高效的缓存机制。
API 切换： 如果当前使用的汇率 API 出现问题或变更，需要快速切换到其他提供商。

手动处理这些需求，意味着你需要：

寻找并评估多个汇率 API 提供商。
编写复杂的 HTTP 请求逻辑，处理 API 响应和潜在的错误。
实现自定义的缓存层，以减少 API 调用次数。
维护货币代码列表和转换逻辑。
当 API 接口变化时，需要修改大量代码。

这些繁琐的工作不仅降低了开发效率，还增加了项目出错的风险。

`ashallendesign/laravel-exchange-rates`：Laravel 汇率管理的利器

幸运的是，在 Laravel 生态中，我们有一个优雅的解决方案：ashallendesign/laravel-exchange-rates。这是一个专门为 Laravel 设计的封装包，它抽象了与多个汇率 API 的交互细节，让你能够以简洁、一致的方式获取和转换汇率数据。而这一切的起点，都离不开 Composer 的强大支持。

第一步：通过 Composer 轻松安装

使用 Composer 安装这个包非常简单，只需一个命令：

<code class="bash">composer require ashallendesign/laravel-exchange-rates</code>

登录后复制

这个命令会自动下载并安装包及其所有依赖，将它集成到你的 Laravel 项目中。

第二步：配置你的汇率服务

安装完成后，你需要发布包的配置文件，并根据你选择的汇率 API 进行配置。

<code class="bash">php artisan vendor:publish --provider="AshAllenDesign\LaravelExchangeRates\Providers\ExchangeRatesProvider"</code>

登录后复制

这会在 config 目录下生成 laravel-exchange-rates.php 文件。如果你的 API 需要 API Key，记得在 .env 文件中设置：

<code class="dotenv">EXCHANGE_RATES_API_KEY={Your-API-Key-Here}</code>

登录后复制

值得一提的是，这个包支持多个汇率 API 驱动，例如 Exchange Rates API、Exchange Rates Data API、Exchange Rate Host 和 CurrencyBeacon。你可以在配置文件中轻松切换默认驱动，或者在运行时动态选择。

核心功能与实用示例

ashallendesign/laravel-exchange-rates 提供了一系列直观的方法来处理汇率相关的任务。

AppMall应用商店

AI应用商店，提供即时交付、按需付费的人工智能应用服务

查看详情

1. 获取可用货币列表

<pre class="brush:php;toolbar:false;">use AshAllenDesign\LaravelExchangeRates\Classes\ExchangeRate;

$exchangeRates = app(ExchangeRate::class);
$currencies = $exchangeRates->currencies();
// $currencies 会返回一个包含所有支持货币代码的数组，例如 ['USD', 'EUR', 'GBP', ...]

登录后复制

2. 获取指定货币的汇率

你可以轻松获取两种货币之间的汇率，甚至可以获取历史汇率。

<pre class="brush:php;toolbar:false;">use AshAllenDesign\LaravelExchangeRates\Classes\ExchangeRate;
use Carbon\Carbon;

$exchangeRates = app(ExchangeRate::class);

// 获取今天 GBP 到 EUR 的汇率
$rateToday = $exchangeRates->exchangeRate('GBP', 'EUR'); // 1.10086

// 获取特定日期 GBP 到 EUR 的汇率
$rateOnDate = $exchangeRates->exchangeRate('GBP', 'EUR', Carbon::create(2023, 1, 15));

// 一次性获取 GBP 到多个货币的汇率
$multiRates = $exchangeRates->exchangeRate('GBP', ['EUR', 'USD']);
/*
$multiRates: [
    'EUR' => 1.10086,
    'USD' => 1.25622,
];
*/

登录后复制

3. 货币金额转换

转换金额时，请注意第一个参数应传入货币的“最低面额”。例如，1 英镑应传入 100（因为 1 英镑 = 100 便士）。

<pre class="brush:php;toolbar:false;">use AshAllenDesign\LaravelExchangeRates\Classes\ExchangeRate;
use Carbon\Carbon;

$exchangeRates = app(ExchangeRate::class);

// 将 100 便士 (1 GBP) 转换为 EUR
$convertedAmount = $exchangeRates->convert(100, 'GBP', 'EUR', Carbon::now()); // 110.15884906 (1.10 EUR)

// 将 100 便士 (1 GBP) 转换为 EUR 和 USD
$convertedMultiAmounts = $exchangeRates->convert(100, 'GBP', ['EUR', 'USD'], Carbon::now());
/*
$convertedMultiAmounts: [
    'EUR' => 110.15884906,
    'USD' => 125.30569081
];
*/

登录后复制

4. 日期范围内的汇率与转换

对于需要分析历史趋势或在特定时间段内进行批量转换的场景，该包同样提供了便捷的方法。

<pre class="brush:php;toolbar:false;">use AshAllenDesign\LaravelExchangeRates\Classes\ExchangeRate;
use Carbon\Carbon;

$exchangeRates = app(ExchangeRate::class);

// 获取过去 3 天 GBP 到 EUR 的汇率
$ratesBetweenDates = $exchangeRates->exchangeRateBetweenDateRange(
    'GBP',
    'EUR',
    Carbon::now()->subDays(3),
    Carbon::now()
);

// 将 100 便士 (1 GBP) 在过去 3 天内转换为 EUR
$convertedBetweenDates = $exchangeRates->convertBetweenDateRange(
    100,
    'GBP',
    'EUR',
    Carbon::now()->subDays(3),
    Carbon::now()
);

登录后复制

5. 强大的缓存机制

为了优化性能并避免频繁触及 API 限流，该包默认会对 API 响应进行缓存。你也可以灵活控制缓存行为：

<pre class="brush:php;toolbar:false;">// 强制刷新缓存，获取最新数据
$freshRates = $exchangeRates->shouldBustCache()->exchangeRate('GBP', 'EUR');

// 禁用缓存，每次都从 API 获取
$noCacheRates = $exchangeRates->shouldCache(false)->exchangeRate('GBP', 'EUR');

登录后复制

6. 多驱动支持与切换

如果你需要切换不同的汇率 API 提供商，或者在特定场景下使用不同的 API，driver() 方法让这一切变得轻而易举：

<pre class="brush:php;toolbar:false;">// 使用 CurrencyBeacon 驱动获取汇率
$currencyBeaconRates = $exchangeRates->driver('currency-beacon')->exchangeRate('GBP', 'EUR');

// 使用 Exchange Rates API IO 驱动获取汇率
$exchangeRatesApiIoRates = $exchangeRates->driver('exchange-rates-api-io')->exchangeRate('GBP', 'EUR');

登录后复制

7. 货币验证规则

该包还提供了一个 ValidCurrency 验证规则，用于确保用户输入的货币代码是有效的，这在处理用户输入时非常有用。

<pre class="brush:php;toolbar:false;">use AshAllenDesign\LaravelExchangeRates\Rules\ValidCurrency;
use Illuminate\Support\Facades\Validator;

$formData = ['currency' => 'GBP'];
$rules = ['currency' => new ValidCurrency()];

$validator = Validator::make($formData, $rules);
if ($validator->fails()) {
    // 处理验证失败
}

登录后复制