umpirsky/locurro

本地货币转换器。

0.2.0 2015-09-01 17:05 UTC

This package is not auto-updated.

Last update: 2024-09-12 00:04:46 UTC


README

symfony upgrade fixertwig gettext extractorwisdomcentipedepermissions handlerextraloadgravatarlocurrocountry listtransliterator

Locurro Build Status

💶 本地货币转换器。

用例

想象一下,你有一个在线商店,你正在多个不同国家销售产品。一些买家可能居住在除你商店使用的货币以外的国家。给他们估算产品成本的国内货币将会很酷。

以下是显示括号下近似价格的一个例子

us fr

例如,它可以根据用户的IP地址自动检测用户的默认货币。

非常酷,不是吗? 😄

基本用法

根据货币转换

<?php

/* @var $converter Locurro\Converter\Currency */
$converter->convert(
    new Money\Money(100, new Money\Currency('EUR')),
    new Money\Currency('RSD')
);

完整的示例在 examples/currency.php 中。

根据区域转换

<?php

/* @var $converter Locurro\Converter\Locale */
$converter->convert(
    new Money\Money(100, new Money\Currency('EUR')),
    'sr-Cyrl-RS'
);

完整的示例在 examples/locale.php 中。

根据国家转换

<?php

/* @var $converter Locurro\Converter\Country */
$converter->convert(
    new Money\Money(100, new Money\Currency('EUR')),
    'RS'
);

完整的示例在 examples/country.php 中。

根据IP地址转换

<?php

/* @var $converter Locurro\Converter\IpAddress */
$converter->convert(
    new Money\Money(100, new Money\Currency('EUR')),
    '109.92.115.78'
);

完整的示例在 examples/ip.php 中。

高级用法

链式提供者

Locurro 使用 Swap 库来获取汇率。

支持多个汇率提供者

  • 欧洲中央银行 仅支持EUR作为基础货币。
  • Google Finance 支持多种作为基础和报价货币的货币。
  • Open Exchange Rates 免费版本仅支持USD作为基础货币,企业版本支持多种货币。
  • Xignite 您必须有权访问 XigniteGlobalCurrencies API。支持多种作为基础和报价货币的货币。
  • Yahoo Finance 支持多种作为基础和报价货币的货币。
  • WebserviceX 支持多种作为基础和报价货币的货币。
  • National Bank of Romania 仅支持RON作为基础货币。
  • Array 从PHP数组中检索汇率。

您可以将它们串联起来,请参阅示例/ip-chained.php

缓存

您可以使用Doctrine缓存或Illuminate缓存来缓存汇率。

示例代码可在示例/ip-cached.php找到。

Twig集成

源代码中提供了一个Twig扩展。