En effet, travailler dans son répertoire personnel permet de maîtriser ses projets Web sans intervenir directement dans les répertoires système tels que /var/www.
Cette organisation facilite la gestion des fichiers, limite le recours aux privilèges administrateur et simplifie la sauvegarde des projets.
Attention : La configuration proposée dans ce tutoriel n’est en aucun cas destinée à un serveur de production. Un serveur de production est généralement ouvert au public sur le web, il nécessite des réglages spécifiques en matière de sécurité et de fiabilité. Un serveur de développement est un atelier : on y teste, développe et modifie les sites, il est souvent comparé dans le jargon à un « bac à sable ».
Pourquoi choisir PHP-FPM et MariaDB ?
Apache peut fonctionner avec PHP de plusieurs manières. Pour ce tutoriel, le choix s'est porté sur PHP-FPM, qui sépare l'exécution de PHP du serveur Apache et permet de s'appuyer sur une architecture mieux adaptée aux serveurs modernes.
Pour un serveur de développement destiné à accueillir plusieurs projets, c'est une excellente base.
Associé à MariaDB, il permet également de travailler dans un environnement proche de celui de nombreux hébergements mutualisés actuels, limitant ainsi les mauvaises surprises lors de la migration des projets vers leur serveur de production.
I - Pré-Requis : Installer un serveur de développement moderne
1/ Installer Apache, PHP et les modules courants
sudo apt install apache2 php php-fpm php-mysql
sudo apt install php-curl php-gd php-intl php-mbstring php-xml php-zip
sudo apt install php-cli php-xmlrpc
Nota. php-mysql est le module PHP qui permet à PHP de parler à MariaDB ou MySQL.
Quant à OPcache, sachez qu'il est déjà installé et chargé, il sera donc disponible.
2/ Activer PHP-FPM avec Apache
Après l'installation de PHP-FPM, il faut indiquer à Apache d'utiliser ce moteur PHP au lieu d'un éventuel module PHP intégré.
2.1 - Recherchez la version de php qui a été installée, puis adaptez toutes les commandes ci-dessous en remplaçant 8.x en fonction.
php -v
Si vous voyez PHP 8.5.4 ; utilisez seulement PHP 8.5.
La version majeure (ici 8) + la version mineure (ici 5). Le troisième chiffre à ne pas utiliser est le numéro de correctif (ici 4).
2.2 - Puis activez les deux modules Apache nécessaires (proxy_fcgi et setenvif) :
sudo a2enmod proxy_fcgi setenvif
2.3 - Activer ensuite la configuration Apache prévue pour PHP-FPM
sudo a2enconf php8.x-fpm
Exemple pour PHP 8.5 :
sudo a2enconf php8.5-fpm
2.4 - Puis recharger Apache
sudo systemctl reload apache2
Les trois commandes ci-dessus configurent Apache pour transmettre l'exécution des scripts PHP au service PHP-FPM.
Ainsi PHP-FPM est installé et configuré pour être utilisé par Apache.
3/ Installer MariaDB
sudo apt install mariadb-server mariadb-client
sudo systemctl enable mariadb
sudo systemctl start mariadb
sudo systemctl status mariadb
4/ Installer PhpMyAdmin
sudo apt install phpmyadmin
Si vous n'avez jamais installé PhpMyAdmin, je vous conseille de lire la première partie du tutoriel d'Ubuntu-fr, notamment au sujet du surlignage rouge (et pour les captures d'écran).
5/ Vérifier les réglages d'OPcache recommandés dans php.ini (FPM)
sudo nano /etc/php/8.x/fpm/php.ini
Par exemple :
sudo nano /etc/php/8.5/fpm/php.ini
• Vérifiez alors les paramètres suivants et modifiez leurs valeurs pour obtenir la configuration suivante :
[opcache]
opcache.enable = 1
opcache.memory_consumption = 128
opcache.interned_strings_buffer = 8
opcache.max_accelerated_files = 10000
opcache.validate_timestamps = 1
opcache.revalidate_freq = 2
Dans le fichier php.ini, les lignes précédées d'un point-virgule (;) sont des commentaires et ne sont pas prises en compte par PHP. Pour activer un paramètre, supprimez le point-virgule placé au début de la ligne. Si le paramètre est déjà actif, vérifiez simplement sa valeur et modifiez-la si nécessaire.
• Sauvegardez vos modifications dans Nano ainsi :
- Ctrl o (le o de olga)
- Appuyer sur "Entrée" pour confirmer le nom du fichier
- Ctrl x (le x de xavier)
Remarque : Les valeurs proposées pour OPcache sont des réglages couramment utilisés. Elles conviennent à de nombreuses installations et peuvent être conservées par défaut (sauf si les besoins de votre application ou les ressources de votre serveur nécessitent de les ajuster).
• Vous devez ensuite recharger FPM (adaptez en fonction de votre version de php) :
sudo systemctl restart php8.x-fpm
Exemple :
sudo systemctl restart php8.5-fpm
II - Configurer Apache pour utiliser ~/htdocs comme racine Web locale
Pour la suite de ce tuto « olivier » sera pris comme nom d'utilisateur, à titre d’exemple.
A - Créez un répertoire ~/htdocs
Ce répertoire accueillera tous les sites web de votre serveur local.
Il se trouvera dans /home/UTILISATEUR/htdocs
«UTILISATEUR» étant votre nom d'utilisateur Ubuntu.
Sous Linux, on peut remplacer « /home/utilisateur » de façon générique pour couvrir tous les noms possibles d'utilisateurs par simplement ~ ce symbole se nomme le "tilde".
Ainsi ; que votre nom utilisateur soit «olivier» ou « sophie » ; cela fonctionnera.
~/htdocs pointera aussi bien, sur /home/olivier/htdocs que sur /home/sophie/htdocs, en fonction de votre nom d'UTILISATEUR.
Pour créer ce répertoire, lancez dans un terminal la commande :
mkdir ~/htdocs
B – Créez un VirtualHost pour ~/htdocs
En effet plutôt que de pointer le serveur Web Apache vers ~/htdocs en modifiant le fichier de configuration /etc/apache2/sites-available/000-default.conf (fichier par défaut fourni par Ubuntu et susceptible d'être modifié lors d'une mise à jour), la solution la plus sûre est de :
1) Créez un fichier personnel à cet effet, par exemple nommé « dev.conf » qui contiendra la configuration du VirtualHost avec la commande :
sudo nano /etc/apache2/sites-available/dev.conf
2) Puis si votre nom d'utilisateur est « olivier » collez-y dedans ces instructions (adaptez-les avec votre propre nom d'utilisateur) :
<VirtualHost *:80>
ServerName localhost
DocumentRoot /home/olivier/htdocs
<Directory /home/olivier/htdocs>
Options Indexes FollowSymLinks MultiViews
AllowOverride All
Require all granted
</Directory>
ErrorLog ${APACHE_LOG_DIR}/dev-error.log
CustomLog ${APACHE_LOG_DIR}/dev-access.log combined
</VirtualHost>
3) Sauvegardez vos modifications dans Nano :
Ctrl o - ENTER - Ctrl x
Cela s'avère très pratique pour coller au plus près d'un serveur de production mutualisé.
4) Vérifiez que cette configuration est correcte avec :
sudo apachectl configtest
La réponse du terminal devrait être : Syntax OK
Ce point sera corrigé à la fin de ce tutoriel au paragraphe Définir le ServerName.
5) Activez le VirtualHost en créant son lien symbolique dans sites-enabled :
sudo a2ensite dev.conf
6) Désactivez le VirtualHost par défaut d'Apache en supprimant son lien symbolique (dans sites-enabled) avec la commande :
sudo a2dissite 000-default.conf
7) Rechargez la configuration d'Apache avec :
sudo systemctl reload apache2
III – Activez le module Apache « rewrite »
Ce module est également nécessaire pour utiliser la réécriture d'URL via des fichiers .htaccess.
Ces fichiers sont notamment utilisés par les CMS pour des URLs propres, la gestion de la pagination, les catégories, etc.
Pour activer le module « rewrite », lancer la commande :
sudo a2enmod rewrite
Le terminal vous suggérera de relancer Apache.
Par précaution sous Ubuntu, nous allons d'abord recharger la configuration d'Apache avec :
sudo systemctl reload apache2
Puis redémarrez Apache avec :
sudo systemctl restart apache2
IV - Modifiez les droits de votre HOME
Pour qu'Apache puisse traverser le dossier personnel, il faut modifier les droits de ce dossier.
Mais sans -R (récursif) pour ne pas impacter les sous-dossiers (snap, .config, .gnupg, .ssh…).
Pour une sécurité maximale et autoriser Apache à traverser mais à ne rien voire rien d'autre, lancez :
sudo chmod 711 ~
711 permet à Apache de traverser votre « Dossier personnel » mais protège la liste de vos fichiers perso (documents, photos, etc.) contre toute personne ou processus qui pourrait accéder au serveur web, ainsi que leur accès par d'autres comptes utilisateurs du système.
V – Vérifier que les droits du répertoire ~/htdocs sont :
Dossiers en 755 et Fichiers en 644
Dans ~/htdocs les fichiers doivent être en 644, ce qui est normalement déjà le cas, mais pour le vérifier lancez :
find ~/htdocs -type f -exec stat -c "%n %a" {} \;
Au besoin pour lister seulement les fichiers qui ne sont pas en 644, lancez :
find ~/htdocs -type f -not -perm 644
Ainsi vous pourrez repérer les fichiers mal configurés.
Si vous souhaitez les corriger et passer tous les fichiers en 644, lancez :
find ~/htdocs -type f -exec chmod 644 {} \;
Pour vérifier les droits du dossier ~/htdocs, la commande est :
stat --format=%a ~/htdocs
VI – Fichiers pour lesquels Apache doit avoir les droits d'écriture
Les compteurs de visites et d'autres genres de fichiers (log, statistique, cache, upload, fichiers de configuration dynamique…) nécessitent parfois des droits d'écriture pour qu'Apache puisse les modifier, sinon vous aurez probablement des messages d'erreur de cette sorte « Warning: fopen … » ou encore « Fatal error: Uncaught TypeError: fread() ... ».
Si vous tombez sur ce genre de message d'erreur, prenez le temps de copier le chemin d'accès indiqué, il vous servira dans la commande ci-dessous. Car dans cette situation, vous devrez modifier spécifiquement les permissions des fichiers en question et les passer en 664.
Pour cibler ceux d'un dossier en particulier, vous pouvez lancer cette commande :
sudo find ~/htdocs/mon-site/dossier-a-modifier -type f -exec chmod 664 {} \;
Modifiez /htdocs/mon-site/dossier-a-modifier par le chemin d'accès du message d'erreur avant de lancer la commande.
Imaginons par exemple que le message d'erreur indique le dossier : /home/alice/htdocs/mon-site/compteur/
Pour passer en 664 les fichiers de ce dossier, la commande serait :
sudo find ~/htdocs/mon-site/compteur/ -type f -exec chmod 664 {} \;
VII – Vérifier votre configuration Apache + PHP-FPM
• Créez la page d'Informations PHP (phpinfo)
Pour vérifier que PHP-FPM est bien utilisé par le serveur web Apache, la méthode que je recommande est de créer le fichier "info.php" dans votre répertoire personnel ~/htdocs avec le contenu suivant :
<?php
phpinfo();
?>
• Vérifiez la valeur de Server API
Ouvrez ensuite votre navigateur et rendez-vous à l'adresse :http://localhost/info.php et recherchez la ligne :
Server API
La valeur attendue est FPM/FastCGI. Elle confirme que le script PHP est exécuté par PHP-FPM, auquel Apache transmet les requêtes PHP via le protocole FastCGI.
Si vous obtenez une autre valeur, en particulier Apache 2.0 Handler, cela signifie que le script est exécuté au moyen de l'interface PHP intégrée à Apache, généralement via le module mod_php, Quelque chose s'est probablement mal passé : la configuration ne correspond pas à celle prévue.
VIII – Testez le serveur web Apache
Lancez l'URL de la page localhost dans votre navigateur.
http://127.0.0.1/ ou http://localhost
Si tout s'est déroulé comme prévu, Apache devrait afficher l'index du répertoire ~/htdocs, contenant le fichier info.php créé précédemment.
IX – PhpMyAdmin
Si vous utilisez PhpMyAdmin, depuis les versions récentes de MariaDB et MySQL vous devez créer un utilisateur dédié pour MariaDB/MySQL. Voici un exemple des commandes pour un utilisateur nommé "bob" qui aura pour mot de passe : 3LittlesBirds
Bien sûr, remplacez « bob » et « 3LittlesBirds » par ce que vous désirez dans les instructions ci-dessous.
- Connectez-vous à MySQL :
sudo mysql - Puis dans la console MySQL :
mysql>
Lancez ces 4 commandes à la successivement :CREATE USER 'bob'@'localhost' IDENTIFIED BY '3LittlesBirds';
GRANT ALL ON *.* TO 'bob'@'localhost' WITH GRANT OPTION;
FLUSH PRIVILEGES;
QUIT;
- Enfin quittez le terminal :
exit
Vous pourrez alors vous connecter à PhpMyAdmin avec "bob" et ce mot de passe pour créer et administrer vos bases de données.
Sinon lors de la connexion à PhpMyAdmin, vous verrez très certainement s'afficher :
"Impossible de se connecter au serveur MySQL / ...Access denied for user…"
NB. FLUSH PRIVILEGES; force la lecture des tables de privilèges avec MariaDB ≥10.4. C'est optionnel, car GRANT applique directement les droits, la commande reste toutefois valide et je la recommande (comme un couteau suisse).
- Sur un serveur de production, on évitera généralement WITH GRANT OPTION afin de limiter les privilèges.
- Sur un serveur de développement, il est ici volontairement utilisé, pour permettre l'administration complète des bases de données via phpMyAdmin et faciliter les tests.
X - Activez l'affichage des erreurs PHP
Sur un serveur de développement, il n'est pas rare de devoir débugger, pour cela vous aurez besoin que l'affichage des erreurs PHP soit actif, voici la marche à suivre :
- Trouvez le fichier "php.ini" avec la commande :
sudo find /etc/php -name php.iniIl se trouvera sans doute quelque part par là : /etc/php/8.x/fpm/php.ini
Exemple : /etc/php/8.5/fpm/php.ini
- Éditez ce fichier en ROOT (adaptez en remplaçant 8.x par votre numéro de version) :
sudo nano /etc/php/8.x/fpm/php.ini
Exemple :
sudo nano /etc/php/8.5/fpm/php.ini
- Recherchez l'instruction (Ctrl W puis ALT W) : display_errors = Off
- Et passez-la à : display_errors = On
- Sauvegardez (Ctrl O), puis ENTER et quittez Nano (Ctrl X)
Pour voir la position du curseur dans Nano (numéro de la ligne où il se situe) : ALT + C
- Puis rechargez les configurations de PHP-FPM et Apache par ces deux commandes :
sudo systemctl reload php8.x-fpm
Exemple :
sudo systemctl reload php8.5-fpm
sudo systemctl reload apache2
XI - Vérifier les permissions d'un répertoire
Pour afficher les droits d'accès des fichiers d'un dossier en valeur octale, utilisez stat et l'option --format=%a
Exemple ici pour celui du dossier ~/htdocs/mon-site :
stat --format=%a ~/htdocs/mon-site
Pour les afficher sous sous forme symbolique (r, w, x), lancez :
ls -l ~/htdocs/mon-site
XII - Autoriser PHP-FPM à modifier les fichiers de certains sites, au cas par cas
Remarque : les permissions proposées dans cette section privilégient la facilité d'utilisation d'un serveur de développement local. Elles permettent à PHP-FPM de modifier les fichiers d'un site, notamment pour installer des extensions et effectuer des mises à jour depuis l'interface Web (typiquement pour Wordpress, Joomla et d'autres CMS).
Vous pouvez appliquer ces commandes uniquement aux sites qui en ont besoin.
Si vous en développez plusieurs, vous pouvez conserver des permissions plus restrictives sur les autres.
- Associer les fichiers du site à votre compte utilisateur et au groupe Apache récursivement :
sudo chown -R $USER:www-data ~/htdocs/mon-CMS
- Autoriser l'écriture du propriétaire et du groupe dans les répertoires et les fichiers du site :
-
# Répertoires : droits de lecture, d'écriture et de traversée
# Avec héritage du groupe pour les nouveaux fichiers (Le chiffre 2 dans 2775 active le setgid)find ~/htdocs/mon-CMS -type d -exec chmod 2775 {} \;
- # Fichiers : droits de lecture et d'écriture
find ~/htdocs/mon-CMS -type f -exec chmod 664 {} \;
-
# Répertoires : droits de lecture, d'écriture et de traversée
- Les nouveaux fichiers et sous-répertoires créés dans ces répertoires hériteront normalement du groupe www-data.
- Les permissions 664 permettront au groupe www-data, utilisé par PHP-FPM, de lire et de modifier les fichiers du site (tout en conservant les droits du propriétaire).
XIII - Jeux de caractères
Pour les bases de données de sites web, utilisez de préférence utf8mb4 avec une collation compatible MySQL/MariaDB,
par exemple utf8mb4_unicode_ci.
Évitez les collations spécifiques à un seul moteur, vous pourrez plus facilement migrer entre hébergeurs.
XIV - Rendre PhpMyAdmin accessible
Après l'installation de PhpMyAdmin, sa configuration Apache se trouve dans :
/etc/phpmyadmin/apache.conf
Pour permettre à Apache de la charger :
1. Créez un lien symbolique dans conf-available
sudo ln -s /etc/phpmyadmin/apache.conf /etc/apache2/conf-available/phpmyadmin.conf
2. Puis activez cette configuration :
sudo a2enconf phpmyadmin
3. Vérifiez Apache
sudo apachectl configtest
Résultat attendu : Syntax OK
4.Rechargez Apache :
sudo systemctl reload apache2
5. Testez
PhpMyAdmin est maintenant accessible à l'adresse : http://localhost/phpmyadmin
XV - Définir le ServerName global d'Apache à l'intérieur du VirtualHost
Cela va permettre de supprimer le message « AH00558 : Could not reliably determine the server's fully qualified domain name, using 127.0.1.1. Set the 'ServerName' directive globally to suppress this message »
Puisque ce serveur est exclusivement destiné au développement local, on peut définir globalement : ServerName localhost
Le plus propre est donc de créer un petit fichier dédié :
sudo nano /etc/apache2/conf-available/servername.conf
et y mettre simplement :
ServerName localhost
Sauvegardez (Ctrl O), puis ENTER et quittez Nano (Ctrl X)
Puis lancez :
sudo a2enconf servername
sudo apachectl configtest
Ainsi on obtiendra simplement : Syntax OK
Enfin recharger Apache :
sudo systemctl reload apache2
XVI - Comment supprimer un compte de MySQL ?
Si vous devez supprimer un compte (même admin) de MySQL, lancez :
sudo mysql
DROP USER 'NOM-DU-COMPTE'@'localhost';
Remplacez "NOM-DU-COMPTE" par le nom du compte à supprimer.
QUIT;
À noter
Pour les développeurs souhaitant explorer des configurations plus spécifiques, PHP-FPM permet également, sur un serveur local, d'utiliser plusieurs versions de PHP en parallèle ou de travailler en HTTPS. Ces possibilités restent néanmoins facultatives pour un serveur de développement classique.

