Yazılım geliştirme sürecinde kodun doğru çalıştığını güvenilir bir şekilde kanıtlamak, hataları erken yakalamak ve bakım maliyetlerini düşürmek açısından kritik bir adımdır. Unit testleri bu amaca hizmet eden en temel araçlardan biridir. Bu derste, PHP ekosisteminin en popüler test çerçevesi PHPUnit ile tanışacak, assertSame gibi temel doğrulama metodlarını öğrenecek ve test sınıflarının iskeletini adım adım oluşturacaksınız.
Temel Kavramlar ve Hazırlık
Unit testleri, Arrange‑Act‑Assert (AAA) desenini izler:
- Arrange: Test ortamını, girdileri ve gerekli nesneleri hazırlayın.
- Act: Test edilen kodu çalıştırın.
- Assert: Çıktıyı beklenen değerle karşılaştırın.
PHPUnit'i projenize eklemek için Composer kullanmanız önerilir. Aşağıdaki komut, phpunit/phpunit paketini dev bağımlılığı olarak kurar:
composer require --dev phpunit/phpunit ^10
Kurulum tamamlandıktan sonra vendor/bin/phpunit komutuyla testlerinizi çalıştırabilirsiniz.
Adım Adım İlk Testinizi Yazın
İlk örnek, basit bir toplama işlemini doğrulayan bir test metodudur. Aşağıdaki kodu tests/MatematikTest.php dosyasına kaydedin ve vendor/bin/phpunit ile çalıştırın.
<?php
use PHPUnit\Framework\TestCase;
class MatematikTest extends TestCase
{
public function testToplam(): void
{
$this->assertSame(4, 2 + 2);
}
}
?>
Test başarılı bir şekilde geçer; assertSame hem değeri hem de tipini kontrol eder, yani 4 (int) ve 4.0 (float) eşit sayılmaz.
Daha Gerçekçi Bir Örnek: Sınıf Metodu Testi
Şimdi, bir sınıfın iş mantığını test eden bir örnek oluşturalım. src/Calculator.php dosyasına aşağıdaki basit hesap makinesi sınıfını ekleyin:
<?php
class Calculator
{
public function add(int $a, int $b): int
{
return $a + $b;
}
public function divide(int $numerator, int $denominator): float
{
if ($denominator === 0) {
throw new InvalidArgumentException('Bölen sıfır olamaz.');
}
return $numerator / $denominator;
}
}
?>
Bu sınıfı test etmek için tests/CalculatorTest.php dosyasını oluşturun:
<?php
use PHPUnit\Framework\TestCase;
require_once __DIR__ . '/../src/Calculator.php';
class CalculatorTest extends TestCase
{
private Calculator $calc;
protected function setUp(): void
{
$this->calc = new Calculator();
}
public function testAdd(): void
{
$this->assertSame(7, $this->calc->add(3, 4));
}
public function testDivide(): void
{
$this->assertSame(2.5, $this->calc->divide(5, 2));
}
public function testDivideByZeroThrowsException(): void
{
$this->expectException(InvalidArgumentException::class);
$this->calc->divide(10, 0);
}
}
?>
Bu test sınıfı üç farklı senaryoyu kapsar:
- Doğru toplama sonucu.
- Ondalık bölme sonucu.
- Sıfıra bölme durumunda beklenen istisna.
Komut satırında vendor/bin/phpunit tests/CalculatorTest.php çalıştırdığınızda, tüm testlerin PASS olduğunu görmelisiniz.
Sık Karşılaşılan Hatalar ve Çözüm Önerileri
- Test sınıfı ismi hatalı: PHPUnit,
*Testile biten sınıfları otomatik olarak bulur. Dosya adı ve sınıf adı aynı kalıba uymalıdır. - assert metodunu yanlış seçmek:
assertEqualstip dönüşümüne izin verirken,assertSametip ve değer eşitliğini zorunlu kılar. Tip hassasiyeti önemliyseassertSametercih edin. - setUp/tearDown eksikliği: Tekrarlanan nesne oluşturma kodunu
setUp()içine koymak, testlerin okunurluğunu artırır ve performansı iyileştirir. - İstisna testinde eksik
expectException: İstisna beklenen bir senaryodaexpectExceptionçağrısı yapılmazsa test başarısız olur. - Composer autoload eksikliği:
require_onceyerineautoloadayarlarını kullanın (composer dump-autoload) böylece dosya yolları karmaşıklaşmaz.
Kontrol Listesi ve İpuçları
- Test dosyası
tests/klasöründe*Test.phpuzantısıyla mı? - Her test metodunun adı
testile mi başlıyor? - Arrange‑Act‑Assert düzenine sadık kalıyor musunuz?
- Girdi doğrulaması ve istisna kontrolleri test senaryolarına dahil edildi mi?
- Üretim ortamında hata mesajlarını doğrudan kullanıcıya göstermiyor musunuz?
Sık Sorulan Sorular
1. PHPUnit ile entegrasyon için IDE ayarları gerekli mi?
Hayır, komut satırı üzerinden vendor/bin/phpunit çalıştırmak yeterlidir. Ancak birçok IDE (PhpStorm, VS Code) testleri tek tuşla çalıştırma özelliği sunar; bu, geliştirme hızını artırır.
2. assertSame yerine assertEquals ne zaman kullanılmalı?
Eğer tip dönüşümüne izin vermek istiyorsanız assertEquals tercih edebilirsiniz. Örneğin, veri tabanından gelen string "5" ile int 5'i karşılaştırmak için assertEquals uygundur.
3. Testleri CI/CD pipeline'ına eklemek zor mu?
Genellikle phpunit komutu, CI araçları (GitHub Actions, GitLab CI, Jenkins) içinde bir adım olarak tanımlanır. Başarısız testler, build'in durdurulmasını sağlar ve hataların erken fark edilmesini temin eder.
Özet
Bu derste, PHPUnit ile birim testlerine giriş yaptık, assertSame kullanarak değer ve tip eşitliğini nasıl kontrol edeceğimizi gördük, test sınıfı iskeletini oluşturduk ve gerçek bir sınıfın metodlarını nasıl test edeceğimizi adım adım uyguladık. Sık yapılan hataları ve bunların önüne geçmek için ipuçlarını inceleyerek, test yazma sürecinizi daha güvenli ve sürdürülebilir bir hâle getirebilirsiniz. Unutmayın, testler yalnızca kodun doğru çalıştığını kanıtlamakla kalmaz, aynı zamanda kodun yeniden yapılandırılmasını (refactoring) risk almadan yapabilmenizi sağlar. Şimdi öğrendiklerinizi kendi projelerinizde uygulamaya başlayın!
Yorumlar
Henüz onaylanmış yorum yok. İlk yorumu siz yazın.
Yorum yaz
Yorumunuz yönetici onayından sonra yayınlanır.