Download the PHP package denizgolbas/laravel-tcmb-gold without Composer
On this page you can find all versions of the php package denizgolbas/laravel-tcmb-gold. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download denizgolbas/laravel-tcmb-gold
More information about denizgolbas/laravel-tcmb-gold
Files in denizgolbas/laravel-tcmb-gold
Package laravel-tcmb-gold
Short Description TCMB XML Gold Rates Package for Laravel - TCMB Reeskont Kurları XML servisinden altın fiyatlarını çeken Laravel paketi
License MIT
Homepage https://github.com/denizgolbas/laravel-tcmb-gold
Informations about the package laravel-tcmb-gold
Laravel TCMB XML Gold Rates
TCMB (Türkiye Cumhuriyet Merkez Bankası) Reeskont Kurları XML servisinden altın fiyatlarını çeken Laravel paketi.
⚠️ Önemli Bilgi
Bu paket TCMB'nin saatlik yayınladığı Reeskont Kurları XML servisini kullanır. Bu serviste sadece alış fiyatı bulunur, satış fiyatı yoktur.
🏦 TCMB XML'inde Dönen Altın Türleri
TCMB Reeskont Kurları XML servisinde aşağıdaki altın türleri bulunmaktadır:
| Kod | Açıklama | Birim | Kullanım Alanı |
|---|---|---|---|
XAU |
24 Ayar Altın | 1 | TCMB tarafından belirlenen altın fiyatı |
XAS |
SAF (Has) Altın | 1 gram | Türkiye'deki kuyumculuk sektöründe referans fiyat |
XAU vs XAS Farkı
-
XAU (24 Ayar Altın): TCMB tarafından belirlenen 24 ayar altın fiyatıdır.
- XAS (SAF / Has Altın): TCMB'nin hesapladığı 1 gram saf (has) altın fiyatıdır. Türkiye'deki kuyumculuk sektöründe referans olarak kullanılır.
XML'de Dönen Tüm Alanlar
TCMB XML'inde her altın türü için aşağıdaki bilgiler döner:
doviz_cinsi_tabani: Base currency (genellikle "TRY")doviz_cinsi: Altın kodu (XAU veya XAS)birim: Birim değeri (her zaman 1)alis: Alış fiyatı (TL cinsinden, virgülle ayrılmış)
Not: TCMB Reeskont Kurları XML'inde sadece alış fiyatı bulunur, satış fiyatı yoktur.
🚀 Özellikler
-
🏦 TCMB Reeskont Kurları - Resmi altın fiyatları
-
⏰ Saatlik Güncelleme - Gün içinde 12:00, 14:00, 16:00 saatlerinde kontrol
-
💾 Önbellekleme - Performans için yapılandırılabilir cache (varsayılan 2 saat)
-
📊 Veritabanı Desteği - Opsiyonel olarak fiyatları kaydetme
- 🧪 Matrix Testler - PHP 8.1/8.2/8.3 + Laravel 10/11
📦 Kurulum
Config Dosyasını Publish Etme
Migration'ları Publish Etme (Opsiyonel)
🛠️ Kullanım
Temel Kullanım
Belirli Altın Türünü Alma
Belirli Bir Tarih İçin
Dönen Veri Yapısı
⚙️ Konfigürasyon
config/tcmb-gold.php:
🔗 XML Servisi Hakkında
URL Formatı
TCMB XML servisi şu URL formatını kullanır:
URL Yapısı:
{YYYYMM}: Yıl ve ay (örn: 202512){DDMMYYYY}: Gün, ay, yıl (örn: 09122025){HHMM}: Saat ve dakika (örn: 1200, 1400, 1600)
Örnek URL'ler:
Canlı Test: Tarayıcınızda veya terminal'de test edebilirsiniz:
XML Yapısı
TCMB XML'inde dönen tam yapı:
XML'de Dönen Tüm Altın Türleri:
XAU- 24 Ayar AltınXAS- SAF (Has) Altın
Not: TCMB Reeskont Kurları XML'inde sadece bu iki altın türü bulunmaktadır. Diğer değerli metaller (gümüş, platin, paladyum) bu serviste yer almaz.
🧪 Testler
Matrix Test Kapsamı
| PHP | Laravel 10 | Laravel 11 |
|---|---|---|
| 8.1 | ✅ | ❌ (PHP 8.2+ gerekli) |
| 8.2 | ✅ | ✅ |
| 8.3 | ✅ | ✅ |
Not: Laravel 11 PHP 8.2 veya üzeri gerektirir, bu yüzden PHP 8.1 ile Laravel 11 test edilmez.
📄 Lisans
MIT
🙏 Teşekkürler
- TCMB - Veri kaynağı