README

CakePHP 3 的助手，可使用当前汇率将货币转换为不同的货币显示。

它将缓存结果并在失效缓存之前检查响应，以确保您的网站始终提供一些货币数据，即使这些数据稍显过时。数据缓存一年，并使用 shell 进行更新。

要求

您可以使用以下命令要求它：composer require "davidyell/currency_exchange:3.x-dev"

设置您的 Currency Layer API 密钥。

Configure::write('currencyLayer.apikey', "YourApiKeyGoesHere");

该助手提供用于在显示不同货币的价格时进行前端转换。助手接受一些选项来配置其行为。

当您将助手添加到控制器中的 $helpers 数组时，您可以传递一个选项数组。以下是一个示例，显示默认值。如果您对默认值满意，则不需要传递任何配置。

// src/View/AppView.php
    $this->loadHelper('CurrencyExchange.Currency', ['targetCurrency' => 'GBP']);

提供了一个 shell，允许通过 cron job 更新缓存的汇率数据。这避免了请求在返回数据给用户之前等待远程 API 可用。

相反，您可以将 shell 设置为按需运行，它将在后台更新数据，使您的用户的前端保持快速，并保持您的数据新鲜。

缓存更新的频率由您选择运行 shell task 的频率控制。我建议设置一个每周运行一次的 cron job 以更新缓存。

bin/cake currency_exchange.rates update GBP