Eine Entwicklungsumgebung einrichten #

Diese Seite ist für Anwendungsentwickler, die einen Rechner einrichten, um auf Exponential zu bauen. Das Ziel: eine lokale Installation, die Sie in Minuten neu installieren können, mit eingeschalteter Fehlersuche und Ihrer Erweiterung in einem eigenen Git-Repository.

Inhalt #

1. Werkzeuge
2. Eine lokale Installation
3. Ausliefern
4. Entwicklungseinstellungen
5. Ihre Erweiterung in Git
6. Tägliche Befehle

Werkzeuge #

Eine lokale Installation #

git clone https://github.com/se7enxweb/exponential.git exp-dev
cd exp-dev
composer install
php bin/php/console exp:install --apply --package=sevenx_multisite_clean --url=http://127.0.0.1:8088

SQLite, ein erzeugtes Administratorpasswort wird einmal angezeigt (Die Installation per Konsole). Eine Neuinstallation mit demselben Befehl (--force) liefert in Minuten einen sauberen Zustand.

Ausliefern #

composer require se7enxweb/exponential-velocity
php bin/php/console exp:velocity config set --apply ServerSettings Engine qbix
php bin/php/console exp:velocity start

Velocity hält Klassen im Speicher: Nachdem Sie eine PHP-Klasse hinzugefügt oder geändert haben, exp:velocity restart (oder exp:velocity deploy). Für schnelle Arbeit an Templates führt --engine=php (der eingebaute Server von PHP) jede Anfrage frisch aus (8.3 Velocity).

Entwicklungseinstellungen #

Nur in settings/override/site.ini.append.php des Entwicklungsrechners:

[TemplateSettings]
DevelopmentMode=enabled
ShowTemplatePathComments=enabled

[DebugSettings]
DebugOutput=enabled

DevelopmentMode sorgt dafür, dass kompilierte Templates ihren Quellen folgen, und schaltet den Packer ab. Die Debug-Leiste zeigt Abfragen, Templates, Einstellungen und Laufzeiten (Exp-Debug-Leiste, Fehlersuche und Logs). Kopieren Sie diese Einstellungen nie in die Produktivumgebung.

Ihre Erweiterung in Git #

Halten Sie die Anwendung in einem eigenen Repository, ausgecheckt (oder per Symlink eingebunden) nach extension/<ext>, mit einer eigenen composer.json, damit sie sich später wie jede Erweiterung installieren lässt (Composer-Pakete und Packagist). Aktivieren Sie sie in settings/override/site.ini.append.php:

[ExtensionSettings]
ActiveExtensions[]=expdemo

Tägliche Befehle #

php bin/php/ezpgenerateautoloads.php -e                  # after adding or renaming a class
php bin/php/ezcache.php --clear-tag=ini --allow-root-user  # after a settings change
php bin/php/eztemplatecheck.php -s<siteaccess> <file.tpl> # template syntax
php -l <file.php>                                        # PHP syntax
php bin/php/console exp:velocity deploy                  # everything, in the right order

Verwandte Seiten #

• Ihre erste Erweiterung
• Mit Git entwickeln
• Standards für PHP und Composer
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.