Πώς δοκιμάζετε κώδικα PHP με PHPUnit;

Question

Accepted Answer

Το **PHPUnit** είναι το standard testing framework για PHP — χρησιμοποιείται για τη σύνταξη unit και integration tests που επαληθεύουν ότι ο κώδικας συμπεριφέρεται σωστά. Σε συνδυασμό με την ένεση εξαρτήσεων (για mocking) και εργαλεία όπως data providers, επιτρέπει ολοκληρωμένη και διατηρήσιμη δοκιμή.

## Ένα βασικό 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 επεκτείνουν `TestCase`, οι μέθοδοι test ξεκινούν με `test` (ή χρησιμοποιούν το `#[Test]` attribute), και χρησιμοποιούν `assert*` μεθόδους για να επαληθεύσουν προσδοκίες (`assertEquals`, `assertTrue`, `assertCount`, κτλ.). Το `expectException` δοκιμάζει τις διαδρομές σφάλματος.

## Mocking εξαρτήσεων (απομόνωση μέσω 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');
}
```

Το mocking του PHPUnit σας επιτρέπει να αντικαταστήσετε εξαρτήσεις (mailers, repositories, APIs) με ελεγχόμενα fakes — και η ένεση εξαρτήσεων κάνει την ένεξή τους απλή. Μπορείτε να εξασφαλίσετε ότι τα mocks ονομάζονται σωστά. Αυτή είναι η βάση των γρήγορων, απομονωμένων unit tests.

## Data providers (δοκιμή πολλών περιπτώσεων)

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

Οι **data providers** εκτελούν το ίδιο test σε πολλά σύνολα εισόδου — καθαρή κάλυψη πολλών περιπτώσεων χωρίς διπλότυπα.

## Best practices

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

## Γιατί έχει σημασία

Η δοκιμή είναι απαραίτητη για την κατασκευή αξιόπιστων και διατηρήσιμων εφαρμογών PHP, και το **PHPUnit** είναι το standard εργαλείο — επομένως η κατανόηση του τρόπου δοκιμής PHP είναι σημαντική τόσο για την ποιότητα του κώδικα όσο και ως επαγγελματική προσδοκία.

Η γνώση του τρόπου σύνταξης tests (επέκταση `TestCase`, χρήση assertions, δοκιμή διαδρομών εξαίρεσης) είναι θεμελιώδης, αλλά η πιο πολύτιμη εγγραφή είναι το πώς **η ένεση εξαρτήσεων επιτρέπει καθαρή δοκιμή**: επειδή καλά σχεδιασμένες κλάσεις PHP λαμβάνουν τις εξαρτήσεις τους, το mocking του PHPUnit σας επιτρέπει να αντικαταστήσετε πραγματικές εξαρτήσεις (βάσεις δεδομένων, mailers, εξωτερικά APIs) με ελεγχόμενα fakes — επιτρέποντας γρήγορα, απομονωμένα unit tests χωρίς πραγματική υποδομή, και σας επιτρέποντας να επαληθεύσετε αλληλεπιδράσεις (εξασφάλιση ότι ένα mock κλήθηκε σωστά).

Αυτή η σύνδεση μεταξύ DI και testability είναι ακριβώς γιατί το pattern της ένεσης εξαρτήσεων έχει τόσο μεγάλη σημασία.

Η κατανόηση του mocking, των **data providers** (αποτελεσματική δοκιμή πολλών περιπτώσεων εισόδου), και των best practices δοκιμής (δοκιμή συμπεριφοράς και όχι υλοποίησης, mocking εξωτερικών εξαρτήσεων, κάλυψη edge cases και διαδρομών σφάλματος, χρήση δοκιμαστικών βάσεων δεδομένων για integration tests) καλύπτει το πρακτικό εύρος της αποτελεσματικής δοκιμής PHP.

Η καλά δοκιμασμένη PHP αποτρέπει παλινδρομήσεις, επιτρέπει ενοχλημένη ανασκευή, και τεκμηριώνει αναμενόμενη συμπεριφορά, και επειδή τα σύγχρονα frameworks (Laravel, Symfony) χτίζουν τη δοκιμή τους σε PHPUnit, η γνώση του είναι ευρέως εφαρμόσιμη.

Το να κατακτήσετε το PHPUnit — ιδιαίτερα αξιοποιώντας mocking και DI για απομονωμένα tests — είναι σημαντική γνώση επιπέδου senior που διακρίνει τους developers που κατασκευάζουν ισχυρές, διατηρήσιμες, καλά δοκιμασμένες εφαρμογές από εκείνους που παράδίδουν αδοκίμαστο, εύθραυστο κώδικα, καθιστώντας το ένα συχνά σχετικό, επαγγελματικά σημαντικό θέμα.