Spezifikation: der SQLite-Installer von Exponential Platform #

Diese Seite ist die Referenz dafür, wie die Installer von Exponential Platform (der auf Symfony basierenden Plattform) eine vollständige Datenbank in einer einzigen SQLite-Datei anlegen: die Installationstypen, wie sich der Installationsbefehl unter SQLite verhält, wie Schema und Startdaten aufgebaut werden und welche Einstellungen SQLite auswählen. Lesen Sie sie, wenn Sie einen Plattform-Installer pflegen oder wissen müssen, warum sich eine Installation unter SQLite so verhält, wie sie es tut. Schritt-für-Schritt-Anweisungen finden Sie unter SQLite für Exponential Platform. Für den eigenen Treiber des Legacy-Kernels siehe SQLite3-Datenbanktreiber.

Kurz gesagt #

• Ein Installationstyp ist eine benannte Installer-Klasse; install <type> führt deren importSchema(), importData() und importBinaries() aus.
• Startdatendateien werden je Datenbank-Engine gesucht: <baseDataDir>/<dbms>/<relative>, wobei <dbms> einer der Werte mysql, postgresql oder sqlite ist.
• Unter SQLite legt der Installationsbefehl keine Datenbank an; die Datei entsteht bei der ersten Verbindung.
• Zusammengesetzte Primärschlüssel (id, version) bleiben erhalten, sodass Entwürfe ohne Fehler wegen einer verletzten Eindeutigkeitsbedingung bearbeitet werden können.

Installationstypen #

Ein Installationstyp wird mit einem Service-Tag registriert. Der Befehl install <type> führt importSchema(), importData() und importBinaries() der Klasse hinter dem Namen aus.

Suche nach Startdatendateien #

DbBasedInstaller::getKernelSQLFileForDBMS( $relative ) gibt <baseDataDir>/<dbms>/<relative> zurück. <dbms> ist mysql, postgresql oder sqlite und wird über einen instanceof-Test auf die Doctrine-Plattform gewählt (seit 2026-04-29). Eine fehlende oder nicht lesbare Datei bricht die Installation mit einer Fehlermeldung ab, die den Pfad nennt.

Der Installationsbefehl unter SQLite #

InstallPlatformCommand::checkCreateDatabase() tut drei Dinge, wenn die Plattform der Verbindung SQLite ist:

1. Er überspringt doctrine:database:create --if-not-exists. Dieser Befehl schlägt unter SQLite mit „getListDatabasesSQL is not supported by platform“ fehl.
2. Bei einer Dateidatenbank (nicht :memory:) legt er das übergeordnete Verzeichnis mit dem Modus 0755 an, wenn es fehlt. Schlägt das fehl, endet der Befehl mit dem allgemeinen Exit-Code für Datenbankfehler.
3. Er gibt Using SQLite database <path> (file created automatically on first connection). aus und kehrt zurück.

Andere Engines behalten den Weg über den Unterprozess. In der Linie 2.5 ist der Indizierungsschritt in ein try/catch eingeschlossen, sodass eine nicht fatale Warnung bei der Neuindizierung einer leeren Installation die Installation nicht abbricht.

Erzeugung des Schemas #

CoreInstaller::importSchema() baut das Schema aus den Ereignissen des Schema-Builders auf und erzeugt die DDL für die Plattform der Verbindung. Unter SQLite wird das Plattformobjekt, wenn die Verbindung die nackte SqlitePlatform meldet, durch Ibexa\DoctrineSchema\Database\DbPlatform\SqliteDbPlatform ersetzt.

Warum: Tabellen mit einem zusammengesetzten Primärschlüssel (id, version), etwa die Tabelle der Inhaltsfelder, dürfen kein AUTOINCREMENT auf id tragen. SQLite unterstützt diese Kombination nicht. Die generische Plattform erzeugte einen einspaltigen Schlüssel, sodass das Bearbeiten eines Entwurfs eine Verletzung der Eindeutigkeitsbedingung auslöste: Dieselbe Feld-ID kommt in mehreren Versionen vor.

Der 3.x- / 4.6-Kernel ist älter als diese Klasse, daher wird der Fehler stattdessen in der Startdatendatei korrigiert. data/sqlite/cleandata.sql beginnt nach den Pragmas mit Blöcken aus DROP TABLE IF EXISTS, CREATE TABLE (zusammengesetzter Schlüssel) und CREATE INDEX für ezcontentclass, ezcontentclass_attribute und ezcontentobject_attribute (96 Zeilen), noch vor jedem Insert. Aus demselben Grund wurde außerdem ein AUTOINCREMENT von ezcontentobject_attribute.id entfernt.

Konventionen für Startdaten #

• Startdatendateien sind SQL mit einer Anweisungsgruppe je Tabelle: INSERT INTO "<table>" (...) VALUES (...).
• MySQL-Escape-Sequenzen werden umgewandelt: \' wird zu '', \" wird zu ", \\ wird zu \.
• In den Startdaten der Plattform werden \n, \r und \t zu echtem Leerraum. Die data.sql von Nexus 1.x behält sie als zweistellige Literale, damit Anweisungen sicher getrennt werden können, und wandelt sie nach dem Trennen in runQueriesFromFile() um. XML-Feldwerte werden dann korrekt geparst.
• An die Startdaten von ibexa-oss im 3.x-Kernel sind 73 Tabellen des Legacy-Schemas angehängt, sodass der Legacy-Kernel die Datei mitnutzen kann (2026-03-29).

Einstellungen #

Der Legacy-Kernel auf derselben Datei #

LegacyMapper\Configuration in der Legacy-Bridge führt eine Zuordnung von Doctrine-Treibern zu Legacy-Treibern. Seit v4.0.0.1 enthält sie pdo_sqlite => sqlite3. Für diesen Treiber schreibt sie Doctrines Parameter path in den Legacy-Wert site.ini [DatabaseSettings] Database, weil Doctrine die SQLite-Datei unter path ablegt, nicht unter dbname. Vorher erhielt der Legacy-Kernel keinen Datenbanknamen.

Eine Installation prüfen #

Führen Sie Folgendes im Wurzelverzeichnis des Projekts aus (nur lesend):

php -m | grep -i sqlite                                    # expect pdo_sqlite and sqlite3
sqlite3 var/data_dev.db ".tables" | tr -s ' ' '\n' | wc -l # number of tables
sqlite3 var/data_dev.db "SELECT COUNT(*) FROM ezcontentobject;"

ezcontentobject ist die Inhaltstabelle im 3.x-Kernel; unter v5 fragen Sie stattdessen ibexa_content ab.

Verwandte Seiten #

• Spezifikationen: Paketübersicht der Plattform, Namen der Konsolenbefehle der Plattform, Legacy-Bridge-Bundle, SQLite3-Datenbanktreiber
• Funktionen: SQLite für Exponential Platform, SQLite-Datenbankunterstützung, Administrationsoberfläche der Plattform, DXP-Skeleton, Layouts auf der Plattform, Nexus-Starter, Framework-Forks für PHP 8.5, Site-Bundles, Legacy-Bridge, Datenbankverwaltung AdminNeo
• Upgrade-Hinweise: Paket-Forks und umbenannte Befehle, SQLite: Transaktionen warten in einer Schlange auf die Schreibsperre
• Changelog: Changelog der Plattform
• Geschichte: Überblick über das Ökosystem, Monate des Ökosystems, Änderungsverzeichnis; Repositorys core, ezplatform-kernel, ezpublish-kernel, exponential-platform-legacy, exponential-platform-nexus, legacyBridge; Monate Januar 2024, erste Hälfte, Januar 2024, zweite Hälfte, Juni 2026, zweite Hälfte