Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,090 of 9,090 pages
About the help in other languages
All help pages

Tests ohne Datenbank und Testsuiten

Wie die PHPUnit-Konfiguration von Exponential organisiert ist - der Bootstrap, die Suiten in phpunit.xml, die ausgeschlossenen Gruppen, die PHPUnit-Version je PHP-Version - und wie Sie Tests schreiben und ausführen, die…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/software-engineers/db-less-tests-and-test-suites.md

On this page

This page is a translation. Read the English original

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

  1. Die Konfiguration
  2. Die Suiten
  3. Tests ausführen
  4. Einen Test ohne Datenbank schreiben
  5. 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 in tests/toolkit/ (ezpTestCase, ezpDatabaseTestCase ...). Es startet den Kernel nicht; Tests, die ihn brauchen, tun das selbst.
  • Die Gruppen database, mail-live, mongodb-live und network-live sind 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

SuiteDeckt ab
securitytests/tests/kernel/classes/security
kernel-classesKernel-Klassen, die Template-Operatoren von kernel/common, das Fehlermodul
kernel-content, kernel-datatypes, kernel-private, kernel-searchInhalte, Datentypen, REST und Konsolenbefehle, Suche
kernel-contentfinder, kernel-contentcheck, kernel-logviewer, kernel-requestlogneuere Kernel-Subsysteme
libdie Bibliotheken
mongodb, mongodb-liveder MongoDB-Adapter; die Live-Suite braucht Server
cjw_newsletter, explayouts_admin, ezjscore, ezmultiupload, expservices, ezoe, maps, admin-extensionsErweiterungen
qualitydie eigenen Codestil-Sniffs des Projekts, die Git-Hooks, die Workflow-Regeln
designdie 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 run

Ein 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/override noch Caches in var/; 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.php und 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.json Ihren 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-test

fü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

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.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x