PHP kodunu PHPUnit ile nasıl test edersiniz?

Question

Accepted Answer

**PHPUnit**, PHP için standart test çerçevesidir — kod doğru şekilde davranışını doğrulayan birim ve entegrasyon testleri yazabilirsiniz. Bağımlılık enjeksiyonu (mock'lama için) ve veri sağlayıcıları gibi araçlar ile birleştirildiğinde, kapsamlı ve bakımlanabilir test yazma imkanı sağlar.

## Basit bir test

```php
<?php
use PHPUnit\Framework\TestCase;

class CalculatorTest extends TestCase {
    public function testAdd(): void {
        $calc = new Calculator();
        $result = $calc->add(2, 3);
        $this->assertEquals(5, $result);          // assertion
        $this->assertIsInt($result);
    }

public function testDivideByZeroThrows(): void {
        $this->expectException(DivisionByZeroError::class);   // assert it throws
        (new Calculator())->divide(1, 0);
    }
}
// run with: ./vendor/bin/phpunit
```

Test sınıfları `TestCase` sınıfını genişletir, test yöntemleri `test` ile başlar (ya da `#[Test]` attribute'unu kullanır) ve beklentileri doğrulamak için `assert*` yöntemlerini kullanır (`assertEquals`, `assertTrue`, `assertCount`, vb.). `expectException` hata yollarını test eder.

## Bağımlılıkları mock'lama (DI aracılığıyla izolasyon)

```php
public function testSendsWelcomeEmail(): void {
    // create a MOCK of a dependency — no real mailer needed
    $mailer = $this->createMock(MailerInterface::class);
    $mailer->expects($this->once())          // assert it's called exactly once
           ->method('send')
           ->with('ann@x.com', $this->stringContains('Welcome'));

$service = new UserService($mailer);     // INJECT the mock (DI makes this easy)
    $service->register('ann@x.com');
}
```

PHPUnit'in mock'lama özelliği, bağımlılıkları (postalandırıcılar, depolar, API'lar) kontrol edilebilir taklidlerle değiştirmenizi sağlar — ve bağımlılık enjeksiyonu bunları enjekte etmeyi basitleştirir. Mock'ların doğru şekilde çağrıldığını doğrulayabilirsiniz. Bu, hızlı ve izole birim testlerin temelini oluşturur.

## Veri sağlayıcıları (birçok test durumunu test etme)

```php
public static function additionCases(): array {
    return [[1, 1, 2], [0, 5, 5], [-1, 1, 0]];   // [a, b, expected]
}

#[DataProvider('additionCases')]
public function testAdd(int $a, int $b, int $expected): void {
    $this->assertEquals($expected, (new Calculator())->add($a, $b));
}
```

**Veri sağlayıcıları**, aynı testi birçok girdi seti ile çalıştırır — çoğaltma olmadan birden fazla durumu temiz bir şekilde kapsar.

## En iyi uygulamalar

```text
✓ Test behavior/public API, not implementation details (so refactors don't break tests)
✓ Mock external dependencies (DB, APIs, mailers) for fast, isolated unit tests
✓ Use a test database for integration tests; setUp/tearDown for fixtures
✓ Measure coverage; test edge cases and error paths, not just the happy path
✓ Frameworks (Laravel, Symfony) build on PHPUnit with extra testing helpers
```

## Neden önemli

Test etme, güvenilir ve bakımlanabilir PHP uygulamaları oluşturmak için gereklidir ve **PHPUnit** standart araçtır — bu nedenle PHP'yi test etmeyi anlamak, hem kod kalitesi hem de profesyonel bir beklenti açısından önemlidir.

Test yazabilmeyi bilmek (`TestCase` sınıfını genişletme, assertion'lar kullanma, exception yollarını test etme) temel bir yetenektir, ancak en değerli içgörü, **bağımlılık enjeksiyonunun temiz test yazabilmeyi nasıl sağladığı**dır: iyi tasarlanmış PHP sınıfları bağımlılıklarını aldığı için, PHPUnit'in mock'lama özelliği gerçek bağımlılıkları (veritabanları, postalandırıcılar, harici API'lar) kontrol edilebilir taklidlerle değiştirmenizi sağlar — gerçek altyapı olmadan hızlı, izole birim testleri etkinleştirir ve mock'ların doğru şekilde çağrıldığını doğrulayabilirsiniz.

Bağımlılık enjeksiyonu ile test edilebilirlik arasındaki bu bağlantı, bağımlılık enjeksiyonu deseninin neden bu kadar önemli olduğunu tam olarak açıklar.

Mock'lamayı, **veri sağlayıcılarını** (birçok girdi durumunu verimli bir şekilde test etme), ve test etme en iyi uygulamalarını (davranışı test etme, harici bağımlılıkları mock'lama, sınır durumlarını ve hata yollarını kapsama, entegrasyon testleri için test veritabanları kullanma) anlamak, etkili PHP test yazmanın pratik kapsamını içerir.

İyi test edilmiş PHP, regressiyonları yakalar, özgüvenli yeniden düzenlemeyi sağlar ve beklenen davranışı belgelendirir. Modern çerçeveler (Laravel, Symfony) kendi test yazabilmesini PHPUnit üzerine inşa ettiği için, onu bilmek geniş bir şekilde uygulanabilir.

PHPUnit'te yetkin olmak — özellikle izole testler için mock'lama ve DI'dan yararlanmak — önemli üst düzey bir bilgidir ve sağlam, bakımlanabilir, iyi test edilmiş uygulamalar oluşturan geliştiricileri, test edilmemiş ve kırılgan kod sevk eden geliştiricilerden ayırır. Bu nedenle, sık sık karşılaşılan, profesyonel olarak önemli bir konu haline gelir.