{"id":16409697,"url":"https://github.com/mlevent/tcmb","last_synced_at":"2026-05-14T22:05:29.722Z","repository":{"id":191465927,"uuid":"684863247","full_name":"mlevent/tcmb","owner":"mlevent","description":"TCMB Döviz Kurları ve Kur Çevirici","archived":false,"fork":false,"pushed_at":"2023-08-30T02:35:13.000Z","size":7,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-07-11T06:05:13.277Z","etag":null,"topics":["currency","doviz","exchange-rates","tcmb"],"latest_commit_sha":null,"homepage":"https://mlevent.github.io/tcmb","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mlevent.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-08-30T02:20:39.000Z","updated_at":"2024-08-14T03:33:27.000Z","dependencies_parsed_at":null,"dependency_job_id":"87577144-b5a1-4170-8cb1-0c6e11edbfc6","html_url":"https://github.com/mlevent/tcmb","commit_stats":null,"previous_names":["mlevent/tcmb"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/mlevent/tcmb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlevent%2Ftcmb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlevent%2Ftcmb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlevent%2Ftcmb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlevent%2Ftcmb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mlevent","download_url":"https://codeload.github.com/mlevent/tcmb/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mlevent%2Ftcmb/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33045151,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-13T13:14:54.681Z","status":"online","status_checked_at":"2026-05-14T02:00:06.663Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["currency","doviz","exchange-rates","tcmb"],"created_at":"2024-10-11T06:20:54.886Z","updated_at":"2026-05-14T22:05:29.705Z","avatar_url":"https://github.com/mlevent.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch2 align=\"center\"\u003e💸 TCMB Döviz Kurları\u003c/h2\u003e\n\u003cp align=\"center\"\u003eTCMB'ı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.\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://img.shields.io/packagist/dependency-v/mlevent/tcmb/php?style=plastic\"/\u003e\n\u003cimg src=\"https://img.shields.io/packagist/v/mlevent/tcmb?style=plastic\"/\u003e\n\u003cimg src=\"https://img.shields.io/github/last-commit/mlevent/tcmb?style=plastic\"/\u003e\n\u003cimg src=\"https://img.shields.io/github/issues/mlevent/tcmb?style=plastic\"/\u003e\n\u003cimg src=\"https://img.shields.io/packagist/dt/mlevent/tcmb?style=plastic\"/\u003e\n\u003cimg src=\"https://img.shields.io/github/stars/mlevent/tcmb?style=plastic\"/\u003e\n\u003cimg src=\"https://img.shields.io/github/forks/mlevent/tcmb?style=plastic\"/\u003e\n\u003c/p\u003e\n\n### Kurulum\n\n🛠️ Paketi composer ile projenize dahil edin;\n\n```bash\ncomposer require mlevent/tcmb\n```\n\n### Örnek Kullanım\n\n```php\nuse Mlevent\\Tcmb\\Tcmb;\n\n$tcmb = new Tcmb;\n\n// Dolar kuruna ait detaylar\nvar_dump($tcmb-\u003eget('USD'));\n\n// Bu kullanım da aynı sonucu verecektir\nvar_dump($tcmb-\u003egetUsd());\n```\n\nBu örnek, aşağıdaki gibi bir `Currency` nesnesi döndürecektir;\n\n```php\nMlevent\\Tcmb\\Currency Object\n(\n    [currencyCode]    =\u003e USD\n    [currencyName]    =\u003e US DOLLAR\n    [currencyAlias]   =\u003e ABD DOLARI\n    [forexBuying]     =\u003e 27.0254\n    [forexSelling]    =\u003e 27.0741\n    [banknoteBuying]  =\u003e 27.0065\n    [banknoteSelling] =\u003e 27.1147\n    [crossRateUSD]    =\u003e\n    [crossRateOther]  =\u003e\n)\n```\n\nNesne elemanlarına ulaşmak için;\n\n```php\necho $tcmb-\u003egetUsd()-\u003eforexSelling; // 27.0741\n```\n\n### Geçmiş Tarihli Veriler\n\nTcmb'nin sağladığı geçmiş tarihli kur verilerine de ulaşabilirsiniz;\n\n```php\n$tcmb = (new Tcmb)-\u003esetDate('16/05/2022');\n```\n\n\u003e Belirtilen tarih haftasonu veya resmi tatillere denk geliyorsa, kur bilgisi dönmeyecektir.\n\n### Kur Dönüştürme\n\nPara birimlerini dönüştürmek için;\n\n```php\necho $tcmb-\u003econvert('USD', 'TRY'); // 27.0741\n```\n\nAşağıdaki şu kullanım da aynı sonucu verecektir;\n\n```php\necho $tcmb-\u003econvertUsdTry(10); // 270.741\n```\n\n### Cache\n\nPerformans 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;\n\n```php\nuse Mlevent\\FileCache\\FileCache;\nuse Mlevent\\Tcmb\\Tcmb;\n\n$tcmb = new Tcmb;\n\n// Veriler 60 saniye boyunca diskte saklanacak\n$data = (new FileCache)-\u003erefresh('exchange-rates', function () use ($tcmb) {\n    return $tcmb-\u003efetchExchangeRates();\n}, 60);\n\n// Veri içe aktarılıyor\n$tcmb-\u003esetExchangeRates($data);\n\necho $tcmb-\u003egetUsd()-\u003eforexSelling; // 27.0741\n```\n\n### Ekstra\n\nKullanılabilecek diğer metodlar;\n\n```php\n/**\n * Döviz Listesi\n * @return array\n */\n$tcmb-\u003egetCurrencies();\n\n/**\n * Tüm Döviz Cinslerine Ait Kur Bilgileri\n * @return array\n */\n$tcmb-\u003egetExchangeRates();\n\n/**\n * TCMB Bülten Yayınlanma Tarihi\n * @return string\n */\n$tcmb-\u003egetBulletinDate();\n\n/**\n * TCMB Bülten Numarası\n * @return string\n */\n$tcmb-\u003egetBulletinNumber();\n```\n\n### Para Birimleri\n\nTCMB'ın verilerini yayınladığı para birimleri;\n\n|     | Adı                    | Kodu |     |     | Adı                               | Kodu |\n| :-: | :--------------------- | :--: | --- | :-: | :-------------------------------- | :--: |\n| 🇺🇸  | ABD Doları             | USD  |     | 🇦🇿  | Azerbaycan Yeni Manata            | AZN  |\n| 🇪🇺  | Euro                   | EUR  |     | 🇦🇪  | Birleşik Arap Emirlikleri Dirhemi | AED  |\n| 🇬🇧  | İngiliz Sterlini       | GBP  |     | 🇩🇰  | Danimarka Kronu                   | DKK  |\n| 🇯🇵  | Japon Yeni             | JPY  |     | 🇸🇪  | İsveç Kronu                       | SEK  |\n| 🇷🇺  | Rus Rublesi            | RUB  |     | 🇰🇼  | Kuveyt Dinarı                     | KWD  |\n| 🇸🇦  | Suudi Arabistan Riyali | SAR  |     | 🇳🇴  | Norveç Kronu                      | NOK  |\n| 🇨🇭  | İsviçre Frangı         | CHF  |     | 🇷🇴  | Rumen Leyi                        | RON  |\n| 🇦🇹  | Avustralya Doları      | AUD  |     | 🇮🇷  | İran Riyali                       | IRR  |\n| 🇨🇦  | Kanada Doları          | CAD  |     | 🇵🇰  | Pakistan Rupisi                   | PKR  |\n| 🇨🇳  | Çin Yuanı              | CNY  |     | 🇶🇦  | Katar Riyali                      | QAR  |\n| 🇧🇬  | Bulgar Levası          | BGN  |     | 🇰🇷  | Güney Kore Wonu                   | KRW  |\n\n### 📧İletişim\n\nİletişim için ghergedan@gmail.com adresine e-posta gönderin.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmlevent%2Ftcmb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmlevent%2Ftcmb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmlevent%2Ftcmb/lists"}