La maîtrise de l’installation de PHP sur un serveur Debian s’avère cruciale pour qui souhaite déployer des sites ou applications web efficaces et sécurisés. De Debian 10 à Debian 13, les évolutions logicielles rendent les configurations plus puissantes, notamment grâce à la complémentarité entre PHP et Nginx. Ce serveur web, choisi pour sa légèreté et ses performances, nécessite toutefois une configuration fine pour exploiter pleinement PHP via PHP-FPM. Au fil de ce guide, les étapes d’installation et de configuration sont détaillées, de la mise à jour du système à la sécurisation avancée, en passant par l’intégration des extensions indispensables.
L’article en bref
Ce guide propose une démarche claire et accessible pour installer et configurer PHP sur Debian 10 à 13 avec Nginx. Il couvre l’essentiel pour garantir un déploiement fiable et sécurisé de vos applications web.
- Installation adaptée à chaque version Debian : procédure évolutive de Debian 10 à 13 avec PHP 7.3 à 8.2
- Intégration optimisée avec Nginx : configuration PHP-FPM pour un traitement performant des scripts
- Extensions PHP essentielles : instructions pour ajouter les modules couramment utilisés
- Conseils pour la sécurité et le dépannage : bonnes pratiques pour éviter les erreurs courantes et renforcer la sécurité
Un appareil web performant repose autant sur une installation rigoureuse que sur une maintenance proactive.
Installer PHP sur Debian 10, 11 et 13 : déroulement et spécificités
Debian, appréciée pour sa stabilité, propose par défaut différentes versions de PHP selon sa révision. Debian 10, nommée Buster, embarque PHP 7.3, suffisant pour de nombreux CMS populaires tels que WordPress ou Laravel. Avec Debian 13, la version s’actualise à PHP 8.2, offrant des gains notables en performance et en sécurité. Pour suivre cette évolution, adapter la méthode d’installation selon la version du système est indispensable.
L’usage privilégié de l’utilisateur root ou, à défaut, d’un compte sudo est nécessaire pour garantir la gestion des paquets. La manipulation commence par la mise à jour complète du système, afin d’obtenir un environnement stable et sécurisé avant l’installation de PHP et de ses composants.
Différences majeures entre Debian 10 et 13 pour PHP
| Elément | Debian 10 (Buster) | Debian 13 (à partir 2026) |
|---|---|---|
| Version PHP disponible | 7.3 (stable et compatible) | 8.2 avec améliorations et corrections de sécurité |
| Modules recommandés | php-mysql, php-gd, libapache2-mod-php | php8.2-mysql, php8.2-gd, php8.2-mbstring, php8.2-curl |
| Gestion du serveur web | Apache intégré souvent utilisé | Nginx privilégié avec PHP-FPM |
| Sécurité | Paramétrages manuels fréquents | Durcissement simplifié via options PHP-FPM et Nginx |
Configurer PHP avec Nginx : le rôle de PHP-FPM
Nginx ne traite pas directement les scripts PHP. Pour offrir cette fonctionnalité, il s’appuie sur PHP-FPM (FastCGI Process Manager), un gestionnaire de processus permettant un traitement rapide et efficace des requêtes PHP. Son installation est indépendante et doit être configurée sur mesure pour s’interfacer avec le serveur web.
Après l’installation via la commande sudo apt install php php-fpm, le service PHP-FPM démarre automatiquement. L’enjeu principal consiste alors à adapter la configuration de Nginx pour orienter la gestion des fichiers .php vers ce gestionnaire.
Extrait type d’un bloc serveur Nginx adapté au traitement PHP
server {
listen 80;
server_name exemple.com www.exemple.com;
root /var/www/exemple.com/public;
index index.php index.html;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ .php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php7.3-fpm.sock;
}
}
Cette configuration redirige toute requête vers un fichier PHP vers le socket de PHP-FPM, garantissant le déploiement optimal des scripts.
Les extensions PHP indispensables pour un serveur polyvalent
PHP offre un vaste panel d’extensions permettant d’élargir ses capacités fonctionnelles. Parmi les plus utilisées figurent celles dédiées aux bases de données, au traitement d’images, ou aux manipulations XML. Le choix et l’installation des extensions doivent répondre aux besoins spécifiques des applications hébergées.
Les commandes d’installation suivent un principe simple : sudo apt install php-[extension]. Par exemple, php-mysql pour la connexion aux bases MySQL, ou php-gd pour les fonctions graphiques. Un redémarrage de PHP-FPM ou d’Apache est nécessaire après ajout d’une extension.
- php-mysql : accès aux bases de données MySQL et MariaDB
- php-gd : manipulation d’images et création graphique
- php-curl : gestion des requêtes HTTP externes
- php-xml : traitement des documents XML
- php-mbstring : support des chaînes multibytes pour l’internationalisation
Test et validation du déploiement PHP sur votre serveur Debian avec Nginx
La vérification du fonctionnement correct de PHP est une étape indispensable avant de passer à la production. La méthode classique consiste à créer un fichier d’information dans le répertoire web, par exemple /var/www/html/info.php, contenant le code suivant :
<script php> phpinfo(); </script>
Accessible via le navigateur à http://adresse_serveur/info.php, ce fichier affiche les paramètres et les modules actifs de PHP. Cette étape permet également d’identifier les versions en cours d’exécution et d’assurer la bonne communication entre Nginx et PHP-FPM.
Sécuriser l’installation et optimiser le serveur web
Le périmètre de sécurité autour de PHP et Nginx ne doit pas être négligé. Le paramètre cgi.fix_pathinfo=0 dans la configuration PHP-FPM est une règle préventive contre certaines failles. La gestion des droits sur les dossiers web doit être rigoureuse, ajustant les permissions et la propriété aux utilisateurs adéquats (souvent www-data).
En matière d’optimisation, Nginx doit être configuré pour gérer efficacement les contenus statiques et limiter la taille des uploads si besoin. Le recours à HTTPS, via Let’s Encrypt, garantit une couche de sécurité essentielle pour tout site accessible sur Internet.
- Modifier le fichier php.ini pour désactiver l’exécution flexible des chemins
- Restreindre les permissions des fichiers à l’utilisateur du serveur (www-data)
- Configurer les en-têtes de sécurité dans Nginx (Content-Security-Policy, X-Frame-Options)
- Activer un pare-feu et installer Fail2ban pour surveiller les tentatives d’intrusion
Liste des étapes clés pour un déploiement PHP réussi avec Nginx sur Debian
- Effectuer une mise à jour complète du système Debian
- Installer PHP (version adaptée à votre Debian) avec PHP-FPM
- Configurer le bloc serveur Nginx pour utiliser PHP-FPM via socket
- Installer les extensions PHP nécessaires selon les besoins de l’application
- Créer et tester un fichier info.php pour vérifier la configuration
- Appliquer les recommandations de sécurité dans php.ini et Nginx
- Mettre en place HTTPS avec Certbot si le serveur est accessible publiquement
- Surveiller log et performances, ajuster en cas d’erreur ou lenteur
Tableau comparatif des commandes d’installation PHP sur Debian 10 à 13 avec Nginx
| Commande | Debian 10 (PHP 7.3) | Debian 13 (PHP 8.2) |
|---|---|---|
| Mise à jour du système | sudo apt update && sudo apt upgrade -y |
sudo apt update && sudo apt upgrade -y |
| Installation PHP-FPM | sudo apt install php php-fpm |
sudo apt install php8.2-fpm php8.2-cli |
| Extensions courantes | sudo apt install php-mysql php-gd |
sudo apt install php8.2-mysql php8.2-gd php8.2-mbstring |
| Redémarrage services | sudo systemctl restart php7.3-fpm nginx |
sudo systemctl restart php8.2-fpm nginx |
Quelle différence entre Apache et Nginx pour l’exécution de PHP ?
Apache intègre un module PHP natif simplifiant la configuration, tandis que Nginx utilise PHP-FPM, nécessitant une mise en place plus précise mais offrant de meilleures performances sous charge.
Pourquoi privilégier PHP-FPM avec Nginx sur Debian 13 ?
PHP-FPM gère les processus PHP séparément, améliorant la stabilité et la vitesse du serveur. Debian 13 tire parti des dernières versions PHP optimisées pour ce mode.
Comment éviter l’erreur 502 Bad Gateway après l’installation ?
Vérifiez que le service PHP-FPM est bien actif et que le socket spécifié dans la configuration Nginx correspond à la version PHP installée. Ajustez les chemins si nécessaire et redémarrez les services.
Quels sont les risques si la sécurité PHP-FPM est négligée ?
Une mauvaise configuration peut exposer le serveur à l’exécution de scripts malveillants, compromettant ainsi l’intégrité des données et la disponibilité du service.
Peut-on utiliser HTTPS avec Nginx sur Debian sans difficulté ?
Oui, l’installation de Certbot facilite l’activation de certificats SSL/TLS gratuits via Let’s Encrypt, renforçant la confidentialité des échanges.
