Anime-Sanctuary

Un site dynamique : PHP et MariaDB

Votre site affiche la même page à tout le monde. Nous allons installer PHP et MariaDB pour qu'une page lise ses données dans une base, sans y laisser traîner un mot de passe.

Parcours
Tutoriel 19 sur 35
Durée
35 min de lecture
Vérifié avec
Commandes : essais sous Debian 13.7 (Apache 2.4.69, PHP 8.4.27, MariaDB 11.8.6)
Ce que vous saurez faire
  • Installer PHP et MariaDB et vérifier qu'ils répondent.
  • Créer une base et un utilisateur qui n'a que les droits utiles.
  • Afficher des données de la base avec une page PHP sûre.
  • Sauvegarder la base avec une seule commande.

Avant de commencer : Premier site avec Apache.

Sommaire
  1. Ce qu'est un site dynamique
  2. Installer PHP et MariaDB
  3. Tester PHP, puis supprimer le test
  4. Sécuriser la base, créer un utilisateur dédié
  5. Ranger le mot de passe hors du site
  6. Lire la base depuis une page PHP
  7. Sauvegarder la base avec mysqldump
  8. Si ça échoue
  9. La suite
  10. Sources

Comment faire un site dynamique avec PHP et MariaDB sur Debian ? Votre page index.html est écrite une fois pour toutes : impossible d'y afficher les messages d'un visiteur ou la liste de vos articles sans la réécrire à la main. Nous allons installer de quoi fabriquer la page à chaque visite, la brancher sur une base de données et la protéger comme il faut. Au bout, une adresse de votre site affichera des messages lus dans la base. Plusieurs mots nouveaux vont passer : chacun est expliqué quand il sert, retenez seulement l'idée.

Ce qu'est un site dynamique

Un site dynamique est un site dont les pages sont fabriquées à la demande, au lieu d'être écrites une fois pour toutes. Votre page actuelle ressemble à une affiche imprimée : tout le monde lit la même. Une page dynamique ressemble plutôt à un plat commandé au restaurant : un cuisinier le prépare à chaque commande, avec ce qu'il trouve dans le garde-manger.

Dans cette cuisine, deux programmes se partagent le travail :

  • PHP est le cuisinier. C'est un langage de programmation : Apache lui confie une page, il exécute ses instructions et renvoie du HTML tout prêt.
  • MariaDB est le garde-manger. Elle range vos données dans une base de données et les retrouve en un clin d'œil.

Ces deux programmes ne sont pas encore sur votre serveur. Installons-les.

1Installer PHP et MariaDB

Trois paquets suffisent (un paquet est un logiciel prêt à installer, et apt est l'outil de Debian qui les installe). Les commandes commencent par sudo, qui prête les droits d'administrateur le temps d'une commande (voyez Utilisateurs, sudo et droits). Apache les reconnaît ensuite tout seul :

  • libapache2-mod-php : un module, c'est-à-dire une extension d'Apache, qui lui apprend à confier les fichiers .php à PHP.
  • php-mysql : le pilote qui permet à PHP de parler à MariaDB. MariaDB comprend le même langage que MySQL, son aînée, d'où le nom.
  • mariadb-server : la base elle-même.
Sur le serveur
sudo apt install -y libapache2-mod-php php-mysql mariadb-server

L'installation défile un moment, puis les deux programmes démarrent seuls. Vérifions d'abord que PHP sait parler à MariaDB. PDO est l'outil de PHP pour discuter avec une base, et pdo_mysql son pilote.

Sur le serveur
php -m | grep pdo_mysql
Résultat attendu
pdo_mysql

Vérifions ensuite que MariaDB répond, en lui demandant qui nous sommes.

Sur le serveur
sudo mariadb -e 'SELECT CURRENT_USER();'
Résultat attendu
CURRENT_USER()
root@localhost

Ce root@localhost est le compte tout-puissant de la base. Ne le confondez pas avec le root de Debian : même nom, deux comptes distincts. Avec sudo, vous y entrez sans mot de passe, parce que vous administrez déjà le serveur. Retenez-le : le site n'utilisera jamais ce compte. Voyons maintenant si PHP fait bien tourner une page.

2Tester PHP, puis supprimer le test

Pour savoir si Apache confie bien les pages à PHP, donnons-lui une page qui affiche la fiche d'identité de l'installation. La fonction phpinfo() fait exactement cela. Le fichier va dans le dossier du site de Premier site avec Apache, et ne reste que le temps de l'essai.

Sur le serveur
echo '<?php phpinfo();' | sudo tee /var/www/exemple/info.php > /dev/null

Un fichier PHP commence par <?php : cela dit à Apache de faire travailler PHP plutôt que d'envoyer le texte tel quel. Demandons la page, en ne gardant que son titre. Les commandes « Sur votre ordinateur » de cet article visent https://exemple.fr : remplacez-le par votre adresse, et si votre site n'a pas encore de HTTPS, remplacez https par http ou voyez HTTPS avec Let's Encrypt.

Sur votre ordinateur
curl -s https://exemple.fr/info.php | grep -o "<title>[^<]*</title>"
Résultat attendu
<title>PHP 8.4.27 - phpinfo()</title>

PHP répond, avec le numéro de version que Debian vous a installé. Dans un navigateur, vous verriez un long tableau de réglages.

Sur le serveur
sudo rm /var/www/exemple/info.php

Vérifions qu'elle a bien disparu : le serveur doit répondre 404, « introuvable ».

Sur votre ordinateur
curl -s -o /dev/null -w '%{http_code}\n' https://exemple.fr/info.php
Résultat attendu
404

PHP fonctionne et le test a disparu. Avant de confier des données à MariaDB, parlons d'un vieux script que tous les guides vous conseillent : mysql_secure_installation.

3Sécuriser la base, créer un utilisateur dédié

mysql_secure_installation est un script qui ferme les réglages trop ouverts d'une base de données toute neuve. Sa version actuelle s'appelle mariadb-secure-installation. Bonne nouvelle : sous Debian, tout est déjà réglé, et vous n'avez rien à lancer. Si vous le lancez malgré tout, il répond lui-même « MariaDB is secure by default in Debian ». Le compte root de la base est déjà protégé par sudo, comme vous l'avez vu.

Les trois choses que ce script répare
  • Les comptes anonymes : des comptes sans nom, prévus pour les essais, qui laissent entrer n'importe qui.
  • La base test : une base d'essai ouverte à tous.
  • L'accès à distance du compte root : il ne doit se connecter que depuis le serveur lui-même.

Reste à vérifier que la base n'écoute que le serveur lui-même. La commande ss -ltn liste les ports en attente de visiteurs, et grep 3306 ne garde que celui de MariaDB.

Sur le serveur
ss -ltn | grep 3306
Résultat attendu
LISTEN 0      80         127.0.0.1:3306      0.0.0.0:*

L'adresse 127.0.0.1 désigne le serveur lui-même, et 3306 est le port de MariaDB. Aucune autre machine ne peut l'atteindre, et aucun port n'est à ouvrir dans le pare-feu (ufw, le programme qui décide quelles connexions entrent, présenté dans Pare-feu avec ufw). La base est prête à recevoir un nouveau locataire.

Une base de données est un classeur, et chaque table est un tableau dans ce classeur. Créons une base exemple avec une table messages de trois colonnes (numéro, auteur, texte) et trois lignes de départ. La commande sudo mariadb <<'SQL' envoie à MariaDB tout le texte qui suit, jusqu'à la ligne SQL seule. Ce mot de fin est un simple repère, que l'on choisit.

Sur le serveur
sudo mariadb <<'SQL'
CREATE DATABASE exemple CHARACTER SET utf8mb4;
USE exemple;
CREATE TABLE messages (
  id INT AUTO_INCREMENT PRIMARY KEY,
  auteur VARCHAR(50) NOT NULL,
  texte VARCHAR(255) NOT NULL
);
INSERT INTO messages (auteur, texte) VALUES
  ('alice', 'Mon premier message dans la base.'),
  ('alice', 'Le deuxieme message arrive.'),
  ('bob', 'Bonjour de la part de Bob.');
SQL

Le utf8mb4 permet à la base de garder tous les accents. Chaque ordre SQL, le langage des bases de données, se termine par un point-virgule. Voici maintenant le point clé : le site ne doit jamais se connecter avec le compte root. Si quelqu'un trouvait une faille dans votre page, il tiendrait les clés de toutes vos bases. Un compte dédié limite les dégâts à une seule base.

Le site n'a besoin que de lire, ajouter, modifier et supprimer des lignes. Il n'aura que ces quatre droits, sur cette base seulement. Commençons par son mot de passe : 24 caractères tirés au hasard parmi les lettres et les chiffres, gardés dans une variable MDP, une case mémoire nommée.

Sur le serveur
MDP=$(tr -dc 'A-Za-z0-9' </dev/urandom | head -c 24)

Créons maintenant l'utilisateur, puis donnons-lui ses droits :

  • 'siteapp'@'localhost' : le compte siteapp, qui n'a le droit de se connecter que depuis le serveur lui-même.
  • exemple.* : toutes les tables de la base exemple, et rien d'autre.
Sur le serveur
sudo mariadb <<SQL
CREATE USER 'siteapp'@'localhost' IDENTIFIED BY '$MDP';
GRANT SELECT, INSERT, UPDATE, DELETE ON exemple.* TO 'siteapp'@'localhost';
SQL

Recopiez le bloc tel quel : avant de l'envoyer, le terminal met le vrai mot de passe à la place de $MDP. Si MDP valait abc, MariaDB recevrait IDENTIFIED BY 'abc'. Relisons les droits du nouveau compte. tail -1 ne garde que la dernière ligne de la réponse.

Sur le serveur
sudo mariadb -e "SHOW GRANTS FOR 'siteapp'@'localhost';" | tail -1
Résultat attendu
GRANT SELECT, INSERT, UPDATE, DELETE ON `exemple`.* TO `siteapp`@`localhost`

Le compte existe, mais le site ne connaît pas encore son mot de passe. Où le ranger ?

4Ranger le mot de passe hors du site

Le mot de passe doit vivre dans un fichier que le visiteur ne peut jamais demander. Apache envoie tout ce qui se trouve dans le dossier du site, /var/www/exemple. Si le mot de passe y était, une panne de PHP suffirait pour qu'Apache l'envoie en clair, comme un simple texte. Nous le plaçons donc à côté, dans un dossier que le site ne publie pas.

Sur le serveur
sudo mkdir /var/www/exemple-prive

Le fichier db.php contient une liste de réglages : où se trouve la base, le nom du compte et son mot de passe. La commande écrit tout ce qui suit dans le fichier, jusqu'à la ligne EOF (le même genre de repère de fin que SQL tout à l'heure). Recopiez-la telle quelle : $MDP est remplacé par le vrai mot de passe en écrivant le fichier.

Sur le serveur
sudo tee /var/www/exemple-prive/db.php > /dev/null <<EOF
<?php
return [
    'dsn'  => 'mysql:host=localhost;dbname=exemple;charset=utf8mb4',
    'user' => 'siteapp',
    'pass' => '$MDP',
];
EOF

Reste à régler qui peut le lire. Apache travaille sous le compte www-data . Le fichier appartient à root, le groupe www-data peut le lire, et personne d'autre.

Sur le serveur
sudo chown root:www-data /var/www/exemple-prive/db.php && sudo chmod 640 /var/www/exemple-prive/db.php

Vérifions avec un autre compte. nobody, un compte système sans droits, joue ici le visiteur : il ne doit pas pouvoir lire le fichier.

Sur le serveur
sudo -u nobody cat /var/www/exemple-prive/db.php
Résultat attendu
cat: /var/www/exemple-prive/db.php: Permission denied

Dernier contrôle : le fichier ne doit pas être dans le dossier du site. Cherchons-le ; la commande ne doit rien afficher.

Sur le serveur
sudo find /var/www/exemple -name db.php

Le mot de passe est à l'abri. Il est temps d'écrire la page qui en a besoin.

5Lire la base depuis une page PHP

Cette page affiche les messages d'un auteur. Elle lit le fichier de l'étape 4, ouvre la connexion avec PDO, pose sa question à la base et écrit le résultat en HTML.

Sur le serveur
sudo tee /var/www/exemple/messages.php > /dev/null <<'EOF'
<?php
$cfg = require '/var/www/exemple-prive/db.php';
$pdo = new PDO($cfg['dsn'], $cfg['user'], $cfg['pass'], [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
$auteur = $_GET['auteur'] ?? 'alice';
$req = $pdo->prepare('SELECT texte FROM messages WHERE auteur = ?');
$req->execute([$auteur]);
echo '<h1>Messages de ' . htmlspecialchars($auteur) . '</h1><ul>';
foreach ($req as $ligne) {
    echo '<li>' . htmlspecialchars($ligne['texte']) . '</li>';
}
echo '</ul>';
EOF

Trois éléments méritent un mot :

  • require : lit le fichier de l'étape 4 et en rapporte la liste de réglages, que return y avait rangée.
  • ATTR_ERRMODE : demande à PDO de signaler clairement toute erreur au lieu de se taire.
  • prepare : crée une requête préparée. On envoie d'abord le modèle de la question, avec un ? à la place de la valeur, puis la valeur à part.

Ainsi, ce que le visiteur tape reste de la donnée, jamais une commande. Sans cela, il pourrait glisser ses propres ordres dans votre question : c'est une injection SQL, l'une des attaques les plus courantes.

Reste htmlspecialchars : elle neutralise les signes comme < avant d'écrire le texte dans la page. Sans elle, un message pourrait contenir du code qui s'exécuterait chez vos visiteurs. Testons la page, d'abord sans rien préciser.

Sur votre ordinateur
curl -s https://exemple.fr/messages.php
Résultat attendu
<h1>Messages de alice</h1><ul><li>Mon premier message dans la base.</li><li>Le deuxieme message arrive.</li></ul>

La page a lu la base. Ajoutons maintenant ?auteur=bob à l'adresse : le point d'interrogation introduit une information que la page peut lire.

Sur votre ordinateur
curl -s 'https://exemple.fr/messages.php?auteur=bob'
Résultat attendu
<h1>Messages de bob</h1><ul><li>Bonjour de la part de Bob.</li></ul>

Essayons maintenant d'attaquer notre propre page, avec le texte classique d'une injection SQL.

Sur votre ordinateur
curl -s -G --data-urlencode "auteur=x' OR '1'='1" https://exemple.fr/messages.php
Résultat attendu
<h1>Messages de x&#039; OR &#039;1&#039;=&#039;1</h1><ul></ul>

La page cherche un auteur qui s'appelle bêtement « x' OR '1'='1 », n'en trouve aucun et n'affiche rien. L'attaque est restée du texte.

Vérifions enfin que le compte siteapp ne peut pas détruire la table, même s'il le voulait. Ce test est le seul moment où vous affichez le mot de passe, volontairement, dans votre terminal. Affichez-le, puis copiez-le avec la souris. Si rien ne s'affiche, la variable est vide : vous avez changé de fenêtre.

Sur le serveur
echo "$MDP"

La commande suivante demande ce mot de passe : collez-le dans le terminal (clic droit, ou Ctrl+Maj+V). Rien ne s'affiche pendant la saisie, pas même des points : c'est normal, appuyez sur Entrée. Comme vous ne le tapez pas dans la commande elle-même, il ne reste pas dans l'historique, la liste des commandes déjà tapées.

Sur le serveur
mariadb -usiteapp -p exemple -e 'DROP TABLE messages;' 2>&1 | tail -1
Résultat attendu
ERROR 1142 (42000) at line 1: DROP command denied to user 'siteapp'@'localhost' for table `exemple`.`messages`

MariaDB refuse : le compte n'a pas ce droit. Reste à garder un double de tout cela, au cas où.

6Sauvegarder la base avec mysqldump

Une sauvegarde de base tient dans un fichier texte : une liste d'ordres SQL qui reconstruit tout. La commande mariadb-dump le fabrique ; son ancien nom, mysqldump, marche toujours. Écrivons-le dans votre dossier personnel : cd ~ vous y ramène (le signe ~ est le raccourci de ce dossier), et la sauvegarde ne finit jamais dans un dossier servi par Apache. Le signe > envoie le résultat de la commande dans le fichier exemple.sql au lieu de l'écrire à l'écran.

Sur le serveur
cd ~
sudo mariadb-dump exemple > exemple.sql && chmod 600 exemple.sql

Le chmod 600 réserve le fichier à vous seul, car il contient toutes vos données. Vérifions qu'il contient un seul ordre INSERT INTO, qui regroupe nos trois messages.

Sur le serveur
grep -c "INSERT INTO" exemple.sql
Résultat attendu
1

Une sauvegarde ne vaut que si on sait la relire. Pour restaurer, on rejoue le fichier dans une base. Essayons dans une base d'essai, pour ne rien risquer.

Sur le serveur
sudo mariadb -e 'CREATE DATABASE essai;' && sudo mariadb essai < exemple.sql

La commande ne répond rien, c'est bon signe. Comptons les lignes de la table restaurée.

Sur le serveur
sudo mariadb -e 'SELECT COUNT(*) FROM essai.messages;'
Résultat attendu
COUNT(*)
3

Les trois messages sont revenus. Pour restaurer pour de bon, vous lanceriez la même commande avec exemple à la place de essai : elle remplacerait le contenu de la table. Supprimons la base d'essai.

Sur le serveur
sudo mariadb -e 'DROP DATABASE essai;'

Une sauvegarde qui reste sur le serveur ne protège pas d'un disque mort : copiez exemple.sql ailleurs, sur un autre ordinateur.

Si ça échoue

Trois situations reviennent le plus souvent. Dans les deux premières, le journal d'erreurs d'Apache donne la cause, car PHP cache ses erreurs aux visiteurs :

Sur le serveur
sudo tail -n 1 /var/log/apache2/exemple-error.log
  • Une page blanche ou une erreur 500, avec Access denied for user 'siteapp'@'localhost' dans le journal. Le mot de passe de db.php n'est pas celui de la base. Fabriquez un nouveau mot de passe et donnez-le au compte avec le bloc qui suit la liste, puis réécrivez db.php avec la commande de l'étape 4.
  • Une erreur 500 avec could not find driver. Le pilote manque : installez php-mysql (étape 1) puis redémarrez Apache avec sudo systemctl restart apache2, car un rechargement ne charge pas de nouveau module.
  • Le navigateur affiche le code PHP au lieu de la page. Le module PHP d'Apache n'est pas actif : vérifiez que libapache2-mod-php est installé, puis sudo systemctl restart apache2.

Pour la première situation, voici le bloc qui fabrique un nouveau mot de passe et le donne au compte :

Sur le serveur
MDP=$(tr -dc 'A-Za-z0-9' </dev/urandom | head -c 24)
sudo mariadb <<SQL
ALTER USER 'siteapp'@'localhost' IDENTIFIED BY '$MDP';
SQL

La suite

Votre site lit maintenant ses données dans une base, et vous savez la sauvegarder. Mais beaucoup d'applications toutes faites ne tournent pas dans Apache : elles écoutent sur leur propre port, comme un petit serveur à part. Pour les montrer sur exemple.fr en HTTPS sans ouvrir de nouveau port, il faut un intermédiaire. C'est le sujet de Reverse proxy.