Conas a dhéanann tú cód PHP a thástáil le PHPUnit?

Question

Accepted Answer

**PHPUnit** is an framework tástála caighdeánach do PHP — a úsáidtear chun tástálacha aonaid agus comhtháthaithe a scríobh a fhíorú go bheidh cód ag obair i gceart. I gcomhcheangal le instealladh eisíochta (do bhrégghréasáin) agus uirlisí cosúil le soláthraitheoirí sonraí, cumasaíonn sé tástáil thúr-dhéanta agus inchuimsitheach.

## Tástáil bhunúsach

```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
```

Sintéisítear ranganna tástála ó `TestCase`, cuireathas tús le modhanna tástála le `test` (nó úsáid a bhaint as an `#[Test]` attribute), agus úsáidtear modhanna `assert*` chun ionchais a fhíorú (`assertEquals`, `assertTrue`, `assertCount`, etc.). Dhéanann `expectException` conairgí earráide a thástáil.

## Brégghréasáin a dhéanamh ar dhleathachtaí (deighilt trí DI)

```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');
}
```

Ligean do do PHPUnit brégghréasáin duit cleachtais dhleathachtaí (postmhálaí, stórtha, APIs) a ionadú le bréaganna rialaithe — agus déanann instealladh eisíochta é a bheith fánach a ndéanamh. Is féidir leat a dheimhniú go ndéantar glaoch ar bhréaganna i gceart. Seo an bunús de thástálacha aonaid thapa, deighilte.

## Soláthraitheoirí sonraí (go leor cásanna a thástáil)

```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));
}
```

**Soláthraitheoirí sonraí** a reáchtáil an tástáil chéanna i gcoinne go leor tacar ionchur — clúdach geal ar go leor cásanna gan dúbailt.

## Dea-nósanna

```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
```

## Cén fáth a bhfuil sé tábhachtach

Tá tástáil riachtanach chun feidhmchlár PHP iontaofa agus inmhéaduithe a thógáil, agus is **PHPUnit** an uirlis chaighdeánach — mar sin tá tuiscint ar conas PHP a thástáil tábhachtach don fheidhm chóid agus mar ionchas gníomhaíochta.

Tá sé bunúsach tuiscint ar conas tástálacha a scríobh (a shínte ó `TestCase`, ag úsáid dearbhuithe, conairgí eisceachta a thástáil), ach is an léargas is luachmhaire conas a chumasaíonn **instealladh eisíochta tástáil gheal**: toisc go bhfaigheann ranganna PHP dea-dheartha a ndhleathachtaí, ligean do bhréagghréasáin PHPUnit duit cleachtais dhíofa (bunachair shonraí, postmhálaí, APIs seachtracha) a ionadú le bréaganna rialaithe — ag socrú tástálacha aonaid thapa, deighilte gan bhonneagar fíor, agus ag ligean duit idirghníomhaíochtaí a fhíorú (ag dearbhú gur tugadh glaoch ar bhréaga i gceart).

Is é an nasc seo idir DI agus testability an fáth go bhfuil an patrún instealladh eisíochta chomh tábhachtach.

Tuiscint ar bhréagghréasáin, **soláthraitheoirí sonraí** (go éifeachtach go leor cásanna ionchur a thástáil), agus dea-nósanna tástála (iompair an bhraistint, ní fhíorú, cleachtais dhleathachtaí seachtracha a bhréagadh, imill agus conairgí earráide a chlúdach, bunachair thástála a úsáid do thástálacha comhtháthaithe) - clúdacha an raon gníomhach de thástáil éifeachtach PHP.

Leanann tástálacha PHP tugtha tugtha dul siar, cumasaíonn siad athdealú muiníneach, agus docsúint a fheidhm inmhianaithe, agus ó bhraistint chreataí nua-aimseartha (Laravel, Symfony) a thógáil ar an tástáil orthu ar PHPUnit, tá sé go leor feidhm.

Tá fás orthu PHPUnit — go háirithe ag baint leasa as brégghréasáin agus DI do thástálacha deighilte — ina eolas ardleibhéal tábhachtach a dhéanann idirdhealú idir forbróirí a thógann feidhmchláir dhúnghartha, inmhéaduithe, go maith-thástála ó na ndéanann siad cód gan tástáil, bréagach a seachadadh, ag déanamh topaice a raibh oiriúnach go minic, go gníomhaíochta do thuaidh.