PHP, Apache et MariaDB
dans un seul container

Comprendre ce que la stagiaire info a livré : une app PHP qui interroge MariaDB, et un schéma SQL avec 12 espèces de démonstration.

Indications

Ouvrez les fichiers fournis :

• application/connexion-bd.php - la fonction ouvrirConnexionBd() retourne un objet PDO. Notez les paramètres : hôte = localhost, base = catalogue_especes, utilisateur = root, mot de passe vide. Pourquoi vide ? Parce que MariaDB tournera dans le même container, sans exposition externe.
• application/index.php - une requête SQL préparée avec filtre par écosystème et recherche par nom. Si la connexion échoue (BD pas prête), un encart d'erreur s'affiche.
• application/fiche.php - charge une espèce par son identifiant entier.
• schema.sql - CREATE DATABASE, CREATE TABLE espece, puis 12 INSERT. C'est ce qui sera joué au tout premier démarrage.

Saisir pourquoi un container "normal" ne fait tourner qu'un seul processus, et pourquoi notre cas justifie une exception.

Pour mieux comprendre

Un container Docker démarre en exécutant un seul programme : ce que dit l'instruction CMD ou ENTRYPOINT du Dockerfile. Quand ce programme se termine, le container s'arrête. C'est la philosophie "un processus par container".

Mais cette règle est une convention, pas une contrainte technique. On peut tout à fait :

• Faire du ENTRYPOINT un script bash qui lance plusieurs processus.
• Démarrer les processus secondaires en arrière-plan (avec & ou via un script de démarrage de service).
• Faire que le processus PRINCIPAL (celui qui occupe le PID 1 du container) reste au premier plan : si lui s'arrête, le container s'arrête.

Pour notre cas :

• MariaDB doit démarrer en arrière-plan.
• Apache reste au premier plan : c'est lui le PID 1.

Important : un container avec deux processus ne sera pas Compose-compatible directement. Compose préfère un service par container. Mais pour ce TP, on apprend à faire les deux dans un, ce qui est très utile pour comprendre les bases. Compose viendra plus tard dans le cursus.

Construire une image qui contient PHP, Apache, MariaDB, l'extension PDO MySQL, le code de l'application, le schéma SQL, et le script de démarrage.

Indications

• Image de base : php:8.2-apache, comme à l'Atelier 2.
• Installer MariaDB via apt : apt-get update && apt-get install -y --no-install-recommends mariadb-server mariadb-client. --no-install-recommends évite d'installer les paquets recommandés non essentiels.
• Activer l'extension PDO MySQL : docker-php-ext-install pdo pdo_mysql. Cette commande est fournie par les images officielles PHP.
• Définir DEBIAN_FRONTEND=noninteractive avant le RUN apt pour éviter des prompts interactifs.
• Nettoyer le cache apt après l'installation : apt-get clean && rm -rf /var/lib/apt/lists/*. Ça réduit la taille de l'image.
• Copier l'application dans /var/www/html/ et le schéma dans un dossier dédié comme /docker-entree/schema.sql.
• Copier le script demarrer-services.sh dans /usr/local/bin/ et le rendre exécutable avec un RUN chmod +x.
• Définir ENTRYPOINT ["/usr/local/bin/demarrer-services.sh"].

Squelette à compléter :

FROM image-de-base

LABEL pavillon="catalogue-especes"

ENV DEBIAN_FRONTEND=noninteractive

# Installer MariaDB et l'extension PDO MySQL
RUN apt-get update \
    && apt-get install -y --no-install-recommends paquets \
    && docker-php-ext-install extensions \
    && apt-get clean \
    && rm -rf /var/lib/apt/lists/*

# Copier l'application et le schéma
COPY application/ /var/www/html/
RUN mkdir -p /docker-entree
COPY schema.sql /docker-entree/schema.sql

# Script de démarrage
COPY demarrer-services.sh /usr/local/bin/
RUN chmod +x /usr/local/bin/demarrer-services.sh

# Préparer le dossier MariaDB
RUN mkdir -p /var/lib/mysql && chown -R mysql:mysql /var/lib/mysql

EXPOSE 80

ENTRYPOINT ["/usr/local/bin/demarrer-services.sh"]

C'est le coeur de l'atelier. Ce script s'exécute au démarrage de chaque container et orchestre les deux processus.

Comportement attendu

1. Démarrer MariaDB en arrière-plan.
2. Boucler en attendant que MariaDB réponde aux requêtes (au démarrage, MariaDB peut mettre 5 à 10 secondes à devenir prête).
3. Si c'est le premier démarrage, jouer le schéma SQL pour créer la base et insérer les espèces. Ne jamais le rejouer aux démarrages suivants.
4. Lancer Apache en avant-plan, qui devient le PID 1 du container.

Indications techniques

• Démarrer MariaDB : la commande standard sur Debian/Ubuntu est service mariadb start (qui lance mysqld_safe en arrière-plan).
• Vérifier qu'elle est prête : mysqladmin ping -h localhost --silent. Code de retour 0 si la BD répond, autre chose sinon.
• Boucler tant qu'elle ne répond pas : until commande; do sleep 1; done.
• Détecter le premier démarrage : créez un fichier témoin (par exemple /var/lib/mysql/initialise.flag) APRÈS avoir joué le schéma. La condition if [ ! -f "..." ] détecte son absence.
• Jouer le schéma : mysql < /docker-entree/schema.sql (en tant que root local sans mot de passe).
• Lancer Apache en avant-plan : exec apache2-foreground. Le exec remplace le processus du script par Apache, qui devient PID 1.

Squelette du script :

#!/bin/bash
set -e

cheminFichierTemoin="/var/lib/mysql/initialise.flag"
cheminSchema="/docker-entree/schema.sql"

# 1. Démarrer MariaDB en arrière-plan
service mariadb start

# 2. Attendre que MariaDB réponde
until commande-de-ping; do
    sleep 1
done

# 3. Premier démarrage : jouer le schéma
if [ ! -f "$cheminFichierTemoin" ]; then
    commande-mysql-pour-jouer-le-schema
    touch "$cheminFichierTemoin"
fi

# 4. Apache en avant-plan = PID 1 du container
exec commande-apache

Construire l'image (le build prend 1 à 2 minutes la première fois à cause de l'apt-get) et démarrer un container, en montant un dossier hôte sur /var/lib/mysql pour la persistance.

Build

Comme aux ateliers précédents : docker build -t zoo-catalogue-especes:1.0 -t zoo-catalogue-especes:latest .

Run avec volume MariaDB

Cette fois, le volume est sur /var/lib/mysql (le dossier où MariaDB stocke ses données).

$ docker run -d --name "zoo-catalogue-en-marche" \
    -p "8080:80" \
    -v "chemin-hote:cheminContainer" \
    nom-image

Au premier démarrage, suivez les logs en direct pour voir l'orchestration : docker logs -f zoo-catalogue-en-marche. Vous devriez voir :

1. Le démarrage de MariaDB.
2. Plusieurs lignes "Attente que MariaDB soit prête..."
3. "MariaDB répond." puis "Initialisation du schéma..."
4. "Schéma initialisé." puis "Lancement d'Apache."
5. Les logs Apache au format normal.

Vérifier dans le navigateur

Ouvrez http://localhost:8080/. La page d'accueil affiche les 12 espèces réparties sur les 3 écosystèmes. Filtrez. Cherchez. Cliquez sur une espèce pour ouvrir sa fiche.

Prouver que vos données survivent à docker stop, docker rm, et même à un nouveau docker run.

Démarche

1. Container démarré, 12 espèces visibles. Notez ce nombre.
2. Ajoutez une espèce manuellement via le client MariaDB du container :

$ docker exec -it zoo-catalogue-en-marche \
    mysql catalogue_especes -e "INSERT INTO espece
        (nom_commun, nom_latin, ecosysteme, statut_residence, description)
    VALUES
        ('Espèce test', 'Testus testus', 'marin', 'Test', 'Ajoutée pour démontrer la persistance.');"

3. Rechargez la page d'accueil : 13 espèces.
4. ./arreter.sh (ou docker stop + rm).
5. ./demarrer.sh de nouveau.
6. Rechargez : toujours 13 espèces, l'espèce de test est encore là.

Si à l'étape 6 il n'y a que 12 espèces, c'est que votre volume n'est pas correctement configuré. Le dossier /var/lib/mysql du container doit être lié à un dossier sur l'hôte qui survit au container.

Trois scripts d'usage et la documentation, comme aux Ateliers 1 et 2.

Trois scripts

• construire.sh - docker build avec deux tags. Mention dans les logs que le build prend 1 à 2 minutes (apt-get).
• demarrer.sh - création du dossier donnees-bd/ s'il n'existe pas, suppression de l'ancien container s'il existe, docker run avec mappage de port et volume.
• arreter.sh - docker stop + docker rm. Message qui rappelle que le dossier donnees-bd/ reste sur l'hôte.

.dockerignore

Au minimum :

.git
*.log
construire.sh
demarrer.sh
arreter.sh
README.md
.dockerignore
donnees-bd

Le dossier donnees-bd/ doit absolument être ignoré : il contient les fichiers MariaDB une fois le container démarré, et ils peuvent peser plusieurs Mo. Pas question de les envoyer au démon Docker à chaque rebuild.

README.md

Sections essentielles :

• Ce que c'est - architecture (PHP + Apache + MariaDB en un), 12 espèces, 3 écosystèmes.
• Comment lancer - les 3 scripts.
• Démontrer la persistance - la procédure de l'étape 6.
• Comment ajouter une espèce - via docker exec + mysql, ou en modifiant le schéma.
• Limites du pattern - mentionnez les inconvénients du tout-en-un (logs mêlés, mise à jour difficile, anti-pattern Docker), pour montrer que vous comprenez ce que Compose résoudra plus tard.