PHPackages yaknet/divan - 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. [Logging & Monitoring](/categories/logging) 4. / 5. yaknet/divan ActiveLibrary[Logging & Monitoring](/categories/logging) yaknet/divan ============ PHP hatalarını ve istisnalarını şairane Türkçe şiirler ve büyüleyici bir arayüzle sunan hata yönetim kütüphanesi. v1.1.2(2w ago)05↓66.7%MITPHPPHP ^8.2 Since Jun 1Pushed 2w agoCompare [ Source](https://github.com/y-packages/divan)[ Packagist](https://packagist.org/packages/yaknet/divan)[ RSS](/packages/yaknet-divan/feed)WikiDiscussions main Synced 1w ago READMEChangelogDependencies (12)Versions (5)Used By (0) YakNet Divan 🌹 (Şairane Hata Yönetim Kütüphanesi) ================================================= [](#yaknet-divan--şairane-hata-yönetim-kütüphanesi) [![PHP Version](https://camo.githubusercontent.com/962aced9b09d89716dbebf186ff899754a096ff1068b6b7988675c2d9fab9331/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253545382e322d626c75652e737667)](https://php.net)[![Aesthetics](https://camo.githubusercontent.com/82b9164c4ee6caebbd2f1f74aeef683fff49226ccf7ca0fe551cc5bee3052c4a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f64657369676e2d7072656d69756d2d707572706c652e737667)](https://yakhub.com.tr)[![AI Powered](https://camo.githubusercontent.com/fe54086f990cbc048e3f84ccde8386e4ffd23a7295d1097cdbf00309c14c8341/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f41492d47656d696e69253230506f65742d676f6c642e737667)](https://gemini.google.com) **YakNet Divan**, geleneksel PHP hata sayfalarının o soğuk, ürkütücü ve ruhsuz yapısından sıkılan yazılımcılar için geliştirilmiş, PHP hatalarını ve istisnalarını (exceptions) derin, duygusal ve kimi zaman da eğlenceli Türkçe şiirlerle (gazel, rubai veya serbest nazım) süsleyip sunan premium bir hata yönetim kütüphanesidir. ✍️ Şairane Ekosistem Terimleri ------------------------------ [](#️-şairane-ekosistem-terimleri) Kütüphanemiz, tüm teknik hata bileşenlerini edebiyat dünyasından terimlerle eşleştirir: - **Dosya (File) ➔ Şiir:** Her kod dosyası dergahımızda yazılmış birer şiirdir (örn: `index.php Şiiri`). - **Satır (Line) ➔ Mısra:** Hatanın gerçekleştiği satır, şiirin hırpalanmış bir mısrasıdır (örn: `45. Mısra`). - **Hata Satırı ➔ Kırık Mısra:** Hatanın tam gerçekleştiği satır arayüzümüzde kırmızı güller ve hat çizgileriyle sarılmış "Kırık Mısra" olarak adlandırılır. > *"Ey fani, 'index.php' şiirinin 45. mısrasında dertli bir duraksama husule geldi..."* --- 🚀 Öne Çıkan Özellikler ---------------------- [](#-öne-çıkan-özellikler) - **🧠 Divan Poet Brain (Gemini AI):** Gemini API (`gemini-2.5-flash` modeli) aracılığıyla, gerçekleşen hatanın sınıfına, mesajına, dosyasına (şiirine) ve satırına (mısrasına) göre tamamen özelleştirilmiş, sanatsal quatrainler (kıtalar) üretir. - **📚 Zengin Çevrimdışı Şiir Kitaplığı:** Gemini API anahtarı veya internet bağlantısı olmadığında devreye giren; *Division by Zero, Parse Error, Type Error, PDOException (Veritabanı hasreti)* gibi birçok yaygın hata türü için özel olarak kaleme alınmış şairane şiir fallbacks sistemi. - **🌹 Gül Yapraklı Glassmorphism Arayüzü:** Koyu mor, derin gece gökyüzü temalı ve yıldızlı arka plan üzerinde, CSS animasyonlarıyla süzülen gül yaprakları ve klasik hat sanatından ilham alan premium bir sayfa tasarımı. - **⚙️ Whoops (uhoox) Entegrasyonu:** Projelerinde Whoops kullanan yazılımcılar için tek adımda şairane hata sayfasına ve istendiğinde tek tıkla standart Whoops teknik sayfasına geçiş sağlayan çift yönlü Handler. --- 📦 Kurulum --------- [](#-kurulum) Composer ile kütüphaneyi projenize dahil edin: ``` composer require yaknet/divan ``` --- 🛠️ Kullanım Şekilleri --------------------- [](#️-kullanım-şekilleri) ### 1. Bağımsız (Standalone) Kullanım [](#1-bağımsız-standalone-kullanım) Projenizin giriş noktasında (örn: `index.php` veya `bootstrap.php`) Divan hata yöneticisini kaydetmeniz yeterlidir: ``` use YakNet\Divan\Core\Divan; // Divan'ı başlat Divan::register([ 'gemini_api_key' => $_ENV['GEMINI_API_KEY'] ?? '', // AI şiirleri için isteğe bağlı 'active' => true // .env'den okumak için belirtmeyebilirsiniz ]); ``` ### 2. Whoops (uhoox) ile Entegre Kullanım [](#2-whoops-uhoox-ile-entegre-kullanım) Eğer uygulamanızda `filp/whoops` kullanıyorsanız, Divan'ı Whoops'a bir Handler olarak ekleyebilirsiniz: ``` use Whoops\Run; use Whoops\Handler\PrettyPageHandler; use YakNet\Divan\Whoops\DivanHandler; $whoops = new Run; // 1. Şairane Divan Handler'ı ekle $whoops->pushHandler(new DivanHandler([ 'gemini_api_key' => $_ENV['GEMINI_API_KEY'] ?? '' ])); // 2. Teknik Whoops Handler'ını ekle (Toggled fallback) $whoops->pushHandler(new PrettyPageHandler); $whoops->register(); ``` Bu sayede, `.env` dosyasındaki durumuna göre hatalar şairane sayfa ile gösterilir. Şairane hata sayfasındaki **"Standart Detaylı Hata Sayfasına (Whoops) Git"** butonuna basıldığında teknik Whoops ekranı saniyeler içinde karşınıza gelir. --- ⚙️ Çevresel Ayarlar (.env) -------------------------- [](#️-çevresel-ayarlar-env) Projenizin kök dizinindeki `.env` dosyasında şu değişkenleri tanımlayabilirsiniz: ``` # Gemini API Anahtarı (Canlı şiir üretimi için) GEMINI_API_KEY=AIzaSy... # Şairane hataları açıp kapatmak için (true/false) POETIC_ERRORS=true ``` - `POETIC_ERRORS=true` ise: Hatalar göz kamaştırıcı Divan şiirleriyle süslenir. - `POETIC_ERRORS=false` ise: Divan sessizce arka plana çekilir ve projenizdeki standart hata yöneticileri (Whoops vb.) devreye girer. --- 🛡️ Sentinel ile Uyum Entegrasyonu --------------------------------- [](#️-sentinel-ile-uyum-entegrasyonu) YakNet Sentinel kullanan projelerde, Sentinel arayüzünde şairane açıklama almak veya doğrudan Divan şablonunu kullanmak için Sentinel'e Divan desteğini entegre edebilirsiniz. Sentinel'in `templates/error_page.php` şablonu veya hata yakalayıcısı Divan kurulu olduğunda bunu tespit ederek zenginleştirilmiş çıktılar sunacaktır. --- 📜 Lisans -------- [](#-lisans) Bu proje **YakNet Bilişim** tarafından geliştirilmiştir ve MIT Lisansı ile korunmaktadır. "Hataları dert etmeyin, bir taksim dinleyip şiir okuyun." 🌹 ### Health Score 41 — FairBetter than 87% of packages Maintenance96 Actively maintained with recent releases Popularity5 Limited adoption so far Community6 Small or concentrated contributor base Maturity49 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 Every ~12 days Total 4 Last Release 17d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/236650944?v=4)[yakistir98](/maintainers/yakistir98)[@yakistir98](https://github.com/yakistir98) --- Top Contributors [![yaknetbilisim](https://avatars.githubusercontent.com/u/242705004?v=4)](https://github.com/yaknetbilisim "yaknetbilisim (3 commits)") --- Tags aierror handlingGeminiyaknetwhoops handlerpoetrydivan ### Code Quality Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/yaknet-divan/health.svg) ``` [![Health](https://phpackages.com/badges/yaknet-divan/health.svg)](https://phpackages.com/packages/yaknet-divan) ``` ### Alternatives [tempest/framework The PHP framework that gets out of your way. 2.2k34.4k16](/packages/tempest-framework)[phlak/directory-lister PHP directory lister 2.5k1.4k](/packages/phlak-directory-lister)[cognesy/instructor-php The complete AI toolkit for PHP: unified LLM API, structured outputs, agents, and coding agent control 326123.0k1](/packages/cognesy-instructor-php)[spectra-php/laravel-spectra Comprehensive observability for AI/LLM operations in Laravel applications 182.9k](/packages/spectra-php-laravel-spectra)[lion/bundle Lion-framework configuration and initialization package 122.4k4](/packages/lion-bundle) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)