README

可以获取TCMB发布的汇率信息，并实现货币转换。

安装

🛠️ 使用composer将包添加到您的项目中；

composer require mlevent/tcmb

示例用法

use Mlevent\Tcmb\Tcmb;

$tcmb = new Tcmb;

// Dolar kuruna ait detaylar
var_dump($tcmb->get('USD'));

// Bu kullanım da aynı sonucu verecektir
var_dump($tcmb->getUsd());

此示例将返回以下Currency对象；

Mlevent\Tcmb\Currency Object
(
    [currencyCode]    => USD
    [currencyName]    => US DOLLAR
    [currencyAlias]   => ABD DOLARI
    [forexBuying]     => 27.0254
    [forexSelling]    => 27.0741
    [banknoteBuying]  => 27.0065
    [banknoteSelling] => 27.1147
    [crossRateUSD]    =>
    [crossRateOther]  =>
)

访问对象元素的方式；

echo $tcmb->getUsd()->forexSelling; // 27.0741

历史数据

可以获取TCMB提供的过去日期的汇率数据；

$tcmb = (new Tcmb)->setDate('16/05/2022');

如果指定日期是周末或法定假日，则不会返回汇率信息。

汇率转换

进行货币转换；

echo $tcmb->convert('USD', 'TRY'); // 27.0741

以下使用方法也将得到相同的结果；

echo $tcmb->convertUsdTry(10); // 270.741

缓存

为了提高性能，您可以使用缓存。以下示例使用了mlevent/file-cache类。如果您使用不同的缓存结构，可以遵循相同的步骤；

use Mlevent\FileCache\FileCache;
use Mlevent\Tcmb\Tcmb;

$tcmb = new Tcmb;

// Veriler 60 saniye boyunca diskte saklanacak
$data = (new FileCache)->refresh('exchange-rates', function () use ($tcmb) {
    return $tcmb->fetchExchangeRates();
}, 60);

// Veri içe aktarılıyor
$tcmb->setExchangeRates($data);

echo $tcmb->getUsd()->forexSelling; // 27.0741

额外

其他可用方法；

/**
 * Döviz Listesi
 * @return array
 */
$tcmb->getCurrencies();

/**
 * Tüm Döviz Cinslerine Ait Kur Bilgileri
 * @return array
 */
$tcmb->getExchangeRates();

/**
 * TCMB Bülten Yayınlanma Tarihi
 * @return string
 */
$tcmb->getBulletinDate();

/**
 * TCMB Bülten Numarası
 * @return string
 */
$tcmb->getBulletinNumber();

货币

TCMB发布的数据中的货币；

📧联系

请发送电子邮件至ghergedan@gmail.com进行联系。