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.webdriveristtrue, und der User-Agent enthältHeadlessChrome. 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
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
PATHund erst dann in./drivers. Ein älterer System-chromedriveraus einem Paket gewinnt daher gegen den Treiber, dendbrekelmans/bdinach./driversgeladen hat. Halten Sie eine einzige Quelle: entweder die Systempakete für Browser und Treiber (chromiumundchromium-driver) oderbdiund keinen Treiber imPATH. - 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 alsoPANTHER_NO_SANDBOX=1und--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:
<extensions>
<bootstrap class="Symfony\Component\Panther\ServerExtension" />
</extensions>
Und in .env.test:
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:
- Der Test schickt chromedriver einen WebDriver-Befehl: Klicke auf dieses Element.
- Chrome klickt, das JavaScript der Seite läuft, und der Browser schickt einen HTTP-Request mit seinen Headern und Cookies.
- 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_URIsetzen. - Dieser startet
public/index.php, Symfony bootet den Kernel und bearbeitet den Request wie in der Produktion. Jeder Request ist ein eigener PHP-Lauf. - 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 Umgebungtestverdrahtet sein (config/packages/test/services.yaml). Ein inconfig/services.yamldefinierter Service wird später geladen und würde einen Alias überschreiben, deshalb verdrahten Sie das Double mitdecorates.- 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
MockClockaus der Konfiguration der Umgebungtestfriert 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:
- 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).
- Fixtures pro Klasse in
setUpBeforeClass(), direkt über den Fixture-Loader statt über einen Konsolenaufruf. Das ist schneller. - Tabellen, die Migrationen füllen, vom Löschen ausnehmen.
ORMPurgerbekommt eine Liste von Tabellen, die er in Ruhe lassen soll. Sonst fehlt nach dem ersten Purge Konfiguration, ohne die die Anwendung nicht läuft. - 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
ResetInterfacebei 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,localStorageund 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:
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()nochclick()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-busykann 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:
$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:
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:requestkommt vor dem Swap. Nach dem Swap folgenhtmx:after:swap,htmx:after:settleund zuletzthtmx: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.
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-oobgenügt es inWebTestCasemit dem HeaderHX-Requestzu 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ßendeninput-Event. Durch kommt nur der native Setter plus Event:
$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-modelundx-modelhören auf das Eventinput. Anders als bei React genügen hierel.value = …unddispatchEvent(new Event('input', { bubbles: true })).el.valueallein ohne Event reicht nirgends.v-model.lazyaktualisiert das Model erst beichange, also wenn das Feld den Fokus verliert. NachsendKeys()ist das Model noch leer, bis SieWebDriverKeys::TABsenden 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:
$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-onlyunter eigener Grafik) meldet dasselbe. Klicken Sie auf ihrlabeloder 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 Eventsubmitnicht aus. Ergänzt JavaScript ein CSRF-Token oder andere Daten erst beim Absenden, wird das Formular ohne sie verschickt. Verwenden Sieform.requestSubmit()oder einen echten Klick.- Panther schaltet
prefers-reduced-motionein. 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:
$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:
$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:
$crawler->filter('#doc')->sendKeys(realpath(__DIR__.'/../fixtures/vertrag.pdf'));
- Der Pfad für
sendKeys()muss absolut sein, sonstpath is not absolute. - Mehrere Dateien für ein Feld mit
multipleschicken 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
WebTestCasemitUploadedFile. 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 vonwaitFor. In der CI bewahren Sie ihn als Artefakt auf. - Die Browser-Konsole. Ein Timeout bei
waitForbedeutet oft einen JavaScript-Fehler, wegen dem das Element nie entsteht. Schalten Sie die Aufzeichnung der Konsole ein und geben Sie sie intearDownaus:
$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
chromiumundchromium-driverhaben 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=testausfü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:00ergibt 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 vonTEST_TOKENab:
$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.