phpstan/phpstan-deprecation-rules, PHPStan statik analiz aracı için ek kurallar sağlayan bir pakettir. Bu kurallar, kodunuzda kullanımdan kaldırılmış (deprecated) sınıfların, yöntemlerin, özelliklerin, sabitlerin ve trait'lerin kullanımını tespit eder. Böylece eski API'lere bağımlılıkları erken aşamada yakalayarak, yazılımınızın bakımını kolaylaştırır ve gelecekteki sürüm yükseltmelerinde oluşabilecek sorunları önler. Paket, Packagist üzerinde 94 milyondan fazla indirilme sayısıyla yaygın olarak tercih edilmektedir.
Hangi ihtiyaçlarda değerlendirilebilir?
- PHP projelerinde düzenli statik analiz yapan ve kod kalitesini ölçmek isteyen geliştiriciler
- Eski PHP sürümlerinden veya framework sürümlerinden yeni sürümlere geçiş sürecinde olan ekipler
- Bağımlılık güncellemelerini güvenli bir şekilde yönetmek isteyen yazılım ekipleri
Yaygın kullanım alanları
Sürüm Yükseltme Öncesi Kod Taraması
Bir framework veya kütüphane sürümünü yükseltmeden önce, mevcut kod tabanında kullanımdan kaldırılmış API'lerin kullanımını tespit ederek güncelleme riskini azaltabilirsiniz.
Sürekli Entegrasyon (CI) Sürecinde Kalite Kapısı
CI/CD hattınıza deprecation kurallarını ekleyerek, yeni eklenen kodların eski API'ler kullanmasını engelleyebilir ve kod tabanınızın modern kalmasını sağlayabilirsiniz.
Eski Kodun Modernizasyonu
Uzun süredir bakımı yapılmamış bir projede, kullanımdan kaldırılmış tüm kullanımları raporlayarak yeniden düzenleme (refactoring) çalışmalarını önceliklendirebilirsiniz.
İncelenmesi gereken noktalar
- Bu paket, PHPStan'ın bir eklentisidir; çalışması için PHPStan'ın kurulu ve yapılandırılmış olması gerekir.
- Kurallar yalnızca statik analiz sağlar; çalışma zamanı davranışını etkilemez, bu nedenle dinamik kullanımları (örneğin değişken yöntem çağrıları) tam olarak yakalayamayabilir.
- Kullanımdan kaldırılmış API'lerin tespiti, bağımlılıkların sürümlerine göre değişebilir; bu nedenle güncel bağımlılık sürümleriyle uyumlu bir PHPStan sürümü kullanılmalıdır.
WordPress.org
Kurulum ve geliştirme notları
Paket, Composer ile kolayca kurulabilir ve PHPStan yapılandırmasına eklenir. Resmi kurulum adımları sağlanmamıştır; ancak genel olarak Composer ile kurulum ve PHPStan config dosyasına ekleme yapılır.
Geliştirme sürecinde, paketin kurallarını PHPStan analizine dahil ederek kullanımdan kaldırılmış kod kullanımlarını tespit edebilirsiniz. Resmi geliştirme dokümantasyonu sağlanmamıştır; ancak paketin kullanımı PHPStan'ın yapılandırmasına bağlıdır.
Hazır çözümün ötesinde
Özel geliştirme ne zaman değerlendirilebilir?
ZeplinGo olarak, PHP projelerinizde statik analiz süreçlerini tasarlamanıza ve bu tür kuralları mevcut geliştirme akışınıza entegre etmenize yardımcı olabiliriz. Kurumsal Websitesi Paketi kapsamında, kod kalitesi ve bakım stratejilerinizi birlikte planlayabiliriz.
Ücretsiz ön çalışma isteyin →Değerlendirme soruları
phpstan/phpstan-deprecation-rules paketi ne işe yarar?
Bu paket, PHPStan statik analiz aracına kullanımdan kaldırılmış (deprecated) sınıf, yöntem, özellik, sabit ve trait kullanımlarını tespit eden ek kurallar ekler. Böylece kod tabanınızdaki eski API kullanımlarını otomatik olarak belirleyebilirsiniz.
Bu paketi kullanmak için PHPStan kurulu olmalı mı?
Evet, bu paket bir PHPStan eklentisidir. Çalışabilmesi için projenizde PHPStan'ın kurulu ve yapılandırılmış olması gerekir.
Bu kurallar hangi tür kullanımları tespit eder?
Kurallar, kullanımdan kaldırılmış sınıfları, yöntemleri, özellikleri, sabitleri ve trait'leri tespit eder. Bu sayede eski API'lere olan bağımlılıkları belirleyerek modernizasyon çalışmalarını kolaylaştırır.
