Die Docker Devilbox

Das Devilbox Project ist ein fertiges LAMP Stack für Docker. Wenn du die Docker-Toolbox einsetzt, sind diese Angaben der Dokumentation lesenswert.

Devilbox installieren und konfigurieren

Es ist keine Installation im eigentlichen Sinne notwendig. Du musst dir nur die Dateien von der Devilbox GitHub-Seite in ein leeres Verzeichnis herunterladen. Die Konfiguration erfolgt über eine einzelne Datei. In deinem Verzeichnis findest du die Datei env-example. Kopiere diese und benenne die Datei anschließend in .env um. In der neuen Datei kannst du jetzt deine Konfigurationen vornehmen. Notwendig sind Änderungen der folgende Einträge:

• NEW_UID
• NEW_GID
• HTTPD_DOCROOT_DIR
• HTTPD_SERVER
• PHP_SERVER
• MYSQL_SERVER

Die einzelnen Schritte (gerade auch für die Einträge NEW_UID und NEW_GID) sind in der Devilbox Dokumentation gut beschrieben. Für Contao selbst sollten die weiteren Einträge so gesetzt werden:

• HTTPD_DOCROOT_DIR=DOCUMENT-ROOT (DOCUMENT-ROOT = public (bis und mit Contao 4.11 web), siehe auch Hosting-Konfiguration)
• HTTPD_SERVER=apache-2.4
• PHP_SERVER=8.2
• MYSQL_SERVER=mariadb-10.3

Die Devilbox starten

Wechsle nun in das Verzeichnis und starte die Devilbox mit Docker:

docker-compose up httpd php mysql

Erstmalig kann es etwas dauern, da zunächst die jeweiligen Docker Images geladen und die Container erstellt werden müssen. Ausserdem wird empfohlen, den ersten Start im Vordergrund auszuführen, damit etwaige Fehler besser sichtbar werden.

Erneute Starts sind dann wesentlich schneller und können im Hintergrund (Option -d) ausgeführt werden:

docker-compose up -d httpd php mysql

Die Devilbox beenden

Die Devilbox sollte durch den Stop aller Container und anschliessendem Löschen aller Container beendet werden.

docker-compose stop
docker-compose rm -f

Das Devilbox-Dashboard im Browser

Ist die Devilbox gestartet, kannst du nun deinen Browser aufrufen. Mit Eingabe von http://127.0.0.1 erreichst du das Devilbox-Dashboard. Über die Navigation erhältst du Zugriff auf die verschiedenen Funktionen.

Contao-Installation vorbereiten

Eine oder mehrere Contao-Installationen werden im Devilbox-Verzeichnis data/www erstellt. Je Contao-Installation musst du hier ein separates Verzeichnis anlegen. Der Verzeichnisname entspricht dann dem späteren vHost-Namen. Aus dem Verzeichnisnamen contao4 resultiert dann contao4.loc.

Damit der vHost-Name aufgelöst werden kann, musst du noch in /etc/hosts den Eintrag 127.0.0.1 localhost in 127.0.0.1 contao4.loc abändern.

Du hast ein Verzeichnis (z. B. contao4) erstellt. Wechsle in dieses Verzeichnis und erstelle einen neuen Unterordner public (bis und mit Contao 4.11 web). Kopiere in diesen Ordner die Contao Manager .phar Datei und benenne die Datei in contao-manager.phar.php um.

Installation über den Contao Manager

Starte phpMyAdmin im Devilbox-Dashboard im Bereich Tools/phpMyAdmin und lege eine neue Datenbank an. Wechsle dann in der Navigation auf die Seite Virtual Hosts. Hier solltest du nun eine Liste deiner vorhandenen Web-Projekte sehen und auch gleich aufrufen können. Du kannst jetzt die Contao-Installation über den Contao Manager aufrufen. In unserem Beispiel also über: contao4.loc/contao-manager.phar.php.

Die weitere Vorgehensweise ist dann identisch wie in Contao installieren beschrieben.

Installation über die Kommandozeile

Das PHP Memory Limit für die PHP-Container der Devilbox ist standardmässig zu niedrig und muss daher für die Composer-Nutzung zuvor konfiguriert werden. Wechsle dazu in das Verzeichnis cfg. Hast du die Devilbox mit PHP 8.2 in der .env konfiguriert, mache die folgenden Änderungen dann entsprechend im Verzeichnis cfg/php-ini-8.2. Erstelle hier eine Datei memory_limit.ini mit folgendem Eintrag:

[PHP]
memory_limit = -1

Im Anschluss musst du die Devilbox neu starten. Im Devilbox-Hauptverzeichnis liegen die Dateien shell.sh bzw. shell.bat. Damit kannst du dich in den laufenden Devilbox PHP-Container (die Devilbox-shell) einklinken. Hier sind bereits zahlreiche Tools vorinstalliert (unter anderem Composer). Nach Aufruf befindest du dich im Container im Verzeichnis shared/http. Zur Installation von z. B. Contao 4.13 in ein Verzeichnis contao4 musst du lediglich eingeben:

composer create-project contao/managed-edition contao4 4.13

Lege dir eine neue Datenbank an:

mysql -u root -h mysql -p -e 'CREATE DATABASE db_contao4;'

vendor/bin/contao-console cache:warmup --env=dev -v

Angaben im Contao-Installtool

Die Angaben im Contao-Installtool sind grundsätzlich identisch. Du musst lediglich bei Datenbankverbindung auf folgende Einträge achten:

Nützliche Informationen: Mehrere php Versionen parallel betreiben (ab devilbox 3)

Die Grundeinstellung nimmst du im Devilbox-Verzeichnis vor.
Im Verzeichnis compose findest du die Datei docker-compose.override.yml-php-multi.yml. Kopiere die Datei in das Devilbox-Hautpverzeichnis und ändere den Dateinamen nach »docker-compose.override.yml«.

Du hast ein Projekt , das abweichend von der in der .env eingestellten PHP-Version (in unserem Beispiel 8.2) mit einer anderen php-Version - sagen wir 7.4 - laufen soll?
Lege in diesem Projektverzeichnis ein Verzeichnis .devilbox und darin eine Datei backend.cfg mit diesem Inhalt an:

conf:phpfpm:tcp:php74:9000  

Starte Devilbox wie folgt:

docker-compose up php httpd bind php74

Nützliche Informationen: PHP Xdebug

Im Devilbox-Handbuch findest du eine nicht ganz aktuelle Dokumentation, die aber das grundsätzliche Vorgehen gut aufzeigt.

In meiner IDE funktioniert folgende Konfiguration sehr gut:

{
  //
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Listen for Xdebug",
      "type": "php",
      "request": "launch",
      "port": 9003,
      "pathMappings": {
        "/shared/httpd/": "${workspaceFolder}/projects/"
      },
      "log": true,
      "stopOnEntry": true
    },
    .
    .
    .

  ]
}

; PHP.ini configuration
;  
[PHP]
; Defaults
xdebug.mode                 = debug
xdebug.remote_handler       = dbgp
xdebug.start_with_request   = yes

; How to connect
xdebug.client_port          = 9003
xdebug.client_host          = host.docker.internal
xdebug.discover_client_host = false

; Logging
xdebug.log                  = /shared/httpd/xdebug.log
xdebug.log_level            = 7

; IDE Configuration
xdebug.idekey               = VSCODE