README

• 网站
• 许可证
• 版本：开发版

Moltin 货币作曲包使您能够轻松地将多货币定价集成到您的应用程序中，并使用提供的众多数据存储之一存储汇率数据。如果您希望数据存储在其他位置，您还可以注入自己的数据存储。

安装

从 http://www.getcomposer.org/download 下载并安装 composer

将以下内容添加到您的项目 composer.json 文件中

{
    "require": {
        "moltin/currency": "~1.0.0"
    }
}

完成操作后，只需运行 php composer.phar install，即可使用该包。

使用方法

以下是该包的基本使用指南。

实例化货币

在开始之前，您需要知道您将要使用哪种存储、货币和汇率方法。汇率方法定义了您的汇率是从哪里检索的。货币方法用于检索当前应用程序支持的所有货币。

在本例中，我们将使用货币文件、汇率文件和会话进行存储。

use Moltin\Currency\Currency as Currency;
use Moltin\Currency\Format\Runtime as RuntimeFormat;
use Moltin\Currency\Exchange\OpenExchangeRates as OpenExchange;

$currency = new Currency(new OpenExchange($app_id), new RuntimeFormat);

设置值

现在您已经实例化了货币，您需要告诉它您想要转换的值。您可以使用以下方法来完成此操作。

$currency->convert(9.33)->from('GBP');

获取值

您能执行的最基本操作是从方法中检索原始值。

// Returns 9.33
$value = $currency->value();

以货币格式化

默认情况下，货币设置为 GBP，因此调用货币将值格式化为带有 £ 和正确的十进制和千位分隔符的字符串。

// Returns £9.33
$value = $currency->format();

四舍五入到常用值

内置了多种常用定价格式，以便轻松实现“美好”的价格。这些格式更改默认值并返回对象，以便进行链式调用。

// Sets value to 10.00
$currency->zeros();

// Sets value to 9.99
$currency->nines();

// Sets value to 9.50
$currency->fifty();

// Returns £9.50
$value = $currency->fifty()->format();

货币汇率

该包使快速切换货币变得尽可能简单。在每次汇率转换之前，值都会重置为默认值，以确保分配正确的价格。

// Returns ~$14.47
$value = $currency->convert(9.33)->from('GBP')->to('USD')->format();

// Returns ~14.50
$value = $currency->convert(9.33)->from('GBP')->to('USD')->fifty()->value();

重置值

在使用汇率或任何四舍五入函数检索默认值之后，您必须调用重置。

// Returns 10.00
$value = $currency->zeros()->value();

// Returns 9.33
$value = $currency->reset()->value();