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

992d 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

[digitaldream/laravel-seo-tools

Laravel Seo package for Content writer/admin/web master who do not know programming but want to edit/update SEO tags from dashboard

1558.4k](/packages/digitaldream-laravel-seo-tools)

PHPackages © 2026

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