← Blog'a Don
29 Günlük PHP Taktik Serisi

PHP’de Temiz Kod Yazma Taktikleri

1 ay once • 1 ay once • #113
PHP’de Temiz Kod Yazma Taktikleri

PHP’de Temiz Kod Yazma Taktikleri: Daha Okunabilir, Daha Bakımı Kolay Projeler

PHP ile yazılım geliştirmek keyifli ama bir noktadan sonra işler büyüdükçe kodun karmaşıklaşması kaçınılmaz oluyor. İşte tam bu noktada devreye temiz kod kavramı giriyor.

Temiz kod, sadece “güzel görünen” kod demek değil; sürdürülebilir, anlaşılır ve geliştirilebilir bir yazılımın temelidir. Bu yazıda PHP’de temiz kod yazma taktiklerini adım adım, örneklerle ve pratik bir bakış açısıyla inceleyeceğiz.

Temiz Kod Neden Bu Kadar Önemli?

Temiz kod yazmak aslında gelecekteki kendine ve ekip arkadaşlarına yapılmış bir iyilik gibi düşünebilirsin.

Bir projede şu sorular çok sık karşımıza çıkar:

  • Bu fonksiyon ne yapıyordu?

  • Bu değişken neden böyle isimlendirilmiş?

  • Burayı değiştirdiğimde başka neresi bozulur?

Temiz kod, bu soruların sayısını azaltır.

Avantajları:

  • Daha kolay bakım yapılır

  • Hatalar daha hızlı bulunur

  • Ekip çalışması daha verimli olur

  • Kod tekrarından kaçınılır

Özellikle PHP gibi web projelerinde sık kullanılan bir dilde temiz kod alışkanlığı, seni birkaç adım öne taşır.

PHP’de Temiz Kod Nerelerde Kullanılır?

Aslında cevap basit: Her yerde.

  • Laravel / Symfony gibi framework projelerinde

  • API geliştirmede

  • E-ticaret uygulamalarında

  • CMS sistemlerinde

  • Mikroservis mimarilerinde

Kod büyüdükçe temiz yazılmamış projeler “teknik borç” üretir ve geliştirme süreci yavaşlar.

Adım Adım PHP’de Temiz Kod Yazma Taktikleri

1. Anlamlı Değişken ve Fonksiyon İsimleri Kullan

Yeni başlayanların en sık yaptığı hata: kısa ve anlamsız isimler.

Kötü örnek:

1
$u = getData();

Temiz örnek:

1
$userList = getUsers();

Fonksiyonlarda da aynı mantık geçerli:

1
function calculateInvoiceTotal() { }

İsimler uzun olabilir ama açıklayıcı olmalı.

2. Fonksiyonlar Tek Bir İş Yapmalı

Clean Code felsefesinin en güçlü kurallarından biri:

Bir fonksiyon sadece tek bir sorumluluğa sahip olmalı.

Kötü örnek:

1
2
3
4
5
function registerUser($data) {
    saveToDatabase($data);
    sendWelcomeMail($data['email']);
    logActivity("User registered");
}

Temiz örnek:

1
2
3
4
5
function registerUser($data) {
    saveUser($data);
    sendWelcomeMail($data['email']);
    logUserRegistration();
}

Her şey daha okunabilir hale gelir.

3. Magic Number ve Hardcoded Değerlerden Kaçın

Kod içinde direkt sayı yazmak ileride kafa karıştırır.

Kötü:

1
2
3
if ($userAge > 18) {
    // ...
}

Temiz:

1
2
3
4
5
define("MINIMUM_AGE", 18);
 
if ($userAge > MINIMUM_AGE) {
    // ...
}

Bu küçük detay, kodun anlamını güçlendirir.

4. Kod Tekrarını Önle (DRY Prensibi)

DRY = Don’t Repeat Yourself

Aynı kodu iki kez yazıyorsan muhtemelen bir fonksiyon çıkarmalısın.

Kötü:

1
2
$total = $price + ($price * 0.18);
$total2 = $price2 + ($price2 * 0.18);

Temiz:

1
2
3
function addTax($price) {
    return $price * 1.18;
}

Değişiklik gerektiğinde tek yerden güncellersin.

5. Yorum Satırı Yerine Temiz Kod Yaz

Yeni başlayanlar çok yorum yazar ama aslında temiz kod yoruma ihtiyaç duymaz.

Kötü:

1
2
// kullanıcı yaşını kontrol et
if ($age > 18) { }

Temiz:

1
if ($user->isAdult()) { }

Kod zaten açıklıyor.

6. PHP’de Modern Özellikleri Kullan

Temiz kod yazmak için PHP’nin yeni sürümleri büyük avantaj sağlar.

Tip Tanımları:

1
2
3
function getUserById(int $id): User {
    // ...
}

Null Coalescing Operator:

1
$username = $_GET['user'] ?? 'guest';

Daha kısa, daha temiz.

7. Düzenli Dosya ve Klasör Yapısı Oluştur

Kod sadece satırlardan ibaret değil, proje yapısı da temiz olmalı.

Örneğin:

1
2
3
4
/Controllers
/Models
/Services
/Helpers

Laravel gibi framework’ler zaten bunu teşvik eder ama vanilla PHP’de de bu düzeni kurmak önemli.

Yeni Başlayanlar Nelere Dikkat Etmeli?

Temiz kod bir anda mükemmel yapılmaz, zamanla gelişir. Ama başlangıçta şu 3 şeye odaklanırsan çok yol alırsın:

  1. Kodun okunabilir olsun

  2. Fonksiyonları küçük tut

  3. Aynı işi tekrar yazma

En önemlisi:

Yazdığın kodu başkası okuyacakmış gibi düşün.

Bonus: Temiz Kod = Profesyonel Yazılımcı Refleksi

PHP’de temiz kod yazmak seni sadece daha iyi bir geliştirici yapmaz, aynı zamanda profesyonel projelerde güvenilir biri haline getirir.

Çünkü temiz kod:

  • Daha az bug üretir

  • Daha hızlı geliştirilir

  • Daha kolay ölçeklenir

Bu da seni bir adım ileri taşır.

Kısa Özet

Bu yazıda PHP’de temiz kod yazmanın temel taktiklerini ele aldık:

  • Anlamlı isimlendirme

  • Tek sorumluluk prensibi

  • Kod tekrarını önleme (DRY)

  • Magic number’dan kaçınma

  • Modern PHP özelliklerini kullanma

  • Daha okunabilir ve sürdürülebilir yapı kurma

Temiz kod, uzun vadede yazılımın kalitesini belirleyen en önemli faktörlerden biridir.

Peki sen kendi PHP projelerinde en çok hangi noktada kodun karmaşıklaştığını hissediyorsun? 👀

Benzer Konular