README

此组件提供了一种轻松显示多种货币价格的方法。它提供了一个获取和存储当前汇率、转换价格并在Twig模板中显示的解决方案。

文档

该组件的文档可以在 Resources/doc/ 中找到

安装

遵循以下5个快速步骤来设置此组件。

步骤1：下载组件

打开命令行，进入您的项目目录，并执行以下命令以下载此组件的最新稳定版本

$ composer require ongr/currency-exchange-bundle

此命令要求您已全局安装Composer，请参阅Composer文档的安装章节。

步骤2：启用组件

在 app/AppKernel.php 中注册组件

class AppKernel extends Kernel
{
    public function registerBundles()
    {
        return [
            // ...
            new ONGR\ElasticsearchBundle\ONGRElasticsearchBundle(),
            new ONGR\CurrencyExchangeBundle\ONGRCurrencyExchangeBundle(),    
        ];
    }

    // ...
}

步骤3：更新Elasticsearch映射

此组件提供Elasticsearch文档以存储货币汇率。将此组件添加到您的ES管理器的映射中以便关联

# app/config/config.yml
ongr_elasticsearch:
    # ...
    managers:
        default:
            # ...
            mappings:
                # ...
                - AppBundle
                - ONGRCurrencyExchangeBundle

步骤4：配置组件

在 config.yml 文件中配置您需要的货币。

# app/config/config.yml
ongr_currency_exchange:
    es_manager: default
    default_currency: EUR
    separators:
        decimal: ','
        thousands: '.'
    currencies:
        EUR: "%s €"    # %s stands for the price itself
        USD: "$ %s"

设置完成，接下来查看如何使用此组件。

使用方法

此组件的主要部分是用于更新汇率率的命令和用于在多种货币中显示价格的Twig辅助函数。

在转换价格之前，您需要获取最新的汇率

$ app/console ongr:currency:update

提示：在生产环境中设置cron作业，每天更新货币。

现在您可以使用模板中的货币转换逻辑。以下是如何转换货币的简单示例

<ul>
    <li>Price in default currency: {{ 123.123|ongr_price(2) }}
    <li>Price in US dollars: {{ 123.123|ongr_price(2, 'USD') }}
</ul>

在这个例子中，数字2表示小数点后的位数。它将打印以下信息

Price in default currency: 123.12 €
Price in US dollars: $ 123.12 

要了解更多信息，请阅读提供的Twig辅助函数或检查示例货币切换实现。

许可协议

此软件包受MIT许可协议的许可。有关完整的版权和许可信息，请参阅与此源代码一起分发的LICENSE文件。