Güncel ve Geçmişe Dayalı Döviz Kurları - PHP

a) Ne işe yarar

TCMB veritabanında yayınlanmış, belirtilen tarihte kayıtlı döviz kurlarına ait XML datalarını almanıza yarayan bir kütüphanedir. Sizde kendi API servisinizi oluşturabilir ya da daha da geliştirebilir ve kendi projelerinizde farklı amaçlar için kullanabilirsiniz. Yayınlanmış olan örnek XML kaynağını incelemek için https://tcmb.gov.tr/kurlar/today.xml adresini ziyaret edebilirsiniz.

b) Özellikler

• Günün kur bilgileri,
• Seçili tarihe ait tekil ya da çoğul kur bilgileri,
• Forex ya da bankaya ait değerlerin tercihi,
• Verilerin ham XML, JSON ve Array olarak elde edilmesi,
• Dataya giden çözümlenmiş TCMB URL'si

c) Bunlar aklınızda bulunsun

1. TCMB kayıtlarında hafta sonları için kur bilgisi yer almaz. Dolayısıyla kütüphane o haftaya ait Cuma günü verilerini getirir.
2. 01 Mayıs 1996 tarihinden sonraki kayıtlara ulaşılabilinmektedir.
3. Bazı kur bilgileri TCMB tarafından boş bırakılmış olabilir.

Kullanım bilgileri

Tüm metodlar HCurrency sınıfı üzerinden çağrıacak olup, bu sınıf şu anda genişletilmeye kapalıdır. HCurrencysınıfı string türünde tek bir parametre kabul eder. Parametre formatı: yyyy-mm-dd

TCMB'den dönen yanıt: Her bir kolon array içerisindeki key'leri temsil eder.

CrossOrder	Kod	CurrencyCode	Unit	Isim	CurrencyName	ForexBuying	ForexSelling	BanknoteBuying	BanknoteSelling	CrossRateUSD	CrossRateOther
0	USD	USD	1	ABD Doları	US Dollar	0.00	0.00	0.00	0.00

1. Sınıfın çağrılması

$fetch = new TCMB\Historical\HCurrency("2021-05-16"); //günün kurları için boş bırakınız

2. Metodlar

• getCurrencies() Belirtilen tarihe ait tüm kurları array olarak getirir.
• getCurrency() Tek bir string parametre alır ve parametreye göre kur bilgilerini array olarak getirir. Default olarak usd ayarlanmıştır.
• isCurrencyCodeValid() Tek bir string parametre alır ve seçili parametrenin geçerliliğini kontrol eder. true ya da false döndürür.
• getURL() Çözümlenen TCMB url'sini string olarak getirir.
• getXML() Belirtilen tarihe ait ham XML verisini string olarak döndürür.
• getJSON()Belirtilen tarihe ait verileri string olarak JSON formatında verir.
• getDate()Belirtilen tarihi string olarak geri döndürür.

3. Kur Tipleri

use TCMB\Historical\Types\CurrencyCode;

• CurrencyCode::USDAmerikan Doları
• CurrencyCode::EUREuro
• ...

Diğer türler için Types'leri inceleyebilirsiniz.

4. Cevap (Karşıdan dönen) Tipleri

use TCMB\Historical\Types\Response;

• Response::KodUluslar arası kur kodu
• CurrencyCode::BanknoteBuyingBanka alış değerleri
• ...

Diğer türler için Types'leri inceleyebilirsiniz.

Örnek

use TCMB\Historical\HCurrency;
use TCMB\Historical\Types\CurrencyCode;
use TCMB\Historical\Types\Response;

//bugün için parametreyi boş bırakın
$fetch = new HCurrency("2022-06-29");

//euro bilgileri için
$eur = $fetch->getCurrency(CurrencyCode::EUR);

$kur_adi = $eur(Response::ISIM);
$kur_satis = $eur(Response::BANKNOTESELLING);
$kur_alis = $eur(Response::BANKNOTEBUYING);