Datenbankunterstützung #

Diese Seite richtet sich an Administratoren, die die Datenbank einer Exponential-Site auswählen, installieren und betreiben, und an Entwickler, deren Code auf jeder Datenbank funktionieren muss. Sie beantwortet vier Fragen an einer Stelle: welche Datenbanken Exponential 6.0.x unterstützt, in welcher Reihenfolge sie empfohlen werden, was jede von ihnen braucht und wie gründlich jede getestet wird. Jede Angabe auf dieser Seite wurde am Code und an der Continuous Integration der Linie 6.0.15 überprüft; wo sich etwas nicht überprüfen ließ, sagt die Seite das.

Das Schritt-für-Schritt-Kapitel für den Betrieb, in dem jede Einstellung erklärt wird, ist Kapitel 9 der Installationsanleitung, Datenbanken. Diese Seite ist der Überblick und die Aussage zur Unterstützung; überall, wo es um Einzelheiten geht, verweist sie auf dieses Kapitel.

Inhalt #

1. Die unterstützten Datenbanken in ihrer Reihenfolge
2. Auf einen Blick
3. Versionen, am Code überprüft
4. PHP-Erweiterungen
5. Die Einstellungen: DatabaseSettings in site.ini
6. Unterstützung durch die Installer
7. SQLite 3, der Standard
8. PostgreSQL
9. MongoDB
10. MariaDB
11. Oracle
12. MySQL
13. Microsoft SQL Server: möglich mit zusätzlichem Aufwand
    • Ein Ausgangspunkt: die Erweiterung xrowmssql
14. Zeichensätze und Kollationen
15. Performance und Skalierung
16. Backup und Wiederherstellung
17. Eine Site auf eine andere Datenbank umziehen
18. Testabdeckung (CI)
19. Welche Datenbank verwendet meine Site?
20. Verwandte Seiten

Die unterstützten Datenbanken in ihrer Reihenfolge #

Unterstützte Datenbanken (Exponential 6.0.x) in der Reihenfolge der Empfehlung: 1. SQLite 3 (der Standard) · 2. PostgreSQL · 3. MongoDB · 4. MariaDB · 5. Oracle · 6. MySQL. Microsoft SQL Server ist derzeit nachweislich mit zusätzlichem Aufwand möglich.

Dies ist die offizielle Reihenfolge des Projekts für Exponential 6.0.x. In dieser Reihenfolge werden die Datenbanken empfohlen, dokumentiert und in der gesamten Dokumentation aufgeführt. Alle sechs werden unterstützt: Jede von ihnen hat einen Treiber im Kernel oder in einer mitgelieferten Erweiterung, einen Eintrag im Setup-Assistenten und einen Weg in den Installern für die Kommandozeile.

Was die Reihenfolge in der Praxis bedeutet:

1. SQLite 3 ist der Standard. Der Setup-Assistent wählt es vor, exp:install verwendet es, wenn kein --db angegeben ist, und die Vorlage des Kickstarters nennt es zuerst. Es braucht keinen Datenbankserver: Das gesamte Content-Repository ist eine einzige Datei. Mit dem Treiber, den Exponential mitliefert, ist es eine vollwertige Produktionsdatenbank für eine Site, die von einem Rechner ausgeliefert wird.
2. PostgreSQL ist der empfohlene Datenbankserver: striktes SQL, Sperren auf Zeilenebene, eigene Replikation und Point-in-Time-Recovery, und es wird bei jedem Push in der CI getestet.
3. MongoDB wird über einen Adapter unterstützt, der die SQL-artigen Aufrufe des Kernels in MongoDB-Operationen übersetzt. Es ist die Wahl für Organisationen, die auf MongoDB standardisiert haben; lesen Sie seine Grenzen, bevor Sie sich dafür entscheiden.
4. MariaDB läuft auf demselben Treiber wie MySQL (mysqli). Es ist der MySQL-kompatible Server, den das Projekt bevorzugt.
5. Oracle (19c und neuer) wird über die Erweiterung ezoracle unterstützt, die composer.json voraussetzt; sie ist deshalb in jeder Installation vorhanden.
6. MySQL wird auf demselben Treiber wie MariaDB unterstützt und in der CI getestet. Es steht am Ende der Reihenfolge, nicht weil es schlechter funktioniert, sondern weil das Projekt für neue Sites zuerst die anderen empfiehlt.

Für Microsoft SQL Server gibt es in Exponential 6.0.x keinen Treiber. Er ist nachweislich möglich: Die Datenbankschicht ist eine kleine, dokumentierte Schnittstelle, und alles, was geschrieben werden müsste, ist unter Microsoft SQL Server aufgeführt. Eine für die Linie 4.x geschriebene Erweiterung, se7enxweb/xrowmssql, ist der naheliegende Ausgangspunkt für diese Arbeit.

Auf einen Blick #

Versionen, am Code überprüft #

Für jede Datenbank gibt es drei verschiedene Zahlen, die man leicht verwechselt:

• Untergrenze des Assistenten: die älteste Serverversion, die der Setup-Assistent akzeptiert, aus eZSetupDatabaseMap() in kernel/setup/ezsetupcommon.php. Sie ist eine technische Untergrenze aus früheren Releases, keine Empfehlung.
• Praktisches Minimum: die älteste Version, die die aktuellen Treiber tatsächlich brauchen, wie es der Treibercode und die Treiberdokumentation angeben.
• Im Einsatz gesehen: die Versionen, auf denen das Projekt seinen Entwicklungsserver und seine CI betreibt.

Verwenden Sie eine Serverversion, für die Ihr Anbieter noch Sicherheitskorrekturen liefert. Die Untergrenzen gibt es, damit der Assistent einen alten Server nicht von vornherein ablehnt; sie sind kein Versprechen, dass ein Server dieses Alters mit den aktuellen Treibern funktioniert.

PHP. Exponential 6.0.x läuft auf PHP 8.0 bis 8.5 (PHP 7.4 ohne Support nutzbar) (composer.json, "php": "^7.4 || ... || ^8.8"). Die Datenbanktreiber folgen diesem Bereich mit einer Ausnahme: Der MongoDB-Adapter braucht PHP 8.2 oder neuer. Velocity, der empfohlene Webserver, braucht PHP 8.1. Siehe Kapitel 2.

PHP-Erweiterungen #

Eine Datenbankerweiterung ist erforderlich; der kritische Test database_extensions des Setup-Assistenten ist bestanden, wenn mindestens eine von sqlite3, mysqli, pgsql, mongodb und oci8 geladen ist (settings/setup.ini, [database_extensions] Extensions=sqlite3;mysqli;pgsql;mongodb;oci8, Require=one). Installieren Sie nur die, die Ihre Site verwendet.

Prüfen Sie mit php -m, welche Erweiterungen ein PHP hat, und denken Sie daran, dass das PHP des Webservers und das PHP der Kommandozeile getrennt konfiguriert sind: Prüfen Sie beide. Der optionale Test database_all_extensions des Assistenten listet die fehlenden Datenbankerweiterungen auf; er dient nur zur Information.

Die Einstellungen: DatabaseSettings in site.ini #

Die Verbindung wird in settings/site.ini im Block [DatabaseSettings] konfiguriert und in settings/override/site.ini.append.php oder in der site.ini.append.php eines Siteaccess überschrieben (nie an Ort und Stelle geändert). Die Installer schreiben diese Überschreibung für Sie. DatabaseImplementation benennt den Treiber mit einem Alias, den ImplementationAlias[] einer Klasse zuordnet:

Die folgenden Beispiele verwenden Platzhalter für Namen und Passwörter; tragen Sie Ihre eigenen Werte in Ihre Überschreibungsdatei ein und committen Sie diese Datei nie. Jeder Schlüssel wird in 9.1 Wie Exponential einen Datenbanktreiber wählt erklärt.

1. SQLite 3

[DatabaseSettings]
DatabaseImplementation=sqlite3
# a plain name lives in var/storage/sqlite3/; a name starting with / is an absolute path
Database=exponential.db
# seconds a transaction waits for the writers ahead of it; keep it below the web server's request timeout
SQLiteTransactionWait=25
# PRAGMAs over the driver's defaults, one name=value per line (empty keeps the defaults)
SQLitePragmas[]

2. PostgreSQL

[DatabaseSettings]
DatabaseImplementation=ezpostgresql
Server=localhost
Port=5432
User=exponential
Password=<the password>
Database=exponential
UsePersistentConnection=disabled

3. MongoDB

[DatabaseSettings]
DatabaseImplementation=mongodb
Server=localhost
Port=27017
# required, also on a server without access control
User=exponential
Password=<the password>
Database=exponential

4. MariaDB und 6. MySQL

[DatabaseSettings]
DatabaseImplementation=ezmysqli
Server=localhost
# empty: 3306
Port=
User=exponential
Password=<the password>
Database=exponential
# a Unix socket instead of host and port
Socket=disabled
Charset=utf-8
UsePersistentConnection=disabled

5. Oracle

[DatabaseSettings]
DatabaseImplementation=ezoracle
User=exponential
Password=<the password>
# the connect string: Easy Connect host:port/service_name, a TNS alias or a full descriptor;
# Server and Port are not used by this driver
Database=127.0.0.1:1521/FREEPDB1
Charset=utf-8

[ExtensionSettings]
ActiveExtensions[]=ezoracle

Leeren Sie nach einer Änderung den INI-Cache, damit jeder Prozess sie liest, und starten Sie die Worker von Velocity neu, wenn Velocity die Site ausliefert:

php bin/php/ezcache.php --clear-tag=ini --allow-root-user
php bin/php/console exp:velocity restart --allow-root-user

Den wirksamen Wert lesen Sie mit php bin/php/console exp:ini get site.ini/DatabaseSettings/DatabaseImplementation. Ein falsch geschriebener Alias bricht die Anfrage nicht sofort ab: Der Kernel weicht auf eine Null-Datenbank aus und protokolliert „Database implementation not supported“ in var/log/error.log, und danach schlägt jede Inhaltsseite fehl. Lesen Sie zuerst error.log, wenn sich eine Site verhält, als wäre ihre Datenbank nicht erreichbar.

Unterstützung durch die Installer #

Exponential hat drei Installer im Kernel. Alle drei unterstützen alle sechs Datenbanken.

• Fehlt die Erweiterung sqlite3, wählt der Assistent die erste Datenbank, deren Erweiterung geladen ist, und weist darauf hin.
• Keiner der Installer legt die Datenbank oder den Benutzer auf einem Datenbankserver an. Legen Sie beides vorher an; die Abschnitte zu den einzelnen Datenbanken unten zeigen, wie.
• exp:install nimmt das Passwort aus der Umgebungsvariablen EXP_INSTALL_DB_PASSWORD, sodass es weder in der Shell-History noch in der Prozessliste erscheint.
• Demo-Installationen. Dieses Repository hat keinen eigenen Demo-Installer; Demonstrations-Sites werden mit denselben Befehlen installiert (exp:install oder der Kickstarter), meist auf SQLite.
• Exponential Platform (das auf Symfony basierende Schwesterprodukt, nicht der 6.0.x-Kernel) hat einen eigenen SQLite-Installer, der pdo_sqlite verwendet; siehe SQLite für Exponential Platform.

Die Installer sind in Kapitel 5, der Setup-Assistent, Kapitel 6, der Kickstarter und Kapitel 7, die Installation über die Konsole beschrieben.

1. SQLite 3, der Standard #

Was es ist. Das gesamte Content-Repository in einer Datei unterhalb von var/storage/sqlite3/, geöffnet vom Treiber eZSQLite3DB. Kein Serverprozess, kein Netzwerk, keine Benutzerkonten zu verwalten.

Was der Treiber zu SQLite hinzufügt. Write-Ahead-Logging (WAL), damit Seitenaufrufe weiterlesen können, während ein Redakteur veröffentlicht; für einen Webserver gewählte PRAGMAs der Verbindung (synchronous=NORMAL, ein Seiten-Cache von 64 MB, eine Memory-Map von 256 MB, ein Busy-Timeout von 5 Sekunden); die Funktionen, die SQLite fehlen (md5(), die Aggregate BIT_OR und BIT_AND, mit denen die Content-Engine Sprachmasken bildet); eine Umschreibung von MySQLs UPDATE ... JOIN; und seit 6.0.15 eine Schreibwarteschlange: Jede Transaktion nimmt eine exklusive Sperre auf <database>.writer-lock und führt dann BEGIN IMMEDIATE aus, sodass gleichzeitige Veröffentlichungen warten, bis sie an der Reihe sind (bis zu SQLiteTransactionWait Sekunden, Standard 25), statt mit „database is locked“ fehlzuschlagen. Sitzungsanweisungen, die es nur in MySQL gibt (SET NAMES, SET FOREIGN_KEY_CHECKS und ähnliche), werden angenommen und ignoriert.

Wann es passt. Ein Rechner, beliebig viele Leser, ein Redaktionsteam. In den Lasttests des Projekts skalierten gleichzeitige Leser mit der Anzahl der Prozesse, und 16 gleichzeitige Schreiber liefen ohne Fehler durch, in der Warteschlange. Wählen Sie stattdessen einen Datenbankserver, wenn mehr als ein Rechner in die Datenbank schreiben muss (WAL braucht gemeinsamen Speicher auf einem Host, ein Netzwerkdateisystem ist also kein Ersatz), wenn viele Redakteure den ganzen Tag über gleichzeitig große Änderungen veröffentlichen oder wenn Sie Replikation oder Benutzer und Berechtigungen auf Datenbankebene brauchen.

Dateien und Berechtigungen. Die Datenbank besteht aus vier Dateien: der Datenbank, -wal, -shm und .writer-lock. Jeder Prozess, der die Site verwendet (das PHP des Webservers, die Worker von Velocity, Cronjobs, Konsolenbefehle), muss in das Verzeichnis und die Dateien schreiben können; geben Sie ihnen eine gemeinsame Gruppe, den Verzeichnismodus 2775 und eine umask von 0002. Liefern Sie das Verzeichnis nie über HTTP aus (die mitgelieferten Rewrite-Regeln tun das nicht).

Grenzen. Ein Host; ein Schreiber zur selben Zeit (in der Warteschlange); keine eigene Replikation; die Zugriffskontrolle ist die des Dateisystems.

Die vollständige Behandlung mit jedem PRAGMA, dem Verhalten der Warteschlange unter Last, Überwachung und Wartung (ANALYZE, VACUUM, die WAL-Datei) finden Sie in 9.2 SQLite 3: eine Produktionsdatenbank in einer Datei. Die aufgabenorientierte Einführung ist SQLite-Datenbankunterstützung, die Treiberspezifikation Der SQLite3-Datenbanktreiber.

2. PostgreSQL #

Was es ist. Der Treiber eZPostgreSQLDB auf der PHP-Erweiterung pgsql.

Die Datenbank anlegen. Machen Sie den Benutzer der Site zum Eigentümer der Datenbank (ab PostgreSQL 15 dürfen andere Benutzer im Schema public keine Tabellen mehr anlegen):

sudo -u postgres createuser --pwprompt exponential
sudo -u postgres createdb --owner=exponential --encoding=UTF8 --template=template0 exponential

pgcrypto. Der Treiber berechnet MD5 mit digest() aus pgcrypto. Der Installer führt CREATE EXTENSION IF NOT EXISTS pgcrypto aus; als vertrauenswürdige Erweiterung (PostgreSQL 13 und neuer) darf der Eigentümer der Datenbank sie anlegen. Fehlt sie auf dem Server, installieren Sie das Contrib-Paket von PostgreSQL Ihrer Distribution und legen Sie sie als Eigentümer oder als Superuser an. Die Meldung des Assistenten, wenn sie fehlt, lautet „The 'digest' function is not available in your database, and Exponential cannot run without it.“

Sequenzen. Auto-Increment-Spalten verwenden Sequenzen mit dem Namen <table>_<column>_seq. Nachdem Sie Daten mit expliziten IDs geladen haben, korrigieren Sie sie (SELECT setval('ezcontentobject_id_seq', (SELECT max(id) FROM ezcontentobject));); der Schema-Installer tut das selbst, nachdem er Daten geladen hat.

Grenzen. Keine, die den eigenen Code von Exponential betreffen. Erweiterungscode, der für MySQL geschrieben wurde (Quoting mit Backticks, SET-Anweisungen, die es nur in MySQL gibt), schlägt hier fehl; siehe Hinweise für alle Engines.

Einzelheiten: 9.4 PostgreSQL.

3. MongoDB #

Was es ist. Der Adapter expMongoDB auf der PHP-Erweiterung mongodb und dem MongoDB\Client der Bibliothek. Er übersetzt die SQL-artigen Aufrufe des Kernels in die Operationen find, aggregate, Insert, Upsert und Delete. MongoDB kam mit 6.0.14; sein Schema-Handler ist expMongoSchema (settings/dbschema.ini, Typ mongo).

Den Benutzer anlegen, und zwar in der eigenen Datenbank der Site (der Adapter setzt immer <user>:<password>@ in die Verbindungs-URI, und MongoDB verwendet die Datenbank in der URI als Authentifizierungsdatenbank):

mongosh --eval '
  db.getSiblingDB("exponential").createUser({
    user: "exponential",
    pwd: passwordPrompt(),
    roles: [ { role: "readWrite", db: "exponential" }, { role: "dbAdmin", db: "exponential" } ]
  })'

Nach der Installation legen Sie die Indizes an, auf die sich die Abfragen des Kernels verlassen (mongosh "mongodb://exponential@localhost:27017/exponential" --file bin/mongodb/create_indexes.js), und führen dann die Cronjobs einmal aus, um den Suchindex aufzubauen.

Grenzen von MongoDB #

Aus MongoDB als Datenbank und Abschnitt 26 der Portierungsreferenz:

• Der Adapter führt nie echtes SQL aus. Handgeschriebenes SQL, das er nicht übersetzen kann, liefert ein leeres Ergebnis und protokolliert eine Warnung (suchen Sie in den Logs nach MONGO TODO). Erweiterungen mit eigenem SQL brauchen unter Umständen einen eigenen Weg für MongoDB.
• Das tiefe Neuerzeugen der URL-Aliase nach dem Verschieben von Teilbäumen ist unvollständig; die Listenseiten für Rollen und Richtlinien können leer sein, obwohl die Berechtigungen durchgesetzt werden; einige Cronjobs sind nicht portiert; eztags ist nicht nutzbar; der Checkout des Shops und die Zeitplanung von ezflow sind nicht durchgehend getestet.
• Der SQL-Abfrage-Cache greift nicht.
• Es gibt keine SQL-Update-Dateien. Die Upgrade-Prüfung vergleicht Collections statt Tabellen und gibt die mongosh-Befehle aus, die die fehlenden anlegen.

Einzelheiten: 9.5 MongoDB.

4. MariaDB #

Was es ist. Derselbe Treiber wie für MySQL, eZMySQLiDB, auf der PHP-Erweiterung mysqli. Alles unter 6. MySQL gilt auch hier; die folgenden Hinweise betreffen nur die Unterschiede.

• Installieren Sie mit exp:install --db=mariadb (dasselbe wie --db=mysql) oder wählen Sie im Assistenten „MySQL Improved“.
• Legen Sie die Datenbank wie bei MySQL in utf8mb4 mit InnoDB als Standard an. In MariaDB bedeutet der Verbindungsname utf8 wie in MySQL das Drei-Byte-utf8mb3; siehe Zeichensätze und Kollationen.
• Backups mit mariadb-dump (oder dem älteren Namen mysqldump) --single-transaction.
• MariaDB ist nicht in der CI des Projekts; der Job für MySQL 8.0 testet denselben Treiber. MariaDB 10.5 läuft auf dem Entwicklungsserver.

5. Oracle #

Was es ist. Die Erweiterung ezoracle (Version 2.3.7, von composer.json als ~2.3.7 vorausgesetzt) liefert den Treiber eZOracleDB, den Schema-Handler eZOracleSchema, Konsolenbefehle (ext:ezoracle:<name>) und Cronjobs. Weil composer.json sie voraussetzt, liegt sie in jeder Installation unter extension/ezoracle; aktiviert wird sie nur für Sites, die Oracle verwenden.

Voraussetzungen. Oracle Database 19c oder neuer mit dem Zeichensatz AL32UTF8; PHP mit oci8, gebaut gegen einen Oracle-Client (der Instant Client genügt; ORACLE_HOME wird mit ihm nicht gebraucht); ein Benutzer, der Sitzungen, Tabellen, Views, Trigger, Sequenzen und Prozeduren anlegen darf. php extension/ezoracle/bin/php/ora-grant.php gibt die Berechtigungen aus, die ein DBA vergeben muss.

Verbindungen. ezoracle.ini [ConnectionSettings] bietet persistente Verbindungen, Database Resident Connection Pooling (DRCP, damit sich Hunderte von PHP-Workern einen Pool von Serverprozessen teilen), Wiederholungen, Failover, Timeouts für Aufrufe und Sitzungs-Tracing. Jede dieser Funktionen ist standardmäßig ausgeschaltet. Kommen die Einstellungen aus einer Site-Erweiterung statt aus settings/override/, führen Sie diese Erweiterung in ActiveExtensions[] vor ezoracle auf.

Oracles eigenes Verhalten, das Sie kennen sollten. Oracle speichert '' als NULL (OracleEmptyStringForNull=enabled gibt für Textspalten '' zurück); es vergleicht Zeichenketten unter Beachtung der Groß- und Kleinschreibung (OracleCaseInsensitive=enabled mit linguistischen Indizes aus ext:ezoracle:ci-indexes --create); und es lehnt AS vor einem Tabellenalias ab.

Grenzen. Exponential 6.0.15 oder neuer ist nötig (frühere Versionen bieten Oracle in den Installern nicht an). Oracle ist nicht in der CI des Projekts; Tests nur für Oracle in der Testsuite des Kernels werden auf anderen Engines übersprungen. Der SQL-Abfrage-Cache greift.

Einzelheiten: 9.6 Oracle 19c und neuer sowie README.md und INSTALL der Erweiterung in extension/ezoracle/.

6. MySQL #

Was es ist. Der Treiber eZMySQLiDB auf mysqli, die Engine, für die die meisten Erweiterungen von Drittanbietern ursprünglich geschrieben wurden.

Die Datenbank und den Benutzer anlegen. Eine globale Berechtigung ist nicht nötig:

CREATE DATABASE exponential CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'exponential'@'localhost' IDENTIFIED BY '<a strong password>';
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER,
      LOCK TABLES, CREATE TEMPORARY TABLES
   ON exponential.* TO 'exponential'@'localhost';

InnoDB. Der Installer legt InnoDB-Tabellen an, wenn der Server sie anbietet; Transaktionen brauchen InnoDB. php bin/php/ezconvertmysqltabletype.php --list listet die Tabellentypen einer älteren Installation auf, --newtype=InnoDB konvertiert sie.

Lese-Replikate. UseSlaveServer=enabled mit SlaveServerArray[] und den zugehörigen Schlüsseln schickt Lesezugriffe an ein Replikat, das pro Anfrage zufällig gewählt wird; Schreibzugriffe gehen an Server. Dies ist die einzige Engine mit eingebauter Aufteilung der Lesezugriffe.

Grenzen. Der Verbindungszeichensatz utf-8 wird auf MySQLs utf8 (drei Bytes) abgebildet, sodass Zeichen außerhalb der Basic Multilingual Plane, etwa Emoji, nicht durch die Verbindung gelangen, selbst wenn die Tabellen utf8mb4 sind.

Einzelheiten: 9.3 MySQL und MariaDB.

Microsoft SQL Server: möglich mit zusätzlichem Aufwand #

Die Aussage. Microsoft SQL Server ist derzeit nachweislich mit zusätzlichem Aufwand möglich. In Exponential 6.0.x wird er nicht unterstützt: Es gibt keinen Treiber, keinen Schema-Handler und keinen Eintrag in den Installern dafür, und nichts auf dieser Seite ist als Versprechen eines Releases zu verstehen, das einen solchen enthält.

Was es heute gibt.

• Eine kleine Treiberschnittstelle. Jede Datenbank wird über eZDBInterface (lib/ezdb/classes/ezdbinterface.php) angesprochen, und die fünf vorhandenen Treiber zeigen, wie man sie für so unterschiedliche Engines wie eine Dateidatenbank, drei SQL-Server und einen Dokumentenspeicher implementiert. Besonders der MongoDB-Adapter beweist, dass der Kernel nicht von einem SQL-Dialekt abhängt.
• Ein Engine-neutrales Schema. Das Schema und die Anfangsdaten des Kernels liegen im generischen Format .dba vor (share/db_schema.dba, share/db_data.dba), das ein Schema-Handler in die DDL der jeweiligen Engine umsetzt.
• Austauschbare Schema-Handler. settings/dbschema.ini ordnet einem Typ eine Handler-Klasse zu (SchemaPaths[], SchemaHandlerClasses[]), sodass eine neue Engine über Einstellungen registriert wird und nicht durch eine Änderung am Kernel.
• Erweiterbare Treiber-Aliase. site.ini [DatabaseSettings] ImplementationAlias[] wird aus der site.ini.append.php einer Erweiterung ergänzt, so wie ezoracle die Aliase ezoracle und oracle hinzufügt.
• Erweiterbare Installer-Typen. Die Vorlage des Kickstarters sagt „other values are possible if provided by extension“.
• Werkzeuge, die SQL Server bereits lesen. Der Datenbankmanager der Erweiterung sevenx_dse (AdminNeo, ein Fork von Adminer) bringt einen MS-SQL-Treiber zum Durchsehen und Bearbeiten von Tabellen mit, und der generische SQLAlchemy-Exporter in Abschnitt 18.6 der MongoDB-Portierungsreferenz kann SQL Server über pyodbc lesen. Keines von beiden ist ein Weg, eine Site auf SQL Server zu betreiben.
• PHP-Treiber. Microsoft veröffentlicht die Erweiterungen sqlsrv und pdo_sqlsrv für PHP unter Linux und Windows. Prüfen Sie in Microsofts Support-Matrix, welche PHP-Versionen ein Release abdeckt; mit Exponential wurde das nicht getestet.

Ein Ausgangspunkt: die Erweiterung xrowmssql #

Eine Erweiterung für SQL Server gibt es bereits, geschrieben für frühere Fassungen der Datenbank-API: se7enxweb/xrowmssql, „A full-featured open source Microsoft SQL Server database plugin“ (Beschreibung des Repositorys). Ihre README nennt sie „Microsoft SQL Server database extension for eZ Publish 4.x and SQL Server 2005/2008“, „Developed by xrow GmbH“, und sagt, dass sie einen Datenbanktreiber und eine Datenbank-Schemadefinition enthält. Das Repository enthält den Code, wie er im Oktober 2013 aus xrow/xrowmssql kopiert wurde; seitdem kamen nur Funding-Dateien hinzu (sein git log). Auf Exponential 6 wurde sie nicht ausgeführt, und diese Seite behauptet nicht, dass sie dort funktioniert.

Was sie bereitstellte (gelesen aus ihren Verzeichnissen classes/, settings/, sql/, patch/ und docs/ am 18. Oktober 2026):

Ihre extension.xml nennt die Version 1.0.0 und „GNU General Public License v2.0“, während die Datei LICENSE des Repositorys die GPL in Version 3 ist; prüfen Sie beides, bevor Sie Code wiederverwenden. Die Einstellungen erwarten, dass das Verzeichnis der Erweiterung extension/mssql heißt.

Wie sie sich auf die Arbeitsliste unten abbilden lässt und was modernisiert werden müsste:

Zusammengenommen zeigt xrowmssql, wie jedes Teil für SQL Server schon einmal gelöst wurde, und liefert einen Schema-Handler und ein Treibergerüst als Ausgangspunkt; damit es auf Exponential 6 läuft, muss es auf PHP 8 und sqlsrv portiert, seine Idiome aus SQL Server 2005 müssen ersetzt und die Zeilen ergänzt werden, die es nie abgedeckt hat.

Was fehlt: die Arbeitsliste.

Wie groß diese Arbeit ist, wurde nicht gemessen, und eine Schätzung wird hier nicht gegeben. Wer sie übernehmen möchte, ist willkommen: Beginnen Sie bei xrowmssql für die Besonderheiten von SQL Server und bei der Erweiterung ezoracle als Vorbild für einen aktuellen Treiber, der außerhalb des Kernels ausgeliefert wird, und eröffnen Sie ein Issue im Software-Tracker, um die Arbeit abzustimmen.

Zeichensätze und Kollationen #

Exponential speichert und liefert Text als UTF-8. Jede Engine nennt das anders:

Die Verbindung bei MySQL und MariaDB. Charset=utf-8 (der Standard) wird als utf8 an den Server geschickt, was beide Server als das Drei-Byte-utf8mb3 behandeln. Halten Sie die Datenbank trotzdem in utf8mb4: Es kostet nichts. Lässt sich der Zeichensatz der Verbindung nicht setzen, läuft der Treiber weiter und protokolliert die Warnung „could not set the connection charset“; sie wird nur protokolliert, wenn Warnungen protokolliert werden (site.ini [DebugSettings] AlwaysLog[]=warning).

Groß- und Kleinschreibung. Eine Suche nach Login oder Kennung, die für die Kollationen von MySQL ohne Beachtung der Groß- und Kleinschreibung geschrieben wurde, findet auf PostgreSQL, Oracle oder MongoDB unter Umständen nichts. Vergleichen Sie lower(...) auf beiden Seiten, wo die Groß- und Kleinschreibung keine Rolle spielen darf.

Die Seite Systeminformationen (Setup > Systeminformationen) warnt, wenn der Zeichensatz der Verbindung nicht UTF-8 ist.

Performance und Skalierung #

• Die meisten Anfragen erreichen die Datenbank nie. Der Response-Cache von Velocity (anonyme Besucher), der View-Cache für Inhalte und der Template-Block-Cache antworten zuerst; darunter beantwortet der optionale SQL-Abfrage-Cache (settings/querycache.ini, standardmäßig Mode=off) wiederholte SELECT-Anweisungen auf jeder Engine außer MongoDB. Messen Sie mit php bin/php/console exp:benchmark.
• SQLite skaliert Lesezugriffe mit der Anzahl der Prozesse; Schreibzugriffe kommen in die Warteschlange. Rechnen Sie mit bis zu 64 MB Seiten-Cache je Prozess, der die Datenbank geöffnet hat (SQLitePragmas[]=cache_size=-16384 senkt das auf 16 MB).
• PostgreSQL, MariaDB, MySQL skalieren Schreibzugriffe mit Sperren auf Zeilenebene. UsePersistentConnection=enabled hält eine Verbindung je PHP-Prozess; unter den persistenten Workern von Velocity behält jeder Worker seine Verbindung ohnehin. MySQL und MariaDB können Lesezugriffe an Replikate schicken (UseSlaveServer).
• MongoDB: Die Performance hängt von der Anzahl der Anweisungen pro Seite ab; legen Sie die Indizes aus bin/mongodb/create_indexes.js an, ohne die Abfragen auf Teilbäume und Suchen nach URL-Aliasen ganze Collections durchlaufen.
• Oracle: Eine neue dedizierte Sitzung kostet einige zehn Millisekunden; verwenden Sie Persistent=enabled und DRCP (ezoracle.ini [ConnectionSettings]) sowie die Prefetch-Einstellungen von [PerformanceSettings].
• Langsame Anweisungen: [DatabaseSettings] SlowQueriesOutput=<milliseconds> mit SQLOutput=enabled listet auf jeder Engine die langsameren Anweisungen in der Debug-Ausgabe auf; auf MySQL und MariaDB ergänzt QueryAnalysisOutput=enabled ein EXPLAIN; Oracle protokolliert langsame Anweisungen in var/log/oracle-slow.log, wenn [LogSettings] SlowQueryThreshold gesetzt ist.

Die Vergleichstabelle in 9.7 stellt Nebenläufigkeit, Replikate und persistente Verbindungen nebeneinander.

Backup und Wiederherstellung #

Ein vollständiges Backup umfasst die Datenbank und die Dateien: var/storage (Uploads und Bildvarianten), settings/override und settings/siteaccess. Schalten Sie für eine Wiederherstellung den Wartungsmodus ein (php bin/php/maintenance.php on --allow-root-user) und leeren Sie danach jeden Cache (php bin/php/ezcache.php --clear-all --allow-root-user und, mit Velocity, php bin/php/console exp:velocity cache clear --apply --allow-root-user). Das vollständige Verfahren steht in Kapitel 10, Backups und Wiederherstellung.

--single-transaction erzeugt einen konsistenten Dump von InnoDB-Tabellen, ohne sie zu sperren. Befehle, die ein Passwort auf der Kommandozeile erhalten, zeigen es anderen Benutzern des Rechners; verwenden Sie lieber die Passwortabfragen der Werkzeuge oder Optionsdateien.

Eine Site auf eine andere Datenbank umziehen #

Die Inhalte bleiben dieselben, wenn eine Site ihre Datenbank wechselt; nur der Ort, an dem sie gespeichert sind, ändert sich. Planen Sie ein Wartungsfenster ein: Zwischen dem Dump und der Umstellung darf nichts veröffentlicht werden.

• Zwischen SQL-Engines (SQLite, PostgreSQL, MariaDB, MySQL und Oracle mit ezoracle): mit bin/php/ezsqldumpschema.php --format=generic --output-array --output-types=all in eine .dba-Datei exportieren und mit bin/php/ezsqlinsertschema.php --insert-types=all laden, wobei Sie die Engine mit --type wählen (mysql, postgresql, sqlite3, oracle). Richten Sie dann DatabaseImplementation und die Verbindungsschlüssel auf die neue Engine aus, leeren Sie alle Caches und starten Sie die Worker neu.
• Nach Oracle: die eigenen Befehle der Erweiterung, ext:ezoracle:mysql2oracle-schema und ext:ezoracle:mysql2oracle-data.
• Nach MongoDB: die Skripte in bin/mongodb/ (export_mysql.sh, mysql2ndjson.py, import_all.sh, validate_ndjson.sh) und Abschnitt 18 der Portierungsreferenz.
• Vor dem Wiederfreigeben prüfen: Vergleichen Sie die Zeilenzahlen von ezcontentobject, ezcontentobject_tree und ezcontentobject_attribute auf beiden Seiten; korrigieren Sie auf PostgreSQL die Sequenzen; melden Sie sich an und veröffentlichen Sie ein Testobjekt.
• Spätere Upgrades verwenden die Update-Dateien der Engine, auf der die Site jetzt läuft, nicht die der Engine, auf der sie installiert wurde.

Die Schritt-für-Schritt-Fassung ist 9.9 Eine bestehende Site auf eine andere Engine umstellen.

Testabdeckung (CI) #

Was die Continuous Integration des Projekts (.github/workflows/) bei jedem Push ausführt, je Datenbank. „Unit-Tests des Treibers“ bedeutet Tests, die eine echte Datenbankdatei öffnen oder das SQL des Treibers ohne Server testen; „Datenbanktests“ bedeutet die Tests des Legacy-Toolkits, die gegen einen laufenden Server mit einer Wegwerf-Datenbank pro Test laufen.

PHP 8.0, die älteste unterstützte Version, und PHP 7.4 (ohne Support nutzbar) prüft der Quality-Workflow mit einer Syntaxprüfung jeder PHP-Datei und einem Boot-Smoke-Test ohne Datenbank. Die Testsuiten und wie man sie lokal ausführt, beschreibt Continuous Integration.

Welche Datenbank verwendet meine Site? #

• In der Administration: Setup > Systeminformationen, die Karte Datenbank: Engine und Serverversion, Treiberklasse, die Datei (SQLite) oder Server und Datenbankname, Zeichensatz, Anzahl der Tabellen und Größe.

• Auf der Kommandozeile:

  php bin/php/console exp:ini get site.ini/DatabaseSettings/DatabaseImplementation --allow-root-user

• Setup > Upgrade-Prüfung, „Überprüfe Datenbankkonsistenz“, vergleicht die Tabellen, Felder und Indizes mit dem Schema des Release für MySQL und MariaDB, PostgreSQL, SQLite und MongoDB (Die Upgrade-Prüfung).

• Im Code: eZDB::instance()->databaseName() liefert sqlite, postgresql, mongo, mysql oder oracle.

Verwandte Seiten #

• Kapitel 9, Datenbanken: die Referenz für den Betrieb jeder Engine.
• Kapitel 2, Anforderungen und Unterstützte Betriebssysteme.
• SQLite-Datenbankunterstützung, SQLite: Transaktionen warten in einer Warteschlange auf die Schreibsperre, Der SQLite3-Datenbanktreiber.
• MongoDB als Datenbank und die Portierungsreferenz zur MongoDB-Unterstützung im Kernel.
• Die Treiber für SQLite und Oracle, Datenbanktreiber und Installer, September 2026.
• SQL-Abfrage-Cache, Installation mit einem Befehl, Kickstarter, Systeminformationen.
• Freie Dokumentation: Diese Seiten dürfen frei kopiert, übersetzt und verbessert werden.