Docker für PHP, Apache und MariaDB – aus einem Container wird eine Entwicklungsumgebung
Im letzten Beitrag unserer Docker-Serie haben wir eine einfache PHP-Entwicklungsumgebung mit Docker erstellt. Für kleine Projekte oder erste Experimente ist das bereits völlig ausreichend und hat den großen Vorteil, dass keine lokale PHP-Installation mehr notwendig ist.
Sobald eine Anwendung Daten speichern soll, stößt dieses einfache Setup allerdings an seine Grenzen. Neben dem Webserver benötigen wir nun auch eine Datenbank. Außerdem muss PHP die passenden Erweiterungen mitbringen, damit später überhaupt eine Verbindung zur Datenbank aufgebaut werden kann.
In diesem Beitrag erweitern wir deshalb unsere bestehende Docker-Umgebung um einen MariaDB-Container und passen unseren Webcontainer entsprechend an.
Unsere compose.yml erweitern
Im letzten Beitrag bestand unsere compose.yml lediglich aus einem Webcontainer.
services:
web:
image: php:8.5-apache
ports:
- "8080:80"
volumes:
- .:/var/www/html
Für unsere Datenbank ergänzen wir nun einen zweiten Service.
services:
web:
build: .
ports:
- "8080:80"
volumes:
- .:/var/www/html
mariadb:
image: mariadb:10.11
environment:
MARIADB_ROOT_PASSWORD: root
MARIADB_DATABASE: app
MARIADB_USER: app
MARIADB_PASSWORD: secret
volumes:
- mariadb_data:/var/lib/mysql
volumes:
mariadb_data:
Aus einem einzelnen Container ist damit eine kleine Entwicklungsumgebung geworden. Der Webcontainer kümmert sich um PHP und Apache, während MariaDB unsere Daten speichert.
Warum braucht die Datenbank ein eigenes Volume?
Vielleicht ist dir der neue Abschnitt am Ende der Datei bereits aufgefallen.
volumes:
mariadb_data:
Ein Docker-Container ist grundsätzlich austauschbar. Wird ein Container gelöscht, gehen auch alle darin gespeicherten Daten verloren.
Damit uns das mit unserer Datenbank nicht passiert, verwenden wir ein Docker Volume. Man kann es sich zunächst wie einen Speicherort vorstellen, den Docker unabhängig vom eigentlichen Container verwaltet.
Der MariaDB-Container speichert seine Daten nicht im Container selbst, sondern im Volume mariadb_data. Selbst wenn der Container später gelöscht oder neu erstellt wird, bleiben unsere Tabellen und Daten erhalten.
Den Webcontainer anpassen
Vielleicht ist dir noch eine weitere Änderung aufgefallen.
Im letzten Beitrag haben wir den Webcontainer direkt über das image-Attribut gestartet.
image: php:8.5-apache
Jetzt verwenden wir stattdessen:
build: .
Der Grund ist einfach: Unser PHP-Container benötigt jetzt zusätzlich die Erweiterungen für die Kommunikation mit MySQL-kompatiblen Datenbanken. Dafür erstellen wir erstmals ein eigenes Dockerfile.
FROM php:8.5-apache
RUN docker-php-ext-install mysqli pdo pdo_mysql
Mehr ist an dieser Stelle zunächst gar nicht notwendig.
Während der Entwicklung möchten wir unseren Quellcode möglichst komfortabel bearbeiten. Deshalb kopieren wir ihn nicht in das Image, sondern binden ihn direkt in den Container ein. Änderungen an den PHP-Dateien stehen dadurch sofort zur Verfügung und wir müssen das Image nicht nach jeder kleinen Anpassung neu erstellen.
Dafür verwenden wir dieses Volume:
volumes:
- .:/var/www/html
Diese Art der Einbindung bezeichnet Docker als Bind Mount. Dabei wird unser Projektverzeichnis direkt mit dem Verzeichnis /var/www/html im Container verbunden.
Die Container starten
Sind beide Dateien vorbereitet, genügt wie gewohnt ein einziger Befehl.
docker compose up -d
Docker erstellt zunächst unser PHP-Image aus dem Dockerfile, lädt anschließend das MariaDB-Image herunter, legt das Docker Volume an und startet beide Container.
Mit
docker compose ps
lässt sich anschließend überprüfen, ob beide Dienste erfolgreich laufen.
Wie findet PHP die Datenbank?
Obwohl Webserver und Datenbank in unterschiedlichen Containern laufen, können sie problemlos miteinander kommunizieren.
Docker Compose erstellt dafür automatisch ein gemeinsames Netzwerk. Jeder Service ist innerhalb dieses Netzwerks über seinen Servicenamen erreichbar. Unsere Datenbank ist deshalb nicht unter localhost, sondern unter mariadb erreichbar.
Eine Verbindung mit PDO könnte beispielsweise so aussehen:
$dsn = 'mysql:host=mariadb;dbname=app;charset=utf8mb4';
$username = 'app';
$password = 'secret';
$pdo = new PDO($dsn, $username, $password);
Den Hostnamen müssen wir dabei nicht selbst konfigurieren. Docker übernimmt die interne Namensauflösung automatisch.
Warum MariaDB?
In diesem Beitrag verwenden wir bewusst MariaDB. Die Datenbank ist vollständig Open Source, weit verbreitet und für die meisten PHP-Anwendungen ein direkter Ersatz für MySQL.
Soll stattdessen MySQL verwendet werden, genügt in den meisten Fällen bereits eine kleine Änderung.
image: mysql:8.4
Außerdem müssen die Umgebungsvariablen von MARIADB_ auf MYSQL_ angepasst werden.
Dateien aus dem Artikel
Du möchtest die Entwicklungsumgebung direkt ausprobieren? Alle benötigten Dateien aus diesem Artikel findest du als Gist:
PHP Apache MariaDB Development Environment with Docker Compose auf GitHub.com
Fazit
Mit wenigen zusätzlichen Zeilen ist aus unserem einzelnen PHP-Container eine vollständige Entwicklungsumgebung geworden. Docker Compose startet Webserver und Datenbank gemeinsam, Docker Volumes sorgen dafür, dass unsere Daten dauerhaft erhalten bleiben, und über das Dockerfile können wir unser PHP-Image an die Anforderungen unseres Projekts anpassen.
Damit steht eine solide Grundlage für die weitere Entwicklung bereit – und das alles mit einem einzigen Befehl.
