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();

重置值

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

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

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