beyondcode/laravel-query-detector, Laravel uygulamalarında sık karşılaşılan N+1 sorgu problemini tespit etmeye yarayan bir geliştirici aracıdır. Paket, uygulama çalışırken yapılan sorguları izler ve olası N+1 durumlarını raporlar. Bu sayede geliştiriciler, veritabanı performansını olumsuz etkileyen gereksiz sorguları hızlıca fark edip düzeltebilir. Paket, özellikle geliştirme ve test aşamalarında kullanışlıdır; canlı ortamda kullanımı önerilmez.
Hangi ihtiyaçlarda değerlendirilebilir?
- Laravel ile geliştirme yapan ve uygulama performansını optimize etmek isteyen ekipler
- Veritabanı sorgu sayısını azaltarak yanıt sürelerini iyileştirmek isteyen geliştiriciler
- Eğitim ve kod inceleme süreçlerinde N+1 sorunlarını tespit etmek isteyen danışmanlar
Yaygın kullanım alanları
Geliştirme Ortamında Sorgu İzleme
Uygulama geliştirilirken paket aktif edilir ve her sayfa yüklemesinde kaç sorgu çalıştığı, N+1 riski olan ilişkiler görüntülenir. Böylece erken aşamada sorunlar yakalanır.
Kod İnceleme ve Refactoring
Mevcut bir projede paket geçici olarak çalıştırılıp hangi modellerde eager loading eksikliği olduğu tespit edilir. Bu sayede kod tabanında hedefli iyileştirmeler yapılabilir.
Eğitim ve Mentorluk
Laravel öğrenen geliştiricilere N+1 problemini somut örneklerle göstermek için paket kullanılabilir. Sorgu çıktıları üzerinden doğru kullanım anlatılabilir.
İncelenmesi gereken noktalar
- Paket yalnızca geliştirme ortamında kullanılmalıdır; canlı ortamda çalıştırmak performans kaybına ve gereksiz loglamaya neden olabilir.
- N+1 tespiti yalnızca Eloquent ORM üzerinden yapılan sorgular için geçerlidir; ham SQL sorguları veya query builder kullanımı kapsam dışı olabilir.
- Paketin sağladığı raporlar geliştiriciye yol gösterir, ancak her tespit edilen sorgu gerçek bir performans sorunu anlamına gelmeyebilir; bağlam değerlendirilmelidir.
WordPress.org
Kurulum ve geliştirme notları
Paket Composer ile kurulur ve Laravel uygulamasına servis sağlayıcı olarak kaydedilir. Kurulum sonrası yapılandırma dosyası yayınlanarak ayarlar özelleştirilebilir.
- 1Composer kullanarak paketi projeye ekleyin: composer require beyondcode/laravel-query-detector
- 2Laravel 5.5 ve üzeri için otomatik keşif sayesinde servis sağlayıcı otomatik kaydedilir; eski sürümlerde config/app.php dosyasına servis sağlayıcıyı manuel ekleyin.
- 3İsteğe bağlı olarak config/querydetector.php dosyasını yayınlamak için php artisan vendor:publish komutunu çalıştırın.
Paket, sorgu dinleyicileri kullanarak Eloquent sorgularını yakalar ve N+1 desenini tespit etmeye çalışır. Geliştiriciler, yapılandırma dosyasından hassasiyet ve loglama davranışını ayarlayabilir.
- Eloquent modellerdeki ilişkilerin yüklenme şeklini analiz eder.
- Tespit edilen N+1 sorgularını loglar veya ekranda gösterir.
- Yapılandırma ile belirli modelleri veya sorgu tiplerini hariç tutma imkanı sunar.
Hazır çözümün ötesinde
Özel geliştirme ne zaman değerlendirilebilir?
Laravel projelerinde N+1 sorgu sorunlarını tespit etmek ve performansı artırmak için ZeplinGo, projenizin ihtiyaçlarına özel çözümler geliştirir. Mevcut kod tabanınızı analiz eder, sorgu optimizasyonu ve mimari iyileştirmeler yaparız. Kurumsal Websitesi Paketi kapsamında da bu tür iyileştirmeler planlanabilir.
Ücretsiz ön çalışma isteyin →Değerlendirme soruları
Laravel Query Detector canlı ortamda kullanılabilir mi?
Genellikle önerilmez. Paket, geliştirme sırasında N+1 sorunlarını tespit etmek için tasarlanmıştır; canlı ortamda çalıştırmak ek yük oluşturabilir ve gereksiz loglara neden olabilir.
Paket hangi Laravel sürümlerini destekler?
Paket, Laravel 5.5 ve sonrası için otomatik keşif desteği sunar. Daha eski sürümlerde manuel servis sağlayıcı kaydı gerekebilir. Güncel sürümlerle uyumluluk için paketin resmi dokümantasyonu kontrol edilmelidir.
N+1 sorgu detektörü tüm sorgu tiplerini yakalar mı?
Paket, Eloquent ORM üzerinden yapılan sorguları izler. Ham SQL veya query builder ile yapılan sorgular kapsam dışı olabilir. Bu nedenle tespitler yalnızca Eloquent kullanımıyla sınırlıdır.
