Sayfa yükleniyor

Destek Müşteri Girişi Sepet (0)

Ders 91 – Unit test’e giriş (PHPUnit)

PHPUnit ile birim testlerine giriş, temel assert metodları, test sınıfı iskeleti ve en sık yapılan hatalar. Adım adım örneklerle öğrenin.

Ders 91 – Unit test’e giriş (PHPUnit)

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, *Test ile 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: assertEquals tip dönüşümüne izin verirken, assertSame tip ve değer eşitliğini zorunlu kılar. Tip hassasiyeti önemliyse assertSame tercih 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 senaryoda expectException çağrısı yapılmazsa test başarısız olur.
  • Composer autoload eksikliği: require_once yerine autoload ayarları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.php uzantısıyla mı?
  • Her test metodunun adı test ile 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!

Paylaş

Yorumlar

Henüz onaylanmış yorum yok. İlk yorumu siz yazın.

Yorum yaz

Yorumunuz yönetici onayından sonra yayınlanır.

İlgili yazılar

Ders 100 – İleri yol haritası

PHP serisinin son dersinde ileri seviye konular, framework seçimi, Composer ekosistemi, mikro pro…

Ders 99 – Güvenli yapılandırma kontrol listesi

Üretim ortamı için PHP yapılandırma ayarlarını adım adım kontrol eden, hatasız ve güvenli bir yap…

Ders 98 – OpCache ve performans ipuçları

OpCache'ın çalışma prensibi, yapılandırma adımları ve gerçek dünyada performans artırmak için pra…

Ders 97 – Fibers’a kısa bakış (PHP 8.1)

PHP 8.1 ile gelen Fibers özelliğini adım adım öğrenin, kooperatif concurrency kavramını kavrayın …

Demo
Büyütülmüş Görsel