Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/teknomavi/tcmb
Türkiye Cumhuriyeti Merkez Bankası (TCMB) Döviz Kurları
https://github.com/teknomavi/tcmb
Last synced: 3 months ago
JSON representation
Türkiye Cumhuriyeti Merkez Bankası (TCMB) Döviz Kurları
- Host: GitHub
- URL: https://github.com/teknomavi/tcmb
- Owner: teknomavi
- License: mit
- Created: 2015-02-11T23:02:57.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2022-01-11T15:54:21.000Z (about 3 years ago)
- Last Synced: 2024-10-02T15:08:44.722Z (4 months ago)
- Language: PHP
- Homepage:
- Size: 113 KB
- Stars: 66
- Watchers: 6
- Forks: 15
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome - teknomavi/tcmb - Türkiye Cumhuriyeti Merkez Bankası (TCMB) Döviz Kurları (PHP)
README
# T.C. Merkez Bankası Kur Kütüphanesi [](https://travis-ci.org/teknomavi/tcmb)
## Teknomavi\Tcmb Nedir?
T.C. Merkez Bankası tarafından https://www.tcmb.gov.tr/kurlar/today.xml adresinde yayınlanan güncel döviz kurlarını okumak için kullanılan açık kaynak bir PHP kütüphanesidir.
## Neler Yapılabilir?
Bu kütüphane ile günlük döviz kurları otomatik olarak çekilmektedir.
TCMB sitesinde yayınlanan tüm kurlar için mevcut "Alış", "Satış", "Efektif Alış" ve "Efektif Satış" değerlerine ulaşabilirsiniz.
## Nasıl Kullanılır?
Teknomavi\Tcmb Composer ile kurulabilir.
Projenizdeki `composer.json` dosyasında `require` bölümüne `"teknomavi/tcmb": "dev-master"` eklemeniz ve `composer update` komutunu çalıştırmanız yeterlidir.
Dilerseniz aşağıdaki komutu da çalıştırabilirsiniz.
```php
composer require teknomavi/tcmb
```
Composer kurulumu/kullanımı hakkında bilgiye ihtiyacınız varsa [bu bağlantıdaki](http://www.teknomavi.com/yazilim/php/composer-paket-yoneticisi-nedir-nasil-kurulur-nasil-kullanilir/) dökümanı incelebilirsiniz.
### Örnek Kod
Kütüphanenin en temel kullanımı aşağıdaki gibidir;
```php
use Teknomavi\Tcmb\Doviz;
$doviz = new Doviz();
echo " USD Alış:" . $doviz->kurAlis("USD");
echo " USD Satış:" . $doviz->kurSatis("USD");
echo " EURO Efektif Alış:" . $doviz->kurAlis("EUR", Doviz::TYPE_EFEKTIFALIS);
echo " EURO Efektif Satış:" . $doviz->kurSatis("EUR", Doviz::TYPE_EFEKTIFSATIS);
```
## Sıkça Sorulan Sorular
### Kütüphanenin Her Seferinde TCMB Üzerinden Data Çekmesi Nasıl Engellenir?
TCMB Sitesinden çekilen veriler, sınıfı oluştururken vereceğiniz bir `Doctrine\Common\Cache\CacheProvider` üzerinde tutulabilir.
Bu sayede her seferinde TCMB sitesinden çekilmeyeceği için performans artışı sağlanabilir.
Doctrine Cache hakkında detaylı bilgiye [buradan](http://doctrine-orm.readthedocs.org/en/latest/reference/caching.html) ulaşabilirsiniz.
Örnek: Doctrine Memcache CacheProvider ile kullanımı
```php
use Teknomavi\Tcmb\Doviz;
// Doctrine Memcache Init
$memcache = new Memcache();
$memcache->connect('localhost', 11211);
$cacheDriver = new \Doctrine\Common\Cache\MemcacheCache();
$cacheDriver->setMemcache($memcache);
// Doviz Kütüphanesi
$doviz = new Doviz($cacheDriver);
echo " USD Alış:" . $doviz->kurAlis("USD");
echo " USD Satış:" . $doviz->kurSatis("USD");
echo " EURO Efektif Alış:" . $doviz->kurAlis("EUR", Doviz::TYPE_EFEKTIFALIS);
echo " EURO Efektif Satış:" . $doviz->kurSatis("EUR", Doviz::TYPE_EFEKTIFSATIS);
```
### Doctrine\Common\Cache\CacheProvider harici bir önbellek yapısı kullanıyorum. Ne yapabilirim?
Sınıfın oluşturduğu data değişkenini `getData()` fonksiyonu kendiniz saklayıp, tekrar kullanacağınızda `setData($data)` fonksiyonu ile sınıfa tekrar verebilirsiniz.
Örnek: `json_encode`/`json_decode` ile önbelleğin bir dosyada tutulması
```php
$doviz = new \Teknomavi\Tcmb\Doviz();
// Cache Kodları Başlangıç
$fileName = dirname(__FILE__) . "/data.json";
if (file_exists($fileName)) {
$data = json_decode(file_get_contents($fileName), true);
$cacheValid = $doviz->setData($data);
} else {
$cacheValid = false;
}
if (!$cacheValid) {
file_put_contents($fileName, json_encode($doviz->getData()));
}
// Cache Kodları Bitiş
echo " USD Alış:" . $doviz->kurAlis("USD");
echo " USD Satış:" . $doviz->kurSatis("USD");
echo " EURO Efektif Alış:" . $doviz->kurAlis("EUR", \Teknomavi\Tcmb\Doviz::TYPE_EFEKTIFALIS);
echo " EURO Efektif Satış:" . $doviz->kurSatis("EUR", \Teknomavi\Tcmb\Doviz::TYPE_EFEKTIFSATIS);
```
Örnek: Laravel kullanarak `json_encode`/`json_decode` ile önbelleğin bir dosyada tutulması
```php
use Storage;
$doviz = new Doviz();
// Cache Kodları Başlangıç
$path = 'doviz-cache/doviz.json';
if (Storage::exists($path)) {
$data = json_decode(Storage::get($path), true);
$cache_valid = $doviz->setData($data);
} else {
$cache_valid = false;
}
if (!$cache_valid) {
Storage::put($path, json_encode($doviz->getData()));
}
// Cache Kodları Bitiş
echo " USD Alış:" . $doviz->kurAlis("USD");
echo " USD Satış:" . $doviz->kurSatis("USD");
echo " EURO Efektif Alış:" . $doviz->kurAlis("EUR", \Teknomavi\Tcmb\Doviz::TYPE_EFEKTIFALIS);
echo " EURO Efektif Satış:" . $doviz->kurSatis("EUR", \Teknomavi\Tcmb\Doviz::TYPE_EFEKTIFSATIS);
```