Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,110 of 9,110 pages
About the help in other languages
All help pages

Eine Entwicklungsinstallation einrichten

Eine Entwicklungsinstallation mit wenigen Befehlen - Git-Klone, Composer, exp:install auf SQLite, Velocity, Debug-Einstellungen und die Regeln, die sie von der Live-Website getrennt halten.

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/help/extension-development/part-1-from-user-to-developer/setting-up-a-development-installation.md

On this page

This page is a translation. Read the English original

Eine Entwicklungsinstallation einrichten

Teil 1, Kapitel 4. Sie entwickeln nie auf einer Live-Website. Dieses Kapitel richtet eine eigene Installation ein, auf der Sie Dinge kaputt machen, die Debug-Ausgabe lesen und jedes Beispiel dieses Buchs ausprobieren können. Es braucht nur wenige Befehle; alles nach dem Klonen ist gleich, ob Sie auf einem Laptop, in einer virtuellen Maschine oder in einem Container arbeiten.

Was Sie bekommen

  • Den Kernel und jede Erweiterung als Git-Klone, damit Sie ihre Historie lesen und Ihre Änderungen auf einem Branch halten können.
  • Eine Datenbank in einer einzigen SQLite-Datei, damit kein Datenbankserver eingerichtet werden muss.
  • Einen Webserver, der mit einem Befehl gestartet wird.
  • Eingeschaltete Debug-Ausgabe, damit Fehler angezeigt statt versteckt werden.

Schritt 1: den Code als Git-Klone holen

Sagen Sie Composer einmal, dass jedes Paket se7enxweb/* als Git-Klon installiert werden soll:

composer config --global 'preferred-install.se7enxweb/*' source

Klonen Sie dann den Kernel, legen Sie Ihren eigenen Branch an und installieren Sie die Pakete:

git clone https://github.com/se7enxweb/exponential.git
cd exponential
git switch -c my-dev
composer install

Das erste composer install dauert einige Minuten: Es klont jede Erweiterung, die die composer.json des Kernels verlangt, nach extension/<name>, jede ein eigenes Git-Repository. Die vollständige Erklärung, auch wie Sie später aktualisieren, steht in Den Code holen und Mit Git entwickeln.

Prüfen Sie:

ls -d extension/*/.git | wc -l
git -C extension/eztags log --oneline -3

Erwartet: eine Anzahl von Erweiterungsklonen und die letzten drei Commits eines davon.

Schritt 2: mit einem Befehl installieren

php bin/php/console exp:install --apply

Ohne Optionen installiert dies das Seitenpaket sevenx_multisite auf SQLite, in eng-US, und gibt eine Zusammenfassung mit der Adresse der Website, der Anmeldung für die Administration und einem erzeugten Administratorpasswort aus (das auch in var/log/initial-admin-password geschrieben wird, nur für seinen Eigentümer lesbar). Jede Option und die anderen Datenbanken sind in Die Installation auf der Konsole dokumentiert.

Viele Entwickler legen eine Abkürzung an, damit ./console im Wurzelverzeichnis funktioniert:

ln -s bin/php/console console
./console list | head

Die Abkürzung gehört nicht zu den ausgelieferten Dateien; dieses Buch schreibt ./console und setzt voraus, dass Sie sie angelegt haben.

Warnung exp:install weigert sich, über einer vorhandenen Installation zu laufen, außer Sie geben --force an, und sein Standard --db-action=remove leert die Datenbank, die es bekommt. Auf Ihrem eigenen Entwicklungsrechner mit SQLite ist das genau, was Sie wollen. Richten Sie es nie auf eine Datenbank, die etwas enthält, das Ihnen wichtig ist.

Schritt 3: einen Webserver starten

Am schnellsten geht es mit Velocity und der Server-Engine, die in PHP eingebaut ist, dem ausgelieferten Standard:

./console exp:velocity start

settings/velocity.ini wird mit [ServerSettings] Engine=php ausgeliefert, das php -S mit dem Router bin/php/velocity-router.php ausführt; sein Port wird in [PHPServerSettings] festgelegt (standardmäßig 8087, siehe Die Website ausliefern). Öffnen Sie die Adresse, die die Zusammenfassung von exp:install ausgegeben hat, und dann die Administration. Für eine Einrichtung mit Apache oder nginx enthält dasselbe Kapitel vollständige Beispiele.

Schritt 4: Fehler sichtbar machen

Eine Live-Website verbirgt ihre Fehler vor den Besuchern. Eine Entwicklungs-Website sollte sie zeigen. Nehmen Sie die Änderungen in Ihrer eigenen Einstellungs-Erweiterung oder im Override-Verzeichnis Ihres Entwicklungsrechners vor, nie in settings/site.ini selbst:

./console exp:ini set site.ini/DebugSettings/DebugOutput enabled global --allow-root-user
./console exp:ini set site.ini/TemplateSettings/ShowUsedTemplates enabled global --allow-root-user
./console exp:ini set site.ini/TemplateSettings/TemplateCompile disabled global --allow-root-user
php bin/php/ezcache.php --clear-tag=ini --allow-root-user
EinstellungStandardAuf einem EntwicklungsrechnerWas sie tut
[DebugSettings] DebugOutputdisabledenabledFehler, Warnungen, Zeitmessung und SQL erscheinen unter jeder Seite
[TemplateSettings] ShowUsedTemplatesdisabledenabledDie Debug-Ausgabe listet jedes Template auf, das eine Seite verwendet hat, und welcher Override es gewählt hat
[TemplateSettings] TemplateCompileenableddisabled, solange Sie Templates bearbeitenTemplates werden bei jeder Anfrage frisch gelesen statt aus dem kompilierten Cache
[TemplateSettings] ShowTemplatePathCommentsdisabledenabled, wenn Sie ein Template suchenHTML-Kommentare im Seitenquelltext nennen das Template jedes Teils

exp:ini set ... global schreibt settings/override/site.ini.append.php und legt eine Sicherung an; --dry-run zeigt die Änderung zuerst. Die Einstellungen werden in Debug-Ausgabe und Logs für Entwickler erklärt.

Tipp Die Debug-Ausgabe wird jedem angezeigt, der die Seite öffnen kann, außer Sie schränken sie ein. Auf einem Rechner, den nur Sie erreichen, ist das in Ordnung. Überall sonst verwenden Sie DebugByIP=enabled mit DebugIPList[] oder DebugByUser=enabled mit DebugUserIDList[], beide in [DebugSettings].

Schritt 5: ein Platz für Ihre eigenen Erweiterungen

Legen Sie einen Ordner für die Erweiterung an, die Sie in den Tutorials bauen werden, und stellen Sie ihn von Anfang an unter Versionskontrolle:

mkdir -p extension/mysite_hello
git -C extension/mysite_hello init

Wenn Sie Ihre eigenen Erweiterungen lieber außerhalb von extension/ aufbewahren, kann der Kernel zusätzliche Ordner durchsuchen; siehe Erweiterungen in mehr als einem Ordner.

Regeln, die Entwicklung und Live-Betrieb getrennt halten

RegelWarum
Entwickeln Sie nie auf der Live-WebsiteEin Tippfehler in einem Template oder einer Einstellungsdatei legt die Seite für jeden Besucher lahm.
Kopieren Sie settings/override/ nie von Live zur Entwicklung oder zurückEs enthält Datenbankpasswörter und hostspezifische Werte. Jeder Rechner behält seine eigenen.
Verwenden Sie eine Kopie der Live-Inhalte nur, wenn es sein mussLive-Inhalte können personenbezogene Daten enthalten. Ein frisches exp:install mit dem Demopaket genügt meistens.
Committen Sie Ihre Erweiterung, nicht den KernelIhre Arbeit lebt in extension/<yours>; der Kernel wird über Composer und Git aktualisiert, nicht durch Ihre Änderungen.
Schalten Sie die Debug-Ausgabe aus, bevor etwas live gehtDie Debug-Ausgabe zeigt Pfade, SQL und Einstellungen.

Wenn etwas schiefgeht

SymptomWas Sie prüfen
composer install bricht mit einem Fehler zur PHP-Version abphp -v; der Kernel braucht PHP 8.0 oder neuer (PHP 7.4 ohne Support nutzbar)
exp:install bricht vor der Zusammenfassung abseine eigene Meldung nennt die Prüfung, die fehlgeschlagen ist; das Log liegt in var/log/
Die Website zeigt eine leere Seitevar/log/error.log und das PHP-Fehlerlog Ihres Webservers
Eine Änderung an einem Template wirkt nichtdie Template-Kompilierung: Leeren Sie den Template-Cache oder setzen Sie TemplateCompile=disabled, solange Sie entwickeln
Eine neue Klasse wird nicht gefundenphp bin/php/ezpgenerateautoloads.php -e, dann die Caches leeren

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