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

Das DXP-Skeleton von Exponential Platform: create-project und eine dokumentierte Installation

Diese Seite ist für Entwickler, die ein neues Projekt auf Exponential Platform (der Symfony-basierten Plattform) aus einem sauberen Skeleton beginnen, ohne Demo-Design.

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/features/6.0/platform-dxp-skeleton.md

On this page

This page is a translation. Read the English original

Das DXP-Skeleton von Exponential Platform: create-project und eine dokumentierte Installation

Diese Seite ist für Entwickler, die ein neues Projekt auf Exponential Platform (der Symfony-basierten Plattform) aus einem sauberen Skeleton beginnen, ohne Demo-Design.

Repositorys: se7enxweb/exponential-platform-dxp-skeleton (Platform v5), se7enxweb/exponential-platform-v4x-dxp-skeleton (Platform 4.6.x), se7enxweb/exponential-platform-dxp (das Metapaket, das beide verlangen), se7enxweb/oss, se7enxweb/oss-skeleton.

Was es ist

Ein sauberes Symfony-Projekt für Exponential Platform ohne Demo-Design. composer create-project lädt die Pakete herunter, ein Symfony-Flex-Rezept konfiguriert sie, und die eigene Anleitung des Skeletons (INSTALL.md, 22 Abschnitte) führt Sie von einem leeren Ordner zu einer laufenden Administrationsoberfläche. Verwenden Sie den Nexus-Starter, wenn Sie stattdessen eine fertige Demo-Website möchten.

SkeletonPlattformSymfonyPHPNode.js
exponential-platform-dxp-skeletonv57.4 LTS8.3+ (8.3 oder 8.5 empfohlen)20 LTS (die Anleitung sagt, nur 20 ist getestet)
exponential-platform-v4x-dxp-skeleton4.6.x5.4 (extra.symfony.require ist auf 5.4.* festgelegt, damit Flex keine unpassende Version wählen kann)7.4 bis 8.520 LTS

Das Metapaket se7enxweb/exponential-platform-dxp wurde am 12.03.2026 angelegt, und am 21.03.2026 wurden seine Kern- und Admin-Pakete auf die Forks von se7enxweb umgestellt (Kern mit Tag v5.0.1.0). Im April 2026 ersetzte es außerdem ibexa/system-info, ibexa/admin-ui-assets und ibexa/fieldtype-richtext durch die Pakete von se7enxweb und verlangte den Fork von layouts-core. Siehe die Paketkarte.

Warum es hilft

  • Ein dokumentierter Weg. Jeder Befehl der Anleitung trägt den Namen Exponential (exponential:install, exponential:reindex); die alten Namen ibexa:* bleiben als Aliase, damit alte Skripte weiter funktionieren.
  • Der Endpunkt der Flex-Rezepte von se7enxweb steht in der composer.json des Skeletons vor den Upstream-Rezepten (Commit „Add sevenx-recipes Flex endpoint before ibexa/recipes“, 12.03.2026), sodass Bundles mit den Rezepten konfiguriert werden, die die Forks kennen.
  • Drei Datenbanken sind dokumentiert: MySQL / MariaDB, PostgreSQL und SQLite ganz ohne Server (SQLite für die Plattform).

Ein Projekt anlegen

composer create-project se7enxweb/exponential-platform-dxp-skeleton my-project
cd my-project

Composer lädt die Pakete herunter, führt die Rezepte und die Skripte nach der Installation aus (assets:install, cache:clear).

Konfigurieren Sie die Umgebung (committen Sie .env.local nie):

cp .env .env.local
$EDITOR .env.local

Mindestvariablen für MySQL / MariaDB:

VariableBeispielBedeutung
APP_ENVprod oder devSymfony-Umgebung
APP_SECRET32 zufällige HexadezimalzeichenSymfony-Geheimnis
DATABASE_DRIVERpdo_mysql (pdo_pgsql für PostgreSQL)PDO-Treiber
DATABASE_HOST, DATABASE_PORT127.0.0.1, 3306Server
DATABASE_NAME, DATABASE_USER, DATABASE_PASSWORDIhre WerteZugangsdaten
DATABASE_CHARSET, DATABASE_COLLATIONutf8mb4, utf8mb4_unicode_520_ciZeichensatz
DATABASE_VERSIONmariadb-10.6.0 oder 8.0Serverversion, von der Doctrine ausgeht
JWT_SECRET_KEY, JWT_PUBLIC_KEY, JWT_PASSPHRASESchlüsselpfade unter config/jwt/, eine zufällige PassphraseAnmeldung an der REST-API

DATABASE_URL wird aus den Teilen abgeleitet, oder Sie setzen direkt einen vollständigen DSN.

Datenbank anlegen und installieren:

mysql -e "CREATE DATABASE exponential CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_520_ci;"
php bin/console exponential:install exponential-oss

Bauen Sie dann die Ressourcen und die Schlüssel:

source ~/.nvm/nvm.sh && nvm use 20
yarn install
yarn dev                                              # site assets (yarn build for production)
php bin/console assets:install --symlink --relative public
yarn ibexa:build                                      # admin interface assets
php bin/console lexik:jwt:generate-keypair            # REST API keys
php bin/console ibexa:graphql:generate-schema         # GraphQL schema
php bin/console exponential:reindex                   # search index
php bin/console cache:clear

Dateiberechtigungen für den Benutzer des Webservers (ersetzen Sie www-data):

setfacl -R  -m u:www-data:rwX -m g:www-data:rwX var/ public/var/
setfacl -dR -m u:www-data:rwX -m g:www-data:rwX var/ public/var/

Siteaccesses: site liefert das Twig-Frontend unter / aus, admin die Administrationsoberfläche unter /adminui/. REST liegt unter /api/ezp/v2/, GraphQL unter /graphql.

Die Demodaten legen ein Administratorkonto an, das die Anleitung öffentlich dokumentiert. Ändern Sie sein Passwort sofort in der Administrationsoberfläche.

Im Alltag

php bin/console cache:clear --env=prod                # after configuration or code changes
php bin/console cache:warmup --env=prod
php bin/console cache:pool:clear cache.tagaware.filesystem
php bin/console fos:httpcache:invalidate:path / --all # when Varnish or the HTTP cache is in use
php bin/console exponential:reindex --content-type=article
php bin/console doctrine:migration:migrate --dry-run  # preview pending migrations
php bin/console doctrine:migration:migrate --allow-no-migration

Cron (alle fünf Minuten):

*/5 * * * * /usr/bin/php /var/www/exponential/bin/console ibexa:cron:run --env=prod >> /var/log/exponential-cron.log 2>&1

Beachten Sie, dass ibexa:cron:run und ibexa:graphql:generate-schema in diesem Release noch ihre Upstream-Namen tragen; nur umgestellte Befehle haben einen Namen exponential: (Liste).

Konvertierung der Datenbank

Die Anleitung (Abschnitt 21) beschreibt den Wechsel zwischen Engines: jede Datenbank nach SQLite (mysql2sqlite für MySQL, pgloader für PostgreSQL), SQLite nach MySQL oder PostgreSQL, MySQL nach PostgreSQL und umgekehrt sowie einen Weg nur zum Export nach Oracle. Sie endet mit einer Checkliste nach der Konvertierung. Setzen Sie nach der Konvertierung nach SQLite DATABASE_URL="sqlite:///%kernel.project_dir%/var/data_dev.db" und MESSENGER_TRANSPORT_DSN=sync://.

Grenzen

  • Das Skeleton v5 lehnt PHP älter als 8.3 ab. Das Skeleton 4.6.x behält PHP 8.0 bis 8.5 (PHP 7.4 ohne Support nutzbar) und Symfony 5.4.
  • Node.js: Die Anleitung des Skeletons v5 sagt, nur Node 20 LTS zu verwenden; der Nexus-Starter v5 verlangt Node 22. Folgen Sie der Anleitung des Projekts, das Sie installieren.
  • Ein Klon des Skeletons mit git clone statt create-project braucht composer install --keep-vcs und dieselben Schritte in Reihenfolge.

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