PHP ile Temiz Kod Yazmanın 7 Prensibi
20 Aralık 2024 · 5 dk okuma
Kod yazmak kolaydır. Ama okunabilir, sürdürülebilir ve başkasının (veya 6 ay sonra sizin) anlayabileceği kod yazmak zordur. İşte yıllardır PHP geliştirirken benimsediğim 7 prensip.
1. Anlamlı İsimlendirme
`$x`, `$data`, `$temp` gibi değişken isimlerinden kaçının. `$kullanici_adi`, `$siparis_tutari` gibi açıklayıcı isimler kullanın. Kodunuzu 6 ay sonra açtığınızda neyin ne olduğunu anında anlamalısınız.
2. Tek Sorumluluk Prensibi
Her fonksiyon sadece bir iş yapsın. 50 satırı geçen fonksiyonlarınız varsa, muhtemelen fazla iş yapıyordur. Parçalayın, bölün, sadeleştirin.
3. DRY (Don't Repeat Yourself)
Aynı kod bloğunu ikinci kez yazıyorsanız, durun ve bir fonksiyona çıkarın. Tekrar, hatanın davetiyesidir. Kendinizi kopyala-yapıştır yaparken yakalarsanız, orada bir fonksiyon doğuyor demektir.
4. Anlamlı Yorum Satırları
Yorum satırlarını "ne" yaptığınızı değil, "neden" yaptığınızı açıklamak için kullanın. Kod zaten ne yaptığını gösterir. Asıl merak edilen, o yola neden başvurduğunuzdur. İyi bir yorum, kodun ardındaki düşünceyi anlatır.
5. Sabit Değerleri Merkezileştirin
Veritabanı bağlantı bilgileri, site URL'si, API anahtarları gibi değerleri bir config dosyasında sabit olarak tanımlayın. Kodun içine gömmek, değişiklik anında size kabus yaşatır. Tek bir yerden yönetmek her zaman kazandırır.
6. Düzenli Refactor Edin
Çalışan koda dokunmayın derler. Ben katılmıyorum. Kodunuzu düzenli olarak gözden geçirin, sadeleştirin, gereksizleşen parçaları atın. Her refactor, kodu biraz daha olgunlaştırır. Bugün mükemmel görünen kod, yarın size yetersiz geliyorsa büyüyorsunuz demektir.
7. Sadeliği Kutsayın
Karmaşık çözümler zekice görünebilir. Ama asıl ustalık, karmaşık bir sorunu basit bir şekilde çözmektir. Kodunuzu sadeleştirmekten korkmayın. Az satır, çok iş. Her zaman en basit çözümü arayın; genellikle en doğrusu odur.