Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mlevent/tcmb
TCMB Döviz Kurları ve Kur Çevirici
https://github.com/mlevent/tcmb
currency doviz exchange-rates tcmb
Last synced: about 1 month ago
JSON representation
TCMB Döviz Kurları ve Kur Çevirici
- Host: GitHub
- URL: https://github.com/mlevent/tcmb
- Owner: mlevent
- License: mit
- Created: 2023-08-30T02:20:39.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2023-08-30T02:35:13.000Z (over 1 year ago)
- Last Synced: 2024-10-12T06:21:19.206Z (2 months ago)
- Topics: currency, doviz, exchange-rates, tcmb
- Language: PHP
- Homepage: https://mlevent.github.io/tcmb
- Size: 6.84 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
💸 TCMB Döviz Kurları
TCMB'ın yayınladığı döviz kuru bilgilerine günlük ya da geçmişe dönük ulaşabilir, para birimlerini dönüştürebilirsiniz.
### Kurulum
🛠️ Paketi composer ile projenize dahil edin;
```bash
composer require mlevent/tcmb
```
### Örnek Kullanım
```php
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());
```
Bu örnek, aşağıdaki gibi bir `Currency` nesnesi döndürecektir;
```php
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] =>
)
```
Nesne elemanlarına ulaşmak için;
```php
echo $tcmb->getUsd()->forexSelling; // 27.0741
```
### Geçmiş Tarihli Veriler
Tcmb'nin sağladığı geçmiş tarihli kur verilerine de ulaşabilirsiniz;
```php
$tcmb = (new Tcmb)->setDate('16/05/2022');
```
> Belirtilen tarih haftasonu veya resmi tatillere denk geliyorsa, kur bilgisi dönmeyecektir.
### Kur Dönüştürme
Para birimlerini dönüştürmek için;
```php
echo $tcmb->convert('USD', 'TRY'); // 27.0741
```
Aşağıdaki şu kullanım da aynı sonucu verecektir;
```php
echo $tcmb->convertUsdTry(10); // 270.741
```
### Cache
Performans iyileştirmesi için önbellek kullanmak isteyebilirsiniz. Aşağıdaki örnek [mlevent/file-cache](https://github.com/mlevent/file-cache) sınıfı kullanılmıştır. Farklı bir önbellekleme yapısı kullanıyorsanız aynı yolu takip edebilirsiniz;
```php
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
```
### Ekstra
Kullanılabilecek diğer metodlar;
```php
/**
* 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();
```
### Para Birimleri
TCMB'ın verilerini yayınladığı para birimleri;
| | Adı | Kodu | | | Adı | Kodu |
| :-: | :--------------------- | :--: | --- | :-: | :-------------------------------- | :--: |
| 🇺🇸 | ABD Doları | USD | | 🇦🇿 | Azerbaycan Yeni Manata | AZN |
| 🇪🇺 | Euro | EUR | | 🇦🇪 | Birleşik Arap Emirlikleri Dirhemi | AED |
| 🇬🇧 | İngiliz Sterlini | GBP | | 🇩🇰 | Danimarka Kronu | DKK |
| 🇯🇵 | Japon Yeni | JPY | | 🇸🇪 | İsveç Kronu | SEK |
| 🇷🇺 | Rus Rublesi | RUB | | 🇰🇼 | Kuveyt Dinarı | KWD |
| 🇸🇦 | Suudi Arabistan Riyali | SAR | | 🇳🇴 | Norveç Kronu | NOK |
| 🇨🇭 | İsviçre Frangı | CHF | | 🇷🇴 | Rumen Leyi | RON |
| 🇦🇹 | Avustralya Doları | AUD | | 🇮🇷 | İran Riyali | IRR |
| 🇨🇦 | Kanada Doları | CAD | | 🇵🇰 | Pakistan Rupisi | PKR |
| 🇨🇳 | Çin Yuanı | CNY | | 🇶🇦 | Katar Riyali | QAR |
| 🇧🇬 | Bulgar Levası | BGN | | 🇰🇷 | Güney Kore Wonu | KRW |
### 📧İletişim
İletişim için [email protected] adresine e-posta gönderin.