README

XE 货币数据客户端 - PHP

XE.com Inc. 是全球信赖的货币权威机构。本项目提供了一个 SDK，用于与我们的 XE 货币数据 (XECD) 产品进行接口交互。

XE 货币数据是一个 REST API，它为您提供访问我们支持的所有货币之间的每日或实时汇率以及历史中间市场汇率转换功能。

您需要 API 密钥和密钥来使用此 SDK。注册 免费试用 或注册 完整账户。

安装

安装此包的首选方式是通过 composer。

composer require xe/xecd-rates-client

此包遵循 语义化版本控制。

用法

<?php
require 'vendor/autoload.php';

use Xe\Xecd\Client\Rates\XecdRatesClientAspectKernel;
use Xe\Xecd\Client\Rates\Exception\XecdRatesException;
use GuzzleHttp\Exception\RequestException;

XecdRatesClientAspectKernel::getInstance()->init([
    'cacheDir' => '/your/cache/directory',
]);

$xecdRatesClient = XecdRatesClient::create(<YOUR_ACCOUNT_ID>, <YOUR_API_KEY>);

try
{
    $conversions = $xecdRatesClient->convertFrom(new Currency('CAD'), Currencies::wildcard(), 12345.67)->getBody();
    foreach ($conversions->getConversions() as $currency => $currencyConversions) {
        foreach ($currencyConversions as $timestamp => $conversion) {
            echo "{$conversion->getFromAmount()} {$conversion->getFromCurrency()} = {$conversion->getToAmount()} {$conversion->getToCurrency()}\n";
        }
    }
} catch (XecdRatesException $e) {
    // API errors with error code.
} catch (Exception $e) {
    // ALl other errors, such as connection timeout errors.
}

文档

技术规范

贡献

xecd-rates-client-php 是一个开源项目。提交拉取请求以贡献！

测试

cd xecd-rates-client-php
composer install

# Unit tests.
phpunit --testsuite Unit

# Integration tests.
export XECD_RATES_API_ACCOUNT_ID=<YOUR_API_ACCOUNT_ID>
export XECD_RATES_API_KEY=<YOUR_API_KEY>
phpunit --testsuite Integration

安全问题

如果您在此包中发现安全漏洞，请 不要 公开发布。相反，请通过 security [at] xe.com 联系我们。我们将尽快与您联系。

关于我们

XE.com Inc. 是全球信赖的货币权威机构。本项目的开发由 XE.com Inc. 开发团队领导，并得到开源社区的支持。