PHP Birim Testi (Unit Testing): En İyi Uygulamalar

Tenshi Rei · 16 Eki 2025

Birim testi, yazdığınız PHP 8 kodunun güvenilirliğini ve sürdürülebilirliğini garanti altına almanın en kritik yoludur. Bu bölümde, etkili testler yazmanıza yardımcı olacak araçlar, teknikler ve stratejiler dahil olmak üzere, PHP birim testlerinin en iyi uygulamalarına odaklanacağız.

Birim Testi Neden Bu Kadar Önemli?

Birim testi, kodunuzu tipik olarak fonksiyonlar veya metotlar gibi daha küçük parçalara ayırıp, her birini diğerlerinden bağımsız olarak test etme sürecidir. Temel amaç, kodun tekil birimlerinin beklediğiniz gibi çalıştığını doğrulamaktır. İşte birim testini vazgeçilmez kılan nedenler:

Hataları Erken Yakalama: Geliştirmenin erken aşamalarında bug'ları ve sorunları tespit etmenizi sağlar. Bu da, ilerleyen aşamalarda hata ayıklama (debugging) için harcayacağınız maliyeti ve çabayı ciddi ölçüde azaltır.
Kod Kalitesini Yükseltme: Test yazmak, daha iyi bir kod tasarımı yapmaya teşvik eder; bu da kod tabanınızı daha modüler ve yönetilebilir hale getirir.
Dokümantasyon Görevi Görme: Birim testleri, aynı zamanda kodunuzun nasıl kullanılması gerektiğine dair canlı örnekler sunarak bir tür otomatik dokümantasyon işlevi görür.
Regresyonu Engelleme: Kodunuzda yaptığınız değişikliklerin veya eklemelerin, daha önce çalışan özellikleri bozmadığından emin olmak için bir güvenlik ağı görevi görür.
Sürekli Entegrasyon (CI): Otomatikleştirilmiş birim testlerini geliştirme süreçlerinize entegre edebilirsiniz. Böylece, koda her commit yaptığınızda testler otomatik olarak çalışır.
Birim Testi Çatısı (Framework) Seçimi

PHP ekosistemi birkaç test çatısı sunsa da, PHPUnit açık ara en yaygın kullanılan ve en çok desteklenen çözümdür. PHPUnit'i Composer ile kolayca kurabilir ve testlerinizi yazmak ve çalıştırmak için zengin özelliklere sahip bir ortam elde edebilirsiniz.

Bash
composer require --dev phpunit/phpunit

Test Edilebilir Kod Yazmanın Yolları

Etkili birim testleri yazabilmek için kodunuzun da test edilebilir olması şarttır. İşte bu amaca ulaşmanızı sağlayacak temel prensipler:
1. Sorumlulukları Ayırma (Separation of Concerns): Kodunuzun Tek Sorumluluk Prensibine (SRP) uymasına dikkat edin. Yani, her fonksiyonun veya metodun tek ve net bir görevi olmalıdır.
2. Bağımlılık Enjeksiyonu (Dependency Injection): Sınıf bağımlılıklarını sınıf içinde sabit kodlamak yerine, Bağımlılık Enjeksiyonu kullanarak dışarıdan enjekte edin. Bu, test sırasında bu bağımlılıkları sahte nesnelerle (mock objects) değiştirebilmenizi sağlar.
3. Global Durumdan Kaçınma: Global durum kullanımını en aza indirin. Global durum, birim testlerini yazmayı zorlaştırır. Bunun yerine, parametreleri veya bağımlılık enjeksiyonunu kullanın.
4. Birimleri İzole Etme: Test yazarken, aynı anda yalnızca tek bir kod birimini test etmeye odaklanın. Test ettiğiniz birimi, harici bağımlılıklardan tamamen izole edin.
5. İlk Birim Testinizi Yazma
Birim testini göstermek için basit bir örnek oluşturalım. Elimizde add metodu olan bir Calculator sınıfı olduğunu varsayalım:

[CODE title="PHP"]class Calculator {
public function add($a, $b) {
return $a + $b;
}
}[/CODE]

Şimdi, bu add metodu için PHPUnit kullanarak bir birim testi yazabiliriz:

[CODE title="PHP"]use PHPUnit\Framework\TestCase;

class CalculatorTest extends TestCase {
public function testAdd() {
// Calculator sınıfının bir örneğini (instance) oluşturuyoruz.
$calculator = new Calculator();

// add metodunu çağırıp sonucu alıyoruz.
$result = $calculator->add(2, 3);

// Sonucun beklediğimiz değer olan 5'e eşit olduğunu iddia (assert) ediyoruz.
$this->assertEquals(5, $result);
}
}[/CODE]

Bu test senaryosunda, Calculator sınıfından bir nesne oluşturuyor, add metodunu 2 ve 3 argümanlarıyla çağırıyor ve sonucun gerçekten 5 olup olmadığını kontrol ediyoruz.

Birim Testlerini Çalıştırma

Testlerinizi çalıştırmak için terminalde phpunit komutunu kullanabilirsiniz:

[CODE title="PHP"]vendor/bin/phpunit CalculatorTest.php[/CODE]

PHPUnit, testi çalıştıracak ve testin geçip geçmediğini (passed/failed) belirten bir özet sunacaktır.

Bu bölümde, birim testinin önemini vurguladık ve PHPUnit kullanarak bir testin nasıl yazılıp çalıştırılacağını gösteren basit bir örnek sunduk. İlerleyen bölümlerde PHPUnit'in daha gelişmiş özelliklerini ve test tekniklerini derinlemesine inceleyeceğiz.