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
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.
sudo apt install -y libapache2-mod-php php-mysql mariadb-serverL'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.
php -m | grep pdo_mysqlpdo_mysqlVérifions ensuite que MariaDB répond, en lui demandant qui nous sommes.
sudo mariadb -e 'SELECT CURRENT_USER();'CURRENT_USER()
root@localhostCe 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.
echo '<?php phpinfo();' | sudo tee /var/www/exemple/info.php > /dev/nullUn 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.
curl -s https://exemple.fr/info.php | grep -o "<title>[^<]*</title>"<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.
sudo rm /var/www/exemple/info.phpVérifions qu'elle a bien disparu : le serveur doit répondre 404, « introuvable ».
curl -s -o /dev/null -w '%{http_code}\n' https://exemple.fr/info.php404PHP 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.
ss -ltn | grep 3306LISTEN 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.
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.');
SQLLe 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.
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 comptesiteapp, qui n'a le droit de se connecter que depuis le serveur lui-même.exemple.*: toutes les tables de la baseexemple, et rien d'autre.
sudo mariadb <<SQL
CREATE USER 'siteapp'@'localhost' IDENTIFIED BY '$MDP';
GRANT SELECT, INSERT, UPDATE, DELETE ON exemple.* TO 'siteapp'@'localhost';
SQLRecopiez 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.
sudo mariadb -e "SHOW GRANTS FOR 'siteapp'@'localhost';" | tail -1GRANT 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.
sudo mkdir /var/www/exemple-priveLe 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.
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',
];
EOFReste à 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.
sudo chown root:www-data /var/www/exemple-prive/db.php && sudo chmod 640 /var/www/exemple-prive/db.phpVérifions avec un autre compte. nobody, un compte système sans droits, joue ici le visiteur : il ne doit pas pouvoir lire le fichier.
sudo -u nobody cat /var/www/exemple-prive/db.phpcat: /var/www/exemple-prive/db.php: Permission deniedDernier contrôle : le fichier ne doit pas être dans le dossier du site. Cherchons-le ; la commande ne doit rien afficher.
sudo find /var/www/exemple -name db.phpLe 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.
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>';
EOFTrois éléments méritent un mot :
require: lit le fichier de l'étape 4 et en rapporte la liste de réglages, quereturny 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.
curl -s https://exemple.fr/messages.php<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.
curl -s 'https://exemple.fr/messages.php?auteur=bob'<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.
curl -s -G --data-urlencode "auteur=x' OR '1'='1" https://exemple.fr/messages.php<h1>Messages de x' OR '1'='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.
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.
mariadb -usiteapp -p exemple -e 'DROP TABLE messages;' 2>&1 | tail -1ERROR 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.
cd ~
sudo mariadb-dump exemple > exemple.sql && chmod 600 exemple.sqlLe 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.
grep -c "INSERT INTO" exemple.sql1Une 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.
sudo mariadb -e 'CREATE DATABASE essai;' && sudo mariadb essai < exemple.sqlLa commande ne répond rien, c'est bon signe. Comptons les lignes de la table restaurée.
sudo mariadb -e 'SELECT COUNT(*) FROM essai.messages;'COUNT(*)
3Les 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.
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 :
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 dedb.phpn'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éécrivezdb.phpavec la commande de l'étape 4. - Une erreur 500 avec
could not find driver. Le pilote manque : installezphp-mysql(étape 1) puis redémarrez Apache avecsudo 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-phpest installé, puissudo systemctl restart apache2.
Pour la première situation, voici le bloc qui fabrique un nouveau mot de passe et le donne au compte :
MDP=$(tr -dc 'A-Za-z0-9' </dev/urandom | head -c 24)
sudo mariadb <<SQL
ALTER USER 'siteapp'@'localhost' IDENTIFIED BY '$MDP';
SQLLa 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.