README

需求

PHP 7.2 或更高版本，需要 simplexml 和 bcmath 扩展。

安装

composer require orkhanahmadov/cbar-currency

使用

从 CBAR 获取汇率

使用你想要获取汇率的日期实例化 Orkhanahmadov\CBARCurrency\CBAR。如果不传递日期，则使用当前日期

use Orkhanahmadov\CBARCurrency\CBAR;

$cbar = new CBAR(); // this will fetch rates for current date
$cbar = new CBAR('01.05.2019'); // this will fetch rates for 01.05.2019

您可以通过访问大写货币代码来获取货币汇率

$cbar->EUR; // returns EUR rate

您可以通过调用 for() 方法而不重新实例化类来更改日期为新日期

$cbar->for('25.04.2019'); // this will fetch rates for 25.04.2019
$cbar->USD; // returns USD rate for 25.04.2019

您可以通过传递任何 PHP 的 strtotime() 函数接受的日期格式来传递日期。例如，20.10.2019，10/20/2019，2019-10-20，today，yesterday，-1 week，-1 year，15 December 2015，last Friday。

您可以使用同一个类的实例获取多个日期的货币汇率。类实例只会为每个独特的日期获取一次汇率并存储每个日期的结果。如果您将日期设置为之前获取的日期，则将使用存储的汇率。

$cbar = new CBAR();
$cbar->for('20.04.2019'); // this will fetch rates from CBAR API
$cbar->for('23.04.2019'); // this will also fetch rates from CBAR API
$cbar->for('20.04.2019'); // since rates for 20.04.2019 fetched previously stored rates will be used instead of fetching rates for same day again

您可以使用流畅的 API 语法链式调用方法

$cbar = new CBAR();
$cbar->for('yesterday')->EUR;

所有可用的货币和货币代码可以在 CBAR 网站 上找到

将金额转换为 AZN 及从 AZN 转换

库支持使用给定日期的汇率将指定金额的 foreign currency 转换为 AZN

$cbar = new CBAR();
$cbar->USD(13); // returns AZN equivalent of 13.00 USD with today's rates
$cbar->for('01.05.2019')->USD(57.5); // returns AZN equivalent of 57.50 USD with 01.05.2019 rates

您还可以将指定金额的 AZN 转换为任何可用的 foreign currency

$cbar = new CBAR();
$cbar->AZN()->USD; // returns USD equivalent of 1.00 AZN with today's rates
$cbar->AZN(55)->USD; // returns USD equivalent of 55.00 AZN with today's rates
$cbar->for('01.05.2019')->AZN(17.3)->USD; // returns USD equivalent of 17.30 AZN with 01.05.2019 rates

辅助函数

库附带全局辅助函数。您可以使用它如下

cbar()->USD // returns USD rate for today
cbar('01.05.2019')->USD; // returns USD rate for 01.05.2019
cbar()->for('01.05.2019')->EUR; // same as above
cbar()->USD(27); // returns 27.00 USD to AZN conversion
cbar()->AZN(15.8)->EUR; // returns 15.80 AZN to EUR conversion

注意：调用 cbar() 全局函数始终返回 Orkhanahmadov\CBARCurrency\CBAR 类的新实例。

测试

composer test

变更日志

有关最近更改的更多信息，请参阅 CHANGELOG。

贡献

有关详细信息，请参阅 CONTRIBUTING。

安全

如果您发现任何与安全相关的问题，请通过电子邮件发送到 ahmadov90@gmail.com 而不是使用问题跟踪器。

鸣谢

• Orkhan Ahmadov
• 所有贡献者

许可

MIT 许可证 (MIT)。有关更多信息，请参阅 许可文件。