Tests ohne Datenbank und Testsuiten
Diese Seite richtet sich an Ingenieure, die Tests für den Kernel oder eine Erweiterung schreiben oder ausführen. Die meisten Tests von Exponential laufen ohne Datenbank; das erlaubt der CI, sie bei jedem Push auf fünf PHP-Versionen auszuführen. Die Referenz ist Tests und Continuous Integration, PHPUnit; für Autoren von Erweiterungen PHPUnit-Tests ohne Datenbank.
Inhalt
- Die Konfiguration
- Die Suiten
- Tests ausführen
- Einen Test ohne Datenbank schreiben
- Wenn Sie eine Datenbank oder einen Live-Server brauchen
Die Konfiguration
phpunit.xml:
bootstrap="tests/bootstrap.php"lädt den Autoloader von Composer, schaltet die Klassenzuordnung der Tests ein und lädt die Toolkit-Klassen intests/toolkit/(ezpTestCase,ezpDatabaseTestCase...). Es startet den Kernel nicht; Tests, die ihn brauchen, tun das selbst.- Die Gruppen
database,mail-live,mongodb-liveundnetwork-livesind standardmäßig ausgeschlossen. - Ein Testlauf schreibt seine eigenen Audit-Einträge in ein Verzeichnis unter
var/tmp.
PHPUnit selbst hängt von der PHP-Version ab: Die CI verwendet 10.5 auf PHP 8.1, 11.5 auf 8.2 und 8.3 und 13 auf 8.4 und 8.5. Schreiben Sie Tests, die mit allen dreien funktionieren (PHPUnit 13, PHPUnit 10).
Die Suiten
| Suite | Deckt ab |
|---|---|
security | tests/tests/kernel/classes/security |
kernel-classes | Kernel-Klassen, die Template-Operatoren von kernel/common, das Fehlermodul |
kernel-content, kernel-datatypes, kernel-private, kernel-search | Inhalte, Datentypen, REST und Konsolenbefehle, Suche |
kernel-contentfinder, kernel-contentcheck, kernel-logviewer, kernel-requestlog | neuere Kernel-Subsysteme |
lib | die Bibliotheken |
mongodb, mongodb-live | der MongoDB-Adapter; die Live-Suite braucht Server |
cjw_newsletter, explayouts_admin, ezjscore, ezmultiupload, expservices, ezoe, maps, admin-extensions | Erweiterungen |
quality | die eigenen Codestil-Sniffs des Projekts, die Git-Hooks, die Workflow-Regeln |
design | die Regeln für das Administrationsdesign, die Regeln der Content Security Policy, Übersetzungen |
Tests ausführen
php vendor/bin/phpunit # every suite, without a database
php vendor/bin/phpunit --testsuite security # one suite
php vendor/bin/phpunit tests/tests/kernel/classes/security/eZSecurityHardeningTest.php # one file
php vendor/bin/phpunit --list-tests # what would runEin Test, der allein besteht und im ganzen Lauf fehlschlägt, teilt Zustand mit einem anderen Test; führen Sie die beiden
Dateien zusammen aus, um das Paar zu finden. Ein Test, der auf Ihrer Installation besteht und in der CI fehlschlägt, liest
meist etwas aus Ihrer Installation; führen Sie ihn in einem frischen Klon aus, in dem nur vendor/ installiert ist.
Einen Test ohne Datenbank schreiben
- Testen Sie Klassen und Funktionen direkt; übergeben Sie Werte, lesen Sie sie nicht aus einer Anfrage.
- Lesen Sie weder
settings/overridenoch Caches invar/; brauchen Sie eine Einstellung, setzen Sie sie im Test und stellen Sie sie wieder her. - Räumen Sie Statics, im Prozess gesetzte INI-Werte und Dateien, die Sie angelegt haben, auf.
- Benennen Sie die Datei
*Test.phpund legen Sie sie unter das Verzeichnis einer Suite, sonst wird sie nie ausgeführt. - Rendern Sie für einen Template-Operator oder eine View mit einem Ersatzobjekt statt mit einer Datenbankzeile.
- Lässt sich die Änderung einer Datei zuordnen, stellen Sie sicher, dass
tests/test-map.jsonIhren Test finden kann (nach der Klasse benannt oder ein Eintrag von Hand), damit die schnellen Gates ihn ausführen.
Wenn Sie eine Datenbank oder einen Live-Server brauchen
php -d date.timezone=America/Los_Angeles tests/runtests.php --dsn mysql://[email protected]/testdb --db-per-testführt die Suiten gegen eine Wegwerf-Datenbank aus, wie es der Datenbankjob der CI tut. Kennzeichnen Sie solche Tests mit
@group database. Tests gegen Live-Server lesen deren Ort aus Umgebungsvariablen (EXP_TEST_MYSQL_*,
EXP_TEST_MONGO_URI, EXP_TEST_PUBLIC_HOST ...) und werden mit dem Namen der Variablen übersprungen, wenn sie nicht
gesetzt ist. Übergeben Sie Passwörter über die Umgebung, nicht auf der Kommandozeile
(Qualitätsprüfungen, Tests, die einen Live-Server brauchen).
Verwandte Seiten
- Teststrategie
- CI-Gates
- Tests und CI für eine aktualisierte Erweiterung
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
Werden Sie Exponential-Partner
Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.