Installation mit dem Skeleton
Diese Seite richtet sich an Entwickler, die zum ersten Mal ein DXP-Projekt installieren. Sie folgt der Installationsanleitung des Skeletons (Abschnitte 3 bis 11) in kürzerer Form und verweist auf die Seiten, die jeden Schritt erklären. Rechnen Sie auf einem vorbereiteten Rechner mit etwa 30 Minuten (Versionen, die Sie brauchen).
Inhalt
Zwei Wege zum Start
| Weg | Befehl | Verwenden Sie ihn, wenn |
|---|---|---|
| Ein Projekt anlegen (empfohlen) | composer create-project se7enxweb/exponential-platform-dxp-skeleton my-project | Sie Ihr eigenes Projekt beginnen |
| Das Skeleton klonen | git clone [email protected]:se7enxweb/exponential-platform-dxp-skeleton.git, dann composer install --keep-vcs | Sie am Skeleton selbst arbeiten |
create-project lädt die Pakete herunter, führt die Rezepte von Flex und die Skripte nach der Installation aus
(assets:install, cache:clear).
Die Schritte
Legen Sie das Projekt an.
composer create-project se7enxweb/exponential-platform-dxp-skeleton my-project cd my-projectKonfigurieren Sie die Umgebung in
.env.local, nie in.env, und committen Sie sie nie (Umgebungsvariablen).cp .env .env.local $EDITOR .env.localLegen Sie die Datenbank an (MySQL, MariaDB oder PostgreSQL) oder setzen Sie den SQLite-DSN (Datenbanken, SQLite für die Entwicklung).
Installieren Sie das Schema und die Ausgangsdaten.
php bin/console exponential:install exponential-ossDas Argument ist der Installationstyp;
exponential-ossist der Standard.--skip-indexingüberspringt die automatische Neuindexierung (Konsolenbefehle).Setzen Sie die Berechtigungen für den Benutzer des Webservers auf
var/undpublic/var/(Dateiberechtigungen).Bauen Sie die Assets der Website.
source ~/.nvm/nvm.sh && nvm use 20 yarn install yarn devBauen Sie die Assets der Administration.
php bin/console assets:install --symlink --relative public yarn ibexa:buildErzeugen Sie das JWT-Schlüsselpaar für die REST-API (JWT-Authentifizierung).
php bin/console lexik:jwt:generate-keypairErzeugen Sie das GraphQL-Schema (GraphQL).
php bin/console ibexa:graphql:generate-schemaLeeren Sie den Cache und bauen Sie den Suchindex auf.
php bin/console cache:clear php bin/console exponential:reindexStarten Sie einen Entwicklungsserver.
symfony server:start
Nach der Installation
| URL | Was es ist |
|---|---|
https://127.0.0.1:8000/ | die öffentliche Website (Twig) |
https://127.0.0.1:8000/adminui/ | die Administrationsoberfläche |
https://127.0.0.1:8000/api/ibexa/v2/ | REST-API v2 (die Anleitung zeigt /api/ezp/v2/; prüfen Sie das Präfix wie unter Die REST-API) |
https://127.0.0.1:8000/graphql | GraphQL |
Die Ausgangsdaten legen ein Administratorkonto an, dessen Anmeldedaten in der öffentlichen Installationsanleitung stehen. Ändern Sie sein Passwort sofort in der Administrationsoberfläche, bevor die Website von irgendwo anders erreichbar ist.
Sicherungspunkte
Die Anleitung empfiehlt einen Git-Commit nach jeder Etappe, damit Sie zu einem funktionierenden Zustand zurückkehren können:
git init && git add -A && git commit -m "Added: project created from the DXP skeleton"
git add composer.lock && git commit -m "Updated: locked vendor dependencies"Prüfen Sie vor git add -A, dass .gitignore .env.local, config/jwt/*.pem, var/ und vendor/ ausschließt
(Mit Git entwickeln).
Wenn ein Schritt fehlschlägt
| Symptom | Seite |
|---|---|
| Composer lehnt eine PHP-Version ab | Versionen |
yarn ibexa:build meldet "Module not found" | Führen Sie zuerst assets:install aus (Assets bauen) |
attempt to write a readonly database | SQLite für die Entwicklung |
| Alles andere | Fehlersuche |
Verwandte Seiten
- DXP-Skeleton: create-project und eine dokumentierte Installation
- Umgebungsvariablen
- Befehle für den Alltag
- Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.
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.