PHPackages                             mlevent/tcmb - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. mlevent/tcmb

ActiveLibrary[Utility & Helpers](/categories/utility)

mlevent/tcmb
============

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.

v0.1.0(2y ago)44MITPHPPHP ^8.1CI passing

Since Aug 30Pushed 2y ago1 watchersCompare

[ Source](https://github.com/mlevent/tcmb)[ Packagist](https://packagist.org/packages/mlevent/tcmb)[ Docs](https://github.com/mlevent/tcmb)[ RSS](/packages/mlevent-tcmb/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (1)Versions (2)Used By (0)

💸 TCMB Döviz Kurları
--------------------

[](#-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.

[![](https://camo.githubusercontent.com/74c8bacc6fca13a84564c8feeeb3775cdb48cf261be8b16c73bfd7fed41afa0d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f6d6c6576656e742f74636d622f7068703f7374796c653d706c6173746963)](https://camo.githubusercontent.com/74c8bacc6fca13a84564c8feeeb3775cdb48cf261be8b16c73bfd7fed41afa0d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f6d6c6576656e742f74636d622f7068703f7374796c653d706c6173746963)[![](https://camo.githubusercontent.com/d11411678a8f009b305ea70a848cc47e29463a77a2dab2d4a507939133716671/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d6c6576656e742f74636d623f7374796c653d706c6173746963)](https://camo.githubusercontent.com/d11411678a8f009b305ea70a848cc47e29463a77a2dab2d4a507939133716671/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d6c6576656e742f74636d623f7374796c653d706c6173746963)[![](https://camo.githubusercontent.com/8f67fc02d2487f3728f6aa39008adf0b9e3ac2bfda88955bddc9c3678e4bd6d2/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f6d6c6576656e742f74636d623f7374796c653d706c6173746963)](https://camo.githubusercontent.com/8f67fc02d2487f3728f6aa39008adf0b9e3ac2bfda88955bddc9c3678e4bd6d2/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f6d6c6576656e742f74636d623f7374796c653d706c6173746963)[![](https://camo.githubusercontent.com/9b097df5785bc41dd36c4499f1f6b744ec573f37dda2cf950f01b93956899aaf/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f6d6c6576656e742f74636d623f7374796c653d706c6173746963)](https://camo.githubusercontent.com/9b097df5785bc41dd36c4499f1f6b744ec573f37dda2cf950f01b93956899aaf/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f6d6c6576656e742f74636d623f7374796c653d706c6173746963)[![](https://camo.githubusercontent.com/6e67ebc01c3f0865e0fdcf75e0cf630e181f72885398716c8e3e818fb3c9dedb/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d6c6576656e742f74636d623f7374796c653d706c6173746963)](https://camo.githubusercontent.com/6e67ebc01c3f0865e0fdcf75e0cf630e181f72885398716c8e3e818fb3c9dedb/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d6c6576656e742f74636d623f7374796c653d706c6173746963)[![](https://camo.githubusercontent.com/0ca7e8efae85ab234607d625b5fdb06b4b08c65a138ebf11641708eda1900e84/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6d6c6576656e742f74636d623f7374796c653d706c6173746963)](https://camo.githubusercontent.com/0ca7e8efae85ab234607d625b5fdb06b4b08c65a138ebf11641708eda1900e84/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6d6c6576656e742f74636d623f7374796c653d706c6173746963)[![](https://camo.githubusercontent.com/6cf158cba81584cba5eea4b707199a56da1e221fe5ba49b5583ea3aea61d262c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f6d6c6576656e742f74636d623f7374796c653d706c6173746963)](https://camo.githubusercontent.com/6cf158cba81584cba5eea4b707199a56da1e221fe5ba49b5583ea3aea61d262c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f6d6c6576656e742f74636d623f7374796c653d706c6173746963)

### Kurulum

[](#kurulum)

🛠️ Paketi composer ile projenize dahil edin;

```
composer require mlevent/tcmb
```

### Örnek Kullanım

[](#örnek-kullanım)

```
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;

```
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;

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

### Geçmiş Tarihli Veriler

[](#geçmiş-tarihli-veriler)

Tcmb'nin sağladığı geçmiş tarihli kur verilerine de ulaşabilirsiniz;

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

> Belirtilen tarih haftasonu veya resmi tatillere denk geliyorsa, kur bilgisi dönmeyecektir.

### Kur Dönüştürme

[](#kur-dönüştürme)

Para birimlerini dönüştürmek için;

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

Aşağıdaki şu kullanım da aynı sonucu verecektir;

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

### Cache

[](#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;

```
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

[](#ekstra)

Kullanılabilecek diğer metodlar;

```
/**
 * 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

[](#para-birimleri)

TCMB'ın verilerini yayınladığı para birimleri;

AdıKoduAdıKodu🇺🇸ABD DolarıUSD🇦🇿Azerbaycan Yeni ManataAZN🇪🇺EuroEUR🇦🇪Birleşik Arap Emirlikleri DirhemiAED🇬🇧İngiliz SterliniGBP🇩🇰Danimarka KronuDKK🇯🇵Japon YeniJPY🇸🇪İsveç KronuSEK🇷🇺Rus RublesiRUB🇰🇼Kuveyt DinarıKWD🇸🇦Suudi Arabistan RiyaliSAR🇳🇴Norveç KronuNOK🇨🇭İsviçre FrangıCHF🇷🇴Rumen LeyiRON🇦🇹Avustralya DolarıAUD🇮🇷İran RiyaliIRR🇨🇦Kanada DolarıCAD🇵🇰Pakistan RupisiPKR🇨🇳Çin YuanıCNY🇶🇦Katar RiyaliQAR🇧🇬Bulgar LevasıBGN🇰🇷Güney Kore WonuKRW### 📧İletişim

[](#i̇letişim)

İletişim için  adresine e-posta gönderin.

###  Health Score

21

—

LowBetter than 18% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

993d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/05bb9553ee107aea561f3d6b82d5b54bb3172b5800aaf6bc40f4998d62c7d297?d=identicon)[mlevent](/maintainers/mlevent)

---

Top Contributors

[![mlevent](https://avatars.githubusercontent.com/u/5323354?v=4)](https://github.com/mlevent "mlevent (4 commits)")

---

Tags

currencydovizexchange-ratestcmb

### Embed Badge

![Health badge](/badges/mlevent-tcmb/health.svg)

```
[![Health](https://phpackages.com/badges/mlevent-tcmb/health.svg)](https://phpackages.com/packages/mlevent-tcmb)
```

###  Alternatives

[ivanovsaleksejs/num-to-text

Converts numbers or prices to text representation in various languages. For example, 437605 becomes "four hundred thirty seven thousand six hundred five". Price class for displaying prices with currencies is also available.

2015.9k](/packages/ivanovsaleksejs-num-to-text)[vildanbina/composer-upgrader

Effortlessly upgrade all Composer dependencies to their latest versions with a single command.

364.7k1](/packages/vildanbina-composer-upgrader)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)