Zum Inhalt springen
iD-SIGN

E2E-Tests für Symfony mit Panther

Panther führt Symfony-Tests in einem echten Chrome aus. Wir zeigen, was daraus folgt, dass die Anwendung in einem anderen Prozess läuft als der Test, wie Sie zuverlässig auf htmx, React und Vue warten und wie die Suite in der CI läuft, ohne zufällig fehlzuschlagen.

16 Min. Lesezeitveröffentlicht 11/2026

In diesem Artikel 12 Kapitel
  1. Wann ein E2E-Test
  2. Was Panther testet und was nicht
  3. Installation und Browser
  4. Zwei Prozesse
  5. Eingebauter oder echter Server
  6. Was Panther nicht kann
  7. Warten
  8. JavaScript im Browser
  9. Datei-Upload
  10. Debugging
  11. CI
  12. Panther oder ein anderes Werkzeug

Panther steuert einen echten Browser über WebDriver und bietet im Test dieselbe API wie WebTestCase: request(), den Crawler, Formulare, Klicks. Der Unterschied: Chrome rendert die Seite, JavaScript läuft, und der Test sieht, was der Nutzer sieht.

Dafür zahlen Sie mit Geschwindigkeit und einer neuen Klasse von Fehlern. Die Anwendung läuft nicht im Prozess des Tests, nichts wartet von selbst, und ein Fehler im Test sieht leicht wie ein Fehler der Anwendung aus. Hier ist, was wir gelernt und was wir überprüft haben.

Wann ein E2E-Test

Panther gehört nur dorthin, wo ein Test ohne Browser nicht auskommt:

  • Interaktion in JavaScript (htmx, Alpine.js, Stimulus, React, Vue),
  • komplette Wege des Nutzers über mehrere Seiten: Registrierung, Kauf, Zahlung, Rückkehr vom Zahlungsanbieter,
  • Verhalten, das vom Rendering abhängt: Sichtbarkeit, Überlagerungen, Scrollen.

Formularvalidierung, Berechtigungen, Fragment-Antworten und APIs testen Sie in WebTestCase. Er läuft im Prozess des Tests und ist um eine Größenordnung schneller. Beschränken Sie die E2E-Suite auf die kritischen Pfade.

Was Panther testet und was nicht

Der Browser ist echt: Chrome im Headless-Modus, mit demselben Rendering und demselben JavaScript wie beim Nutzer. Klicks und Tastatureingaben über WebDriver sind für die Seite echte Events (isTrusted ist true), und WebDriver klickt nur dorthin, wohin auch ein Mensch klicken könnte. Ein Klick über executeScript() ist nicht echt und umgeht diese Prüfung.

Die Umgebung um den Browser unterscheidet sich jedoch von der des Nutzers:

  • Ein Browser und ein Fenster. Chrome, gegebenenfalls Firefox, in der Größe 1200 × 900 ohne Touch. Kein Safari und keine Telefone. Das mobile Layout testen Sie nur mit gesetzter Fenstergröße.
  • Der Browser verrät sich. navigator.webdriver ist true, und der User-Agent enthält HeadlessChrome. Schalten Sie den Bot-Schutz (reCAPTCHA, Cloudflare) in der Testumgebung ab oder ersetzen Sie ihn durch ein Test-Double.
  • Ein sauberes Profil ohne Erweiterungen und mit der Sprache en-US, wenn Sie keine setzen.
  • Animationen aus über prefers-reduced-motion.
  • Sofortiges Tippen ohne menschliches Tempo.
  • Eine Testwelt: die Umgebung test, ein lokales Netz ohne Latenz, eingefrorene Zeit, gefälschte Zahlungsanbieter und Register.

Und manches prüft der Test gar nicht: dass die Seite gut aussieht (ein zerschossenes Layout oder überlagerter Text, nach dem der Test nicht fragt, gehen durch), Barrierefreiheit und Geschwindigkeit. Panther prüft, dass die Anwendung in Chrome aus Sicht des Nutzers funktioniert, nicht dass sie überall funktioniert und gut aussieht.

Installation und Browser

bash
composer require --dev symfony/panther

Panther braucht Chrome (oder Firefox) und dazu einen chromedriver derselben Hauptversion. Eine Abweichung endet gleich beim Start: session not created: This version of ChromeDriver only supports Chrome version ….

  • Panther sucht chromedriver zuerst im PATH und erst dann in ./drivers. Ein älterer System-chromedriver aus einem Paket gewinnt daher gegen den Treiber, den dbrekelmans/bdi nach ./drivers geladen hat. Halten Sie eine einzige Quelle: entweder die Systempakete für Browser und Treiber (chromium und chromium-driver) oder bdi und keinen Treiber im PATH.
  • Ein anderes Browser-Binary setzen Sie in PANTHER_CHROME_BINARY. Eine Variable für den Treiberpfad gibt es nicht.
  • Im Container läuft Chrome als root und mit kleinem /dev/shm, braucht also PANTHER_NO_SANDBOX=1 und --disable-dev-shm-usage.

In phpunit.dist.xml gehört die Erweiterung, die Server und Browser während des ganzen Laufs am Leben hält, nicht nur für eine Klasse:

xml
<extensions>
    <bootstrap class="Symfony\Component\Panther\ServerExtension" />
</extensions>

Und in .env.test:

bash
PANTHER_APP_ENV=test
PANTHER_NO_SANDBOX=1
PANTHER_CHROME_ARGUMENTS='--disable-dev-shm-usage'
PANTHER_ERROR_SCREENSHOT_DIR=./var/error-screenshots

Legen Sie die E2E-Tests in eine eigene Suite (<testsuite name="e2e">), damit sie sich getrennt starten lassen und die übrigen Tests nicht auf einen Browser warten. Wie das alles in DDEV läuft, beschreiben wir im Artikel Lokale Symfony-Entwicklung in DDEV.

Zwei Prozesse

Das ist der wichtigste Punkt des ganzen Artikels. Ein Klick in Panther ist keine Abkürzung über den Kernel, sondern ein echter HTTP-Request:

  1. Der Test schickt chromedriver einen WebDriver-Befehl: Klicke auf dieses Element.
  2. Chrome klickt, das JavaScript der Seite läuft, und der Browser schickt einen HTTP-Request mit seinen Headern und Cookies.
  3. Den Request nimmt ein Webserver in einem anderen Prozess entgegen: der eingebaute PHP-Server, den Panther auf Port 9080 startet, oder ein echter Webserver, wenn Sie PANTHER_EXTERNAL_BASE_URI setzen.
  4. Dieser startet public/index.php, Symfony bootet den Kernel und bearbeitet den Request wie in der Produktion. Jeder Request ist ein eigener PHP-Lauf.
  5. Chrome rendert die Antwort, und der Test liest das resultierende DOM über WebDriver.

Auch $client->request() ist nur die Anweisung an den Browser, eine Adresse zu öffnen. KernelBrowser in WebTestCase schickt dagegen überhaupt kein HTTP: Er baut ein Request-Objekt und übergibt es dem Kernel im selben Prozess. Deshalb ist er schnell und sieht in den Container.

Der Kernel, den Panther im Prozess des Tests bootet, dient nur dem Test: getContainer(), der EntityManager für Fixtures und Prüfungen in der Datenbank. Auf die Requests des Browsers hat er keinen Einfluss. Test und Server haben jeweils ihren eigenen Service-Container, ihren eigenen EntityManager und ihre eigene Datenbankverbindung.

Daraus folgt:

  • self::getContainer()->set() erreicht den Server nicht. Ein Test-Double, etwa ein gefälschter Zahlungsanbieter, muss in der Konfiguration der Umgebung test verdrahtet sein (config/packages/test/services.yaml). Ein in config/services.yaml definierter Service wird später geladen und würde einen Alias überschreiben, deshalb verdrahten Sie das Double mit decorates.
  • Die Prozesse tauschen Zustand über die Datenbank oder Dateien aus. Was der gefälschte Zahlungsanbieter antworten soll, schreibt der Test in eine Datei unter var/cache/test/, und das Double auf dem Server liest sie.
  • Daten müssen committet sein. Was der Test schreibt und flusht, sieht der Server. Was in einer nicht committeten Transaktion steckt, sieht er nicht.
  • DAMA DoctrineTestBundle funktioniert mit Panther nicht. Es umschließt den Test mit einer Transaktion, die es am Ende zurückrollt. Der Server sieht die Daten des Tests nicht, und wenn der Test eine Zeile ändert, in die der Server später schreibt, wartet der Server bis zum Ende des Tests auf die Sperre. Starten Sie die E2E-Suite deshalb ohne die DAMA-Erweiterung und setzen Sie die Datenbank anders zurück (siehe unten).
  • Mailer-Assertions (assertEmailCount() und weitere) zählen null. Sie lesen Nachrichten, die im Prozess des Tests verschickt wurden, nicht auf dem Server. In der Testumgebung kann die Anwendung verschickte E-Mails in einer Tabelle speichern, die der Test abfragt, oder Sie lesen sie über die API von Mailpit.
  • Eingefrorene Zeit gilt für jeden Prozess getrennt. Eine MockClock aus der Konfiguration der Umgebung test friert die Zeit auf dem Server und im Test ein. Verstellt der Test aber die Uhr, sieht der Server das nicht. Situationen wie „14 Tage später“ lösen Sie, indem Sie den Cron im Prozess des Tests mit verstellter Uhr gegen die gemeinsame Datenbank laufen lassen. Der Browser lebt währenddessen weiter am eingefrorenen Tag.

Datenbank

Ein bewährtes Vorgehen:

  1. Das Schema einmal zu Beginn der Suite. Eine PHPUnit-Erweiterung auf das Startereignis der Suite löscht die Datenbank, führt die Migrationen aus und lädt die Daten, die Migrationen oder Synchronisationen liefern (Codelisten, CMS-Texte).
  2. Fixtures pro Klasse in setUpBeforeClass(), direkt über den Fixture-Loader statt über einen Konsolenaufruf. Das ist schneller.
  3. Tabellen, die Migrationen füllen, vom Löschen ausnehmen. ORMPurger bekommt eine Liste von Tabellen, die er in Ruhe lassen soll. Sonst fehlt nach dem ersten Purge Konfiguration, ohne die die Anwendung nicht läuft.
  4. Tests innerhalb einer Klasse erzeugen ihren Zustand über die Anwendung (Registrierung, Kauf) und mit eindeutigen E-Mail-Adressen. Verlassen Sie sich nicht auf die Reihenfolge der Tests.

Eingebauter oder echter Server

Der eingebaute PHP-Server ist der einfachste Weg. Statische Dateien liefert er aber nur aus public/, die Assets müssen also vorher gebaut sein (npm run build, asset-map:compile). Auch die nginx-Konfiguration, HTTPS und Header greifen nicht.

Mit PANTHER_EXTERNAL_BASE_URI laufen die Tests gegen einen echten Webserver, auf demselben Weg wie die Produktion. Dieser muss selbst in APP_ENV=test mit der Testdatenbank laufen. Bewährt hat sich eine zweite Projektadresse, etwa test.projekt.ddev.site, unter der der Webserver PHP APP_ENV=test übergibt, während die Hauptadresse weiter der Entwicklung dient.

  • Wärmen Sie die PHP-FPM-Worker vor der Suite auf, mit einigen gleichzeitigen Requests an die Testadresse. Ein kalter Worker lädt erst den Container, und die ersten Tests scheitern dann zufällig an einem Timeout.
  • Keiner der beiden Server deckt Fehler des Worker-Modus auf (FrankenPHP, RoadRunner). Ein Service, der zwischen Requests Zustand hält, verhält sich in den Tests korrekt und in der Produktion nicht. Sichern Sie das anders ab, etwa durch eine Prüfung von ResetInterface bei Services mit Zustand.

Was Panther nicht kann

Der Client sieht aus wie KernelBrowser, aber nicht alles funktioniert:

  • request() schickt nur GET. Ein Formular senden Sie über den Crawler oder per Klick.
  • getResponse() und Response-Assertions (assertResponseIsSuccessful(), assertResponseStatusCodeSame()) enden mit einer Exception. Den Statuscode sehen Sie im Browser nicht, prüfen Sie den Inhalt der Seite.
  • text() liefert nur sichtbaren Text. Ein verstecktes Element liefert einen leeren String. Den Seitentitel gibt $client->getTitle().
  • loginUser() gibt es nicht. Der Server weiß nichts von der Session des Tests. Melden Sie sich über das echte Formular an, einmal pro Klasse.
  • Es gibt einen Client für den ganzen Lauf. Ein zweiter Aufruf von createPantherClient() liefert denselben Browser und ignoriert die neuen Optionen. Cookies, localStorage und die Anmeldung überleben bis in den nächsten Test.
  • Ein Cookie lässt sich erst auf einer Seite seiner Domain setzen, sonst InvalidCookieDomainException.

Räumen Sie den Zustand zwischen den Tests deshalb in einer Basisklasse auf:

php
abstract class E2ETestCase extends PantherTestCase
{
    protected function tearDown(): void
    {
        $client = static::createPantherClient();
        $client->getWebDriver()->manage()->deleteAllCookies();

        try {
            $client->executeScript('localStorage.clear(); sessionStorage.clear();');
        } catch (\Throwable) {
            // eine Seite ohne Speicher, etwa about:blank
        }

        parent::tearDown();
    }
}

Warten

Panther wartet nicht von selbst. Eine Assertion direkt nach einer Aktion liest die Seite in genau diesem Moment, und die meisten zufällig scheiternden Tests entstehen genau hier.

  • Weder submit() noch click() warten auf die Navigation. Der Crawler direkt nach dem Absenden eines Formulars ist noch die alte Seite. Warten Sie auf etwas, das es nur auf der Zielseite gibt, oder auf die Änderung der Adresse.
  • Warten Sie auf den Endzustand, nicht auf einen Zwischenindikator. Ein Spinner oder aria-busy kann erst nach Ihrer Prüfung erscheinen oder verschwinden, bevor Sie hinsehen.
  • Kein sleep(). Auf einer langsamen Maschine reicht es nicht, auf einer schnellen hält es auf. Ausnahme ist eine Wartezeit, die die Anwendung absichtlich verlangt, etwa die Zeitfalle eines Formulars gegen Bots.
  • Der Standard-Timeout beträgt 30 Sekunden. Jeder Fehlschlag kostet dann eine halbe Minute. Für gewöhnliche Elemente reichen ein paar Sekunden: waitFor('#result', 5).

Panther hat eine Reihe von waitFor*-Methoden und assertSelectorWill*-Assertions:

php
$client->waitFor('#result');                          // das Element existiert
$client->waitForVisibility('#modal');                 // es ist sichtbar
$client->waitForInvisibility('.spinner');             // es ist weg oder existiert nicht
$client->waitForElementToContain('#total', '1.200');  // es enthält den Text
$client->waitForStaleness('#list');                   // dieses Element wurde ersetzt
self::assertSelectorWillContain('#flash', 'Gespeichert');

waitForStaleness() sucht das Element zuerst. Existiert es nicht mehr, wirft es sofort NoSuchElementException. Für ein verschwindendes Element ist waitForInvisibility() sicherer, es besteht auch bei einem fehlenden Element.

Für alles Weitere genügt eine eigene Bedingung:

php
use Facebook\WebDriver\WebDriverExpectedCondition;

$client->wait(10)->until(WebDriverExpectedCondition::urlContains('/zahlung/erfolg'));
$client->wait(5)->until(fn () => true === $client->executeScript('return window.appReady'));

Lesen Sie nach jedem Warten den Crawler neu ($client->getCrawler() oder den Crawler, den waitFor* liefert). Der alte spiegelt den Zustand vor der Änderung.

JavaScript im Browser

Gemeinsam für alle Bibliotheken: Inhalt, der über das Netz kommt, erscheint später, als der Klick endet. Direkt nach dem Klick auf eine Schaltfläche, die Daten lädt, ist das Ergebnis noch leer. Die Unterschiede liegen darin, worauf man warten kann und wie Felder ausgefüllt werden.

htmx

  • Während eines Requests trägt das auslösende Element die Klasse htmx-request, kein Attribut. Der Selektor [hx-request] findet nichts, und das Warten darauf wartet stillschweigend nicht.
  • htmx:after:request kommt vor dem Swap. Nach dem Swap folgen htmx:after:swap, htmx:after:settle und zuletzt htmx:finally:request, das auch nach einem Fehler kommt.
  • Hängen Sie den Listener an, bevor Sie die Aktion auslösen, am besten im selben Skript. Erst nach dem Klick angehängt, kann er eine schnelle Antwort grundsätzlich verpassen.
php
protected function runHtmx(string $trigger, int $timeout = 10): void
{
    $client = static::createPantherClient();
    $client->executeScript(<<<JS
        window.__htmxDone = false;
        document.addEventListener('htmx:finally:request', () => { window.__htmxDone = true; }, { once: true });
        {$trigger}
        JS);
    $client->wait($timeout, 100)->until(fn () => true === $client->executeScript('return window.__htmxDone'));
}

$this->runHtmx('document.querySelector("#apply-code").click();');
  • Morph behält den Wert des Feldes mit Fokus. Senden Sie ein Formular mit Enter ab, zeigt das Feld mit dem Cursor nach dem Morph, was der Nutzer getippt hat, nicht den Wert vom Server. Prüfen Sie den gespeicherten Zustand deshalb mit einem frischen Laden der Seite, nicht durch Lesen des gemorphten Formulars.
  • Fragment-Antworten und hx-swap-oob genügt es in WebTestCase mit dem Header HX-Request zu testen. In Panther nur, dass der Swap im Browser tatsächlich passiert.

Wie Sie htmx in Symfony einsetzen, beschreiben wir in einer Serie, die mit dem Artikel Navigation in Symfony mit htmx beginnt.

React

  • Die Komponente wird erst nach dem Laden der Seite gemountet. request() liefert eine Seite, in der der Inhalt der Komponente noch fehlt. Warten Sie vor der ersten Aktion auf ein Element innerhalb der Komponente.
  • Tippen mit sendKeys() funktioniert, auch über die Formular-API von Panther. WebDriver schickt echte Tastatur-Events.
  • Ein per Skript gesetzter Wert funktioniert nicht. Bei einem kontrollierten Feld ignoriert React el.value = … auch mit einem anschließenden input-Event. Durch kommt nur der native Setter plus Event:
php
$client->executeScript(<<<'JS'
    const input = document.querySelector(arguments[0]);
    Object.getOwnPropertyDescriptor(HTMLInputElement.prototype, 'value').set.call(input, arguments[1]);
    input.dispatchEvent(new Event('input', { bubbles: true }));
    JS, ['#email', 'jana@example.test']);

Bei einer textarea ist es HTMLTextAreaElement.prototype. Wo es geht, bevorzugen Sie sendKeys().

  • Nach einem neuen Rendern veralten Elemente. Ein gespeichertes Element und ein gespeicherter Crawler werfen nach dem Neumounten der Komponente StaleElementReferenceException. Behalten Sie Elemente nicht über eine Aktion hinweg, suchen Sie sie danach neu.

Vue und Alpine.js

  • v-model und x-model hören auf das Event input. Anders als bei React genügen hier el.value = … und dispatchEvent(new Event('input', { bubbles: true })). el.value allein ohne Event reicht nirgends.
  • v-model.lazy aktualisiert das Model erst bei change, also wenn das Feld den Fokus verliert. Nach sendKeys() ist das Model noch leer, bis Sie WebDriverKeys::TAB senden oder woanders klicken. Dasselbe gilt für eigene @change-Listener.

Routing im Browser

Ein Übergang über history.pushState() ist kein Laden der Seite. getCurrentURL() liefert die neue Adresse, aber waitFor wartet nicht darauf. Warten Sie auf die Adresse und dann auf den Inhalt des neuen Bildschirms:

php
$client->getCrawler()->filter('#detail-link')->click();
$client->wait(5)->until(WebDriverExpectedCondition::urlContains('/detail'));
$client->waitFor('#detail-title');

Request-Zähler

Ein allgemeiner fetch-Zähler (ein umhülltes window.fetch mit Zähler) sagt, dass das Netz fertig ist, nicht dass das Ergebnis gerendert ist. Zwischen Antwort und Rendern liegen noch das Lesen des JSON und die Änderung des Zustands. Als Ergänzung ist er nützlich, zuverlässiger ist das Warten auf das Ergebnis im DOM.

Klicks, Überlagerungen und versteckte Felder

  • Ein überdecktes Element meldet ElementClickInterceptedException. WebDriver klickt nur dorthin, wohin der Nutzer klicken könnte. Warten Sie, bis die Überlagerung verschwindet (waitForInvisibility('.modal-backdrop')).
  • Ein visuell verstecktes Feld (eine Checkbox mit der Klasse sr-only unter eigener Grafik) meldet dasselbe. Klicken Sie auf ihr label oder schalten Sie sie per Skript um.
  • Eine Schaltfläche unterhalb des sichtbaren Bereichs meldet WebDriver manchmal als überdeckt, obwohl sie es nicht ist. Es hilft scrollIntoView({ block: 'center' }) oder ein Klick per Skript.
  • Ein Klick per Skript umgeht bewusst die Prüfung, ob sich das Element wirklich anklicken lässt. Setzen Sie ihn dort ein, wo Sie wissen warum, und schreiben Sie es in einen Kommentar.
  • form.submit() löst das Event submit nicht aus. Ergänzt JavaScript ein CSRF-Token oder andere Daten erst beim Absenden, wird das Formular ohne sie verschickt. Verwenden Sie form.requestSubmit() oder einen echten Klick.
  • Panther schaltet prefers-reduced-motion ein. Animationen und sanftes Scrollen, die das respektieren, stören in Tests nicht. Solche, die es ignorieren, verursachen abgefangene Klicks.

confirm()-Dialoge

Nach einem Klick auf ein Element, das confirm() öffnet, liest Panther sofort die Seite und stößt auf UnexpectedAlertOpenException. Klicken Sie direkt auf das WebDriver-Element und bedienen Sie den Dialog:

php
$crawler->filter('#delete')->getElement(0)->click();
$client->wait(5)->until(WebDriverExpectedCondition::alertIsPresent());
$client->getWebDriver()->switchTo()->alert()->accept();
$client->refreshCrawler();

Das betrifft auch hx-confirm und data-turbo-confirm, wenn sie den nativen Dialog verwenden.

Datei-Upload

Die Datei wählt kein Dialog aus, WebDriver übergibt dem Feld direkt den Pfad. In einem Formular genügt die Formular-API, die auch mit einem relativen Pfad zurechtkommt:

php
$form = $crawler->filter('#document-form')->form();
$form['doc']->upload(__DIR__.'/../fixtures/vertrag.pdf');
$client->submit($form);
$client->waitFor('#uploaded');

Außerhalb eines Formulars, etwa bei einem Feld, das über htmx gesendet wird, schicken Sie den Pfad direkt:

php
$crawler->filter('#doc')->sendKeys(realpath(__DIR__.'/../fixtures/vertrag.pdf'));
  • Der Pfad für sendKeys() muss absolut sein, sonst path is not absolute.
  • Mehrere Dateien für ein Feld mit multiple schicken Sie in einem Aufruf, die Pfade durch einen Zeilenumbruch getrennt.
  • Ein verstecktes Feld unter einer eigenen Schaltfläche oder einer Dropzone (display: none) nimmt die Datei an. Anders als bei einer versteckten Checkbox müssen Sie nichts umgehen. Eine Datei von der Festplatte ziehen kann WebDriver nicht, schicken Sie die Datei deshalb an das <input type="file">, das die Dropzone darunter hat.
  • Die Datei muss auf der Maschine existieren, auf der der Browser läuft. Läuft er im selben Container wie die Tests, genügen Fixtures im Repository.
  • Die Validierung auf dem Server (Größe, Typ, Fehlermeldungen) testen Sie in WebTestCase mit UploadedFile. Das ist schneller, und Sie können dort auch eine Datei unterschieben, die der Browser nie schicken würde. In Panther bleiben die Auswahl der Datei, die Vorschau und das Ergebnis im Browser.

Debugging

  • Einen Screenshot beim Fehlschlag speichert Panther in PANTHER_ERROR_SCREENSHOT_DIR, sowohl bei einer fehlgeschlagenen Assertion als auch bei einer Exception, etwa einem Timeout von waitFor. In der CI bewahren Sie ihn als Artefakt auf.
  • Die Browser-Konsole. Ein Timeout bei waitFor bedeutet oft einen JavaScript-Fehler, wegen dem das Element nie entsteht. Schalten Sie die Aufzeichnung der Konsole ein und geben Sie sie in tearDown aus:
php
$client = static::createPantherClient([], [], [
    'capabilities' => ['goog:loggingPrefs' => ['browser' => 'ALL']],
]);

foreach ($client->getWebDriver()->manage()->getLog('browser') as $entry) {
    fwrite(STDERR, $entry['level'].' '.$entry['message'].PHP_EOL);
}
  • Teilen Sie Hilfsmethoden. Anmeldung, Warten auf htmx, Ausfüllen eines Formulars der Administration, der Link aus einer verschickten E-Mail: Schreibt jeder Test seine eigene Kopie, scheitert jede anders. Eine fehlerhafte Kopie kann sogar durchgehen, weil nichts sie prüft. Ein Warte-Helfer mit falschem Selektor wartet stillschweigend nicht und verlangsamt den Test nur.

CI

  • Ein Image mit PHP, Chromium und chromedriver aus derselben Quelle. Die Debian-Pakete chromium und chromium-driver haben immer zueinander passende Versionen.
  • Die Datenbank als Service des Jobs, mit denselben Zugangsdaten wie in .env.test, damit nichts überschrieben werden muss.
  • Vor den Tests die Assets bauen, cache:warmup --env=test ausführen und warten, bis die Datenbank antwortet.
  • Die Zeitzone setzen Sie wie in der Produktion. Ein Image ohne Einstellung läuft in UTC, und eingefrorene Zeit mit dem Versatz +02:00 ergibt dann ein anderes „heute“ als im Browser.
  • Screenshots von Fehlschlägen und das Server-Log bewahren Sie als Artefakte des Jobs auf (when: on_failure).
  • Gleichzeitige Läufe brauchen eigene Ports. Server (9080) und chromedriver (9515) haben feste Ports, und ein zweiter Lauf endet mit The port … is already in use. Mit ParaTest leiten Sie die Ports und den Datenbanknamen von TEST_TOKEN ab:
php
$token = (int) (getenv('TEST_TOKEN') ?: 0);
$client = static::createPantherClient(['port' => 9080 + $token], [], ['port' => 9515 + $token]);
  • Langsame Tests gehören in eine eigene Gruppe. Tests, die etwa ein PDF mit einem weiteren Chromium innerhalb der Anwendung erzeugen, brauchen mehr Speicher und /dev/shm. So lassen sie sich aus dem schnellen Lauf ausnehmen (--exclude-group=slow).

Panther oder ein anderes Werkzeug

Panther passt dort, wo Symfony die Seiten rendert und JavaScript sie ergänzt: Twig mit htmx, Alpine.js, Stimulus oder einzelnen Komponenten in React oder Vue. Die Tests bleiben in PHPUnit und teilen Fixtures, Services und Hilfsklassen mit den übrigen Tests.

Besteht der Großteil der Oberfläche aus einer eigenständigen SPA, lohnt sich ein Werkzeug, das von selbst wartet, zum Beispiel Playwright. Es wartet, bis ein Element sichtbar, stabil und anklickbar ist, und erspart so einen großen Teil des manuellen Wartens aus diesem Artikel.

Links: Panther auf GitHub, E2E-Tests in der Symfony-Dokumentation, php-webdriver.

Schlagwörter Backend, PHP, JavaScript

Teilen LinkedIn Facebook

Brauchen Sie mehr als einen Artikel?

Ein paar Sätze zu Ihrem Anliegen genügen.