Datenbank- und Live-Tests #

Diese Seite richtet sich an PHP-Entwickler, die Tests schreiben oder ausführen, die eine Datenbank, einen MongoDB-Server oder eine laufende Site brauchen. Diese Tests werden aus dem normalen PHPUnit-Lauf herausgehalten, damit vendor/bin/phpunit auf jedem Laptop und jedem CI-Runner besteht, und separat gegen Server ausgeführt, die Sie nennen.

Inhalt #

1. Welche Tests live sind
2. Datenbanktests mit runtests.php
3. Einen Datenbanktest schreiben
4. Integrationstests für MongoDB und MySQL
5. Live-HTTP-Tests
6. Passwörter sicher übergeben
7. In der CI

Welche Tests live sind #

Ein Live-Test liest aus Umgebungsvariablen, wo sein Server ist, und überspringt sich unter Nennung der Variable, wenn sie nicht gesetzt ist. Kein Test trägt einen eigenen Hostnamen, ein Konto oder ein Passwort.

Datenbanktests mit runtests.php #

Der ältere Runner tests/runtests.php legt das Schema in einer Datenbank an, die Sie nennen, optional eine Datenbank pro Test, und führt die Gruppe database aus:

php -d date.timezone=America/Los_Angeles tests/runtests.php --dsn mysql://[email protected]/testdb --db-per-test
php tests/runtests.php --dsn postgresql://[email protected]/testdb --db-per-test

Verwenden Sie eine Wegwerf-Datenbank und ein Konto, das Datenbanken anlegen und löschen darf. Richten Sie ihn niemals auf die Datenbank einer Site: Der Runner baut das Schema neu auf.

Einen Datenbanktest schreiben #

Das Toolkit in tests/toolkit/ stellt ezpDatabaseTestCase bereit (tests/toolkit/ezpdatabasetestcase.php), das die Datenbankverbindung für einen Testfall einrichtet:

<?php
/**
 * @group database
 */
class acmeReportStorageTest extends ezpDatabaseTestCase
{
    public function testStoreAndFetch()
    {
        $item = new acmeReportItem( array( 'status' => 'open', 'amount' => 2 ) );
        $item->store();
        $fetched = acmeReportItem::fetch( $item->attribute( 'id' ) );
        $this->assertSame( 'open', $fetched->attribute( 'status' ) );
    }
}

Halten Sie Datenbanktests wenige und konzentriert auf das, was wirklich die Datenbank braucht (SQL, Transaktionen, Speicherung), und testen Sie die Logik darum herum ohne eine (PHPUnit ohne Datenbank).

Integrationstests für MongoDB und MySQL #

php vendor/bin/phpunit --testsuite mongodb-live

Live-HTTP-Tests #

Tests wie ApiKeyLiveTest und RestContentPermissionLiveTest rufen eine laufende Site über HTTP auf. Sie lesen EXP_TEST_PUBLIC_HOST (sonst den Host der SiteURL des Standard-Siteaccess), APIKEY_LIVE_BASES und APIKEY_LIVE_ADMIN_PASSWORD. Führen Sie sie gegen eine Testinstallation mit einem Testkonto aus, niemals gegen die Produktion und niemals mit einem gemeinsam genutzten Administratorkonto.

Ein Live-Test, der prüft, was der Webserver im Audit-Trail festgehalten hat, liest das Audit-Verzeichnis der Site, expAuditConfig::siteLogDir(), nicht das eigene Verzeichnis des Laufs unter var/tmp, das tests/bootstrap.php einrichtet.

Passwörter sicher übergeben #

Übergeben Sie ein Passwort über die Umgebung, gelesen aus einer Datei, die nur Sie lesen können, nicht auf der Kommandozeile, wo es in der Shell-History und der Prozessliste landet:

EXP_TEST_MYSQL_PASSWORD="$(cat ~/.exp-test-mysql-password)" EXP_TEST_MYSQL_USER=test EXP_TEST_MYSQL_DATABASE=testdb \
    php vendor/bin/phpunit tests/tests/lib/ezdb/mongodb/expMongoDBIntegrationTest.php

In der CI #

Der PHPUnit-Workflow führt Database tests auf MySQL 8.0 und PostgreSQL 15 aus (PHP 8.3, mit pgcrypto unter PostgreSQL), mit tests/runtests.php --dsn ... --db-per-test. SQLite ist durch Unit-Tests der Treiber in tests/tests/lib/ezdb/ abgedeckt, MongoDB durch Unit-Tests des Adapters ohne Server; die Gruppe mongodb-live wird in der CI nicht ausgeführt (Datenbankunterstützung).

Verwandte Seiten #

• Qualitätsprüfungen: Tests, die einen Live-Server brauchen
• Code für jede unterstützte Datenbank
• CI und das Nachstellen einer roten Prüfung
• Freie Dokumentation: diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.