Docker/01 Einführung/02 Apache mit PHP
Docker/01 Einführung/02 Apache mit PHP - Beispiel
Beschreibung
- Ziel
HTML-Seite von einem Webserver mit Docker ausliefern lassen
- Hello-World
Diese Hello-World-Variante wird mit der Kombination aus Apache-Webserver und PHP erstellt
Projektverzeichnis
Projektverzeichnis anlegen
mkdir ~/hello-world-php
Projektverzeichnis betreten
cd ~/hello-world-php
index.php erstellen
<!DOCTYPE html>
<!-- Datei index.php -->
<html>
<head>
<title>Hello world </title>
<meta charset ="utf-8" />
</head>
<body>
<h1>Hello world: apache/php</h1>
<?php
$load = sys_getlodavg();
?>
<p> Serverzeit: <?php echo date ("c"); ?>
<br/>
Serverauslastung (load): <?php echo $load[0]; ?>
</body>
</html>
- Erläuterungen
Der PHP-Aufruf sys_getloadavg liefert ein Maß für die aktuelle Auslastung des Systems
- Unter Unix-verwandten Betriebssystemen ist dies eine gängige Größe, die meist durch drei Durchschnittswerte dargestellt wird
- Sie beschreiben die Systemauslastung als jeweils ein Mittel der letzten, der letzten fünf und der letzten 15 Minuten
Hier wird nur der erste dieser Werte verwendet, dessen Array-Index ist 0, daher $load[0]
Damit diese Datei von einem Docker-Container mit Apache und PHP 8 ausgeliefert werden kann, müssen Sie zuerst ein Docker-Image mit der genannten Software erstellen
- Von diesem Image wird dann ein Docker-Container abgeleitet, der die eigentliche Arbeit übernimmt
Nomenklatur
Die Begriffe Docker-Image und Docker-Container werden in Docker/Grundlagen erläutert
Um ein Docker-Image zu erstellen, legen Sie die folgende Datei Dockerfile an, die Sie ebenfalls im Projektverzeichnis speichern
- Diese Datei enthält die Anleitung zum Erstellen des Images
# Datei : hello-world-php/Dockerfile
FROM php:8-apache
ENV TZ="Europe/Berlin"
COPY index.php /var/www/html
Dockerfile
Drei Zeilen
- die nahezu selbsterklärend sind
- sollen also genügen
- um einen Apache-Webserver und PHP in der aktuellen Version zu installieren und die index.php-Datei der Welt zur Verfügung zu stellen?
docker build
Diese zwei Befehle müssen Sie jetzt noch auf der Kommandozeile eingeben, um den Zauber zu starten:
docker build -t hello-world-php .
Dadurch wird aus dem Dockerfile das gewünschte Docker-Image erzeugt und mit dem Tag hello-world-php versehen
- Beim ersten Aufruf dieses Kommandos wird Docker versuchen, das Basis-Image php:8-apache, das Sie in der ersten Zeile des Dockerfiles referenziert haben, aus dem Internet zu laden
- Genauer gesagt wird es vom Docker Hub heruntergeladen, einer Plattform, die von der Firma hinter Docker zur Verfügung gestellt wird und die eine Vielzahl vorbereiteter Images vorhält
- Alle zukünftigen docker build-Kommandos, die auf das php:8-apache-Image aufbauen, werden Ihre lokale Kopie verwenden
Container starten
Abschließend starten Sie von dem Docker-Image einen Container, in dem die Applikation läuft:
docker run -d --name hello-world-php -p 8080:80 hello-world-php
Optionen
- -d veranlasst Docker zur Ausführung des Programms im Hintergrund
- --name versieht den laufenden Container mit dem Namen hello-world-php, wodurch Sie ihn später einfach ansprechen können
- -p verbindet den Port 80 des Containers (80 hinter dem Doppelpunkt) mit dem Port 8080 des ausführenden Systems (8080 vor dem Doppelpunkt)
Sie können jetzt über http://localhost:8080 auf die Applikation zugreifen
- Dockerfile
- siehe auch Docker/Eigene Images
| Option | Beschreibung |
|---|---|
| FROM php:8-apache | Sie verwenden das von den PHP-Entwicklern vorgelegte Docker-Image für PHP 8 als Basis |
| ENV TZ="Europe/Amsterdam" | Damit die Uhrzeit in der korrekten Zeitzone ausgegeben wird, setzen Sie die Umgebungsvariable (ENVironment) TZ (für TimeZone) auf den entsprechenden Wert |
| COPY index.php /var/www/html | Der Apache Webserver in Ihrem Image hat das Standardverzeichnis für Dokumente auf den Pfad /var/www/html gesetzt
|
Damit ist das erste Docker-Image fertig
- Es kann auf jedem Computer verwendet werden, auf dem eine aktuelle Docker-Version läuft
Sie mussten nicht
- die gerade aktuelle Apache-Version im Internet suchen und herunterladen
- das dazu passende PHP-8-Modul suchen und installieren
- index.php an die richtige Stelle auf Ihrem Computer kopieren
Außerdem wurden auch nicht unzählige Dateien an unterschiedlichen Orten im Dateisystem verteilt, die bei einer Deinstallation einer der Komponenten schwer zu finden sind
- Docker hilft Ihnen also unter anderem bei einem schnellen Start und dabei, einen sauberen Computer zu behalten
- Aufräumen
Der Webserver läuft jetzt vermutlich noch im Hintergrund auf Ihrem Computer
Beenden Sie den Container mit dem Aufruf
docker stop hello-world-php
löschen Sie ihn anschließend mit
docker rm hello-world-php