README

此库帮助开发者轻松地将比特币转换为法定货币（ISO 4217）或另一种加密货币，反之亦然，从您选择的汇率提供商处获取。

可用的汇率提供商有

• Coinbase
• Coindesk
• Bitpay

如果您对其他汇率提供商或其他功能有任何请求，希望我添加，请参阅 贡献。

功能

简单、轻量级、可扩展、框架无关且快速。

• 您可以转换比特币为任何货币（ISO 4217 法定货币或另一种加密货币）
• 您可以转换任何货币（ISO 4217 法定货币或另一种加密货币）为比特币
• 它支持不同的汇率提供商：Coinbase、Coindesk、Bitpay
• 它具有内置的缓存（PSR16 兼容，可互换为您自己的或您框架的）

安装

让我们开始通过 Composer 安装此库

$ composer require jimmerioles/bitcoin-currency-converter-php

用法

您可以通过以下方式将比特币转换为任何货币（ISO 4217 法定货币或加密货币）

use Jimmerioles\BitcoinCurrencyConverter\Converter;

$convert = new Converter;              // uses Coinbase as default provider
echo $convert->toCurrency('USD', 0.5); // 2000.00
echo $convert->toCurrency('LTC', 0.5); // 10.12345678

或者您可以使用辅助函数以方便使用

// uses Coinbase as default provider
echo to_currency('USD', 0.5); // 2000.00
echo to_currency('LTC', 0.5); // 10.12345678

您也可以将任何货币（ISO 4217 法定货币或加密货币）转换为比特币

use Jimmerioles\BitcoinCurrencyConverter\Converter;

$convert = new Converter;         // uses Coinbase as default provider
echo $convert->toBtc(100, 'USD'); // 0.12345678
echo $convert->toBtc(20, 'LTC');  // 1.12345678

并且它也有其辅助函数以方便使用

// uses Coinbase as default provider
echo to_btc(100, 'USD'); // 0.12345678
echo to_btc(20, 'LTC');  // 2.12345678

您可以使用来自提供商的不同汇率

use Jimmerioles\BitcoinCurrencyConverter\Converter;
use Jimmerioles\BitcoinCurrencyConverter\Provider\CoinbaseProvider;
use Jimmerioles\BitcoinCurrencyConverter\Provider\CoindeskProvider;
use Jimmerioles\BitcoinCurrencyConverter\Provider\BitpayProvider;

$convert = new Converter(new CoinbaseProvider);
$convert = new Converter(new CoindeskProvider);
$convert = new Converter(new BitpayProvider);

或者如果您更喜欢使用辅助函数

echo to_currency('USD', 0.5, new CoindeskProvider); // 2000.00
echo to_currency('LTC', 0.5, new BitpayProvider);   // 10.12345678
echo to_btc(100, 'USD', new CoindeskProvider);      // 0.12345678
echo to_btc(20, 'LTC', new BitpayProvider);         // 2.12345678

您可以通过以下方式指定提供商的缓存过期时间（ttl）

new CoinbaseProvider($httpClient, $psr16CacheImplementation, 5); // cache expires in 5mins, defaults to 60mins

变更日志

请参阅 CHANGELOG 以获取有关最近更改的更多信息。

测试

$ phpunit

显示完整的规范和功能

$ phpunit --testdox

贡献

欢迎建议和请求。请通过 问题 或 拉取请求 提交。

安全

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

鸣谢

• Jim Merioles
• 贡献者

许可

MIT 许可证（MIT）。请参阅 许可文件 以获取更多信息。

想要表达一些喜爱吗？