PHP unit testing met PHPUnit: praktische uitleg

PHP unit testing met PHPUnit betekent dat je kleine, geautomatiseerde tests schrijft die controleren of afzonderlijke stukjes code (functies, methodes) het juiste resultaat opleveren. PHPUnit is het meest gebruikte testframework voor PHP en integreert met Composer. In dit artikel lees je hoe je PHPUnit installeert, je eerste test schrijft, test-driven ontwikkelt en testen uitvoert, ook op een hostingomgeving.

Wat is PHPUnit en waarom testen?

PHPUnit is een testframework waarmee je unit tests schrijft: geïsoleerde tests die een enkele methode of functie controleren zonder afhankelijkheden zoals een database of externe API. Het doel is om regressies vroeg te ontdekken, voordat ze in productie terechtkomen. Een goede testset geeft vertrouwen bij refactoren en maakt je code beter navigeerbaar, omdat tests ook als documentatie dienen.

Unit tests verschillen van functionele of end-to-end tests: ze zijn snel, geïsoleerd en richten zich op logica, niet op de volledige applicatie. Voor webapplicaties combineer je ze vaak met integratietests, maar de basis begint bij PHPUnit.

PHPUnit installeren en configureren

PHPUnit installeer je via Composer, de standaard pakketbeheerder voor PHP. Zorg dat je project een composer.json heeft en voer dit uit:

composer require --dev phpunit/phpunit

Vervolgens maak je een configuratiebestand phpunit.xml aan in de root van je project. Hierin geef je aan waar je testbestanden staan, bijvoorbeeld in de map tests/, en welke bootstrap-file wordt geladen (meestal vendor/autoload.php).

Op een gedeelde hostingomgeving test je meestal lokaal of in een staging-omgeving, en zet je alleen de geteste code live. Heb je een VPS of server waarop je via SSH Composer en PHP CLI kunt gebruiken, dan kun je PHPUnit ook direct op de server draaien. Bekijk bij twijfel over PHP-versies en CLI-toegang de instellingen van je webhosting-pakket.

Je eerste tests schrijven

Een PHPUnit-test is een klasse die erft van PHPUnitFrameworkTestCase. Elke methode die begint met test wordt automatisch uitgevoerd. Een eenvoudig voorbeeld:

use PHPUnitFrameworkTestCase;

class CalculatorTest extends TestCase
{
    public function testOptellen()
    {
        $calculator = new Calculator();
        $this->assertEquals(5, $calculator->optellen(2, 3));
    }
}

Binnen een test gebruik je assertions zoals assertEquals, assertTrue en assertNull om te controleren of de uitkomst klopt. Voor code met afhankelijkheden, zoals een database-klasse, gebruik je mocks of stubs, zodat je alleen de logica test en niet de externe verbinding.

Testen integreren in je workflow

Tests krijgen pas echt waarde als je ze structureel uitvoert. Veel teams draaien PHPUnit automatisch bij elke commit via een CI-pipeline, zodat fouten worden opgemerkt voordat code naar productie gaat. Lokaal kun je ook een pre-commit hook instellen die eerst de testsuite draait.

Let op met gevoelige gegevens in tests: gebruik nooit productiegegevens of echte klantgegevens in een testdatabase. Test e-mailfunctionaliteit bijvoorbeeld met een losse testmailbox in plaats van een live mailbox, zeker als je werkt met zakelijke e-mail die gekoppeld is aan een domein. Zo voorkom je dat testruns per ongeluk echte mail versturen.

Bij het overstappen naar een nieuwe hostingomgeving is het verstandig om je testsuite mee te nemen als controlepunt: draai de tests na migratie opnieuw om te verifiëren dat alles nog werkt zoals verwacht. Bekijk hiervoor de stappen voor overstappen naar Tandata. Vind je tijdens het testen of beheren onverwachte serverinstellingen, dan vind je uitleg en PHP-versiebeheer vaak terug in Plesk, het controlepaneel dat bij Tandata-hosting wordt gebruikt.