Installer Nginx et PHP-FPM
Installez Nginx et PHP-FPM sur Debian ou Ubuntu : dépôts à jour, virtual host, pool dédié, test PHP, réglages essentiels, HTTPS, mises à jour et dépannage.
Sur cette page
Vos valeurs
Renseignez-les une fois, les commandes du guide se mettent à jour.
Ce guide vous explique comment installer Nginx depuis le dépôt officiel de nginx.org et PHP-FPM en version récente, puis publier un site avec son propre virtual host et son propre pool PHP.
Commander un serveur
Pour héberger vos sites, HostMyServers propose plusieurs offres :
Prérequis
- Un serveur sous Debian 12/13 ou Ubuntu 22.04/24.04
- Un accès SSH avec
rootou un utilisateursudo - Un nom de domaine dont les enregistrements pointent vers le serveur (voir créer un enregistrement A)
- Les ports 80 et 443 ouverts en TCP
PHP-FPM communique avec Nginx par un socket local : il n'a besoin d'aucun port ouvert. Si vous utilisez UFW (voir Configurer UFW) :
sudo ufw allow 80,443/tcp comment 'Web'Étape 1 : installer Nginx
Si Nginx est déjà installé depuis les paquets de votre distribution, sauvegardez /etc/nginx puis retirez-le avec sudo apt remove nginx nginx-common.
Installez les outils nécessaires. Sur Debian :
sudo apt update
sudo apt install curl gnupg2 ca-certificates lsb-release debian-archive-keyringSur Ubuntu :
sudo apt update
sudo apt install curl gnupg2 ca-certificates lsb-release ubuntu-keyringImportez la clé de signature et affichez ses empreintes :
curl -fsSL https://nginx.org/keys/nginx_signing.key | gpg --dearmor | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg > /dev/null
gpg --show-keys /usr/share/keyrings/nginx-archive-keyring.gpgLa liste doit contenir l'empreinte 573BFD6B3D8FBC641079A6ABABF5BD827BD9BF62. Sinon, supprimez le fichier et arrêtez-vous là.
Ajoutez le dépôt de la branche stable, donnez-lui la priorité, puis installez Nginx :
. /etc/os-release
echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] https://nginx.org/packages/$ID $(lsb_release -cs) nginx" | sudo tee /etc/apt/sources.list.d/nginx.list
printf 'Package: *\nPin: origin nginx.org\nPin: release o=nginx\nPin-Priority: 900\n' | sudo tee /etc/apt/preferences.d/99nginx
sudo apt update
sudo apt install nginx
sudo systemctl enable --now nginx
nginx -vÉtape 2 : installer PHP-FPM
Le projet PHP ne publie pas de dépôt APT. Pour obtenir une version récente sur tous ces systèmes, ce guide utilise le dépôt packages.sury.org, maintenu par Ondřej Surý, également mainteneur des paquets PHP de Debian. C'est un dépôt tiers : ajoutez-le seulement si vous lui faites confiance.
sudo apt install lsb-release ca-certificates curl
curl -fsSLo /tmp/debsuryorg-archive-keyring.deb https://packages.sury.org/debsuryorg-archive-keyring.deb
sudo dpkg -i /tmp/debsuryorg-archive-keyring.deb
echo "deb [signed-by=/usr/share/keyrings/debsuryorg-archive-keyring.gpg] https://packages.sury.org/php/ $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/php.list
sudo apt updateInstallez PHP 8.5 avec les extensions les plus courantes :
sudo apt install php8.5-fpm php8.5-cli php8.5-curl php8.5-mbstring php8.5-xml php8.5-zip php8.5-intl php8.5-gd php8.5-mysql
php -v
sudo systemctl status php8.5-fpmInstallez bien php8.5-fpm et non le paquet générique php, qui peut ajouter Apache.
Étape 3 : créer le site
Chaque site dispose ici d'un utilisateur système. PHP peut lire le code, mais ne peut écrire que dans uploads :
sudo useradd --system --user-group --home-dir /var/www/votre-domaine.com --shell /usr/sbin/nologin webapp
sudo mkdir -p /var/www/votre-domaine.com/public/uploads
sudo chown -R "$USER":webapp /var/www/votre-domaine.com
sudo find /var/www/votre-domaine.com -type d -exec chmod 755 {} +
sudo chown webapp:webapp /var/www/votre-domaine.com/public/uploadsCréez une page de test :
nano /var/www/votre-domaine.com/public/index.php<?php
header('Content-Type: text/plain; charset=utf-8');
echo 'PHP ', PHP_VERSION, ' (', PHP_SAPI, ')', PHP_EOL;
echo 'User: ', posix_getpwuid(posix_geteuid())['name'], PHP_EOL;
echo 'OPcache: ', (function_exists('opcache_get_status') && opcache_get_status(false)) ? 'on' : 'off', PHP_EOL;Étape 4 : créer le pool PHP-FPM
sudo nano /etc/php/8.5/fpm/pool.d/votre-domaine.com.conf[votre-domaine.com]
user = webapp
group = webapp
listen = /run/php/votre-domaine.com.sock
listen.owner = nginx
listen.group = nginx
listen.mode = 0660
pm = dynamic
pm.max_children = 10
pm.start_servers = 2
pm.min_spare_servers = 1
pm.max_spare_servers = 3
pm.max_requests = 500
request_terminate_timeout = 120s
catch_workers_output = yes
php_admin_flag[log_errors] = onDésactivez le pool par défaut, qui ne sert plus :
sudo mv /etc/php/8.5/fpm/pool.d/www.conf /etc/php/8.5/fpm/pool.d/www.conf.disabledÉtape 5 : régler PHP
Placez vos réglages dans un fichier séparé, qui ne sera pas touché par les mises à jour :
sudo nano /etc/php/8.5/fpm/conf.d/90-custom.inimemory_limit = 256M
upload_max_filesize = 32M
post_max_size = 32M
max_execution_time = 60
date.timezone = Europe/Paris
expose_php = Off
display_errors = Off
log_errors = On
session.use_strict_mode = 1
session.cookie_httponly = 1
opcache.enable = 1
opcache.memory_consumption = 128
opcache.max_accelerated_files = 10000
opcache.validate_timestamps = 1
opcache.revalidate_freq = 2Testez puis redémarrez PHP-FPM :
sudo php-fpm8.5 -t
sudo systemctl restart php8.5-fpm
ls -l /run/php/Le socket votre-domaine.com.sock doit appartenir à nginx:nginx.
Étape 6 : configurer Nginx
Désactivez la configuration d'exemple, puis créez les réglages généraux :
sudo mv /etc/nginx/conf.d/default.conf /etc/nginx/conf.d/default.conf.disabled
sudo nano /etc/nginx/conf.d/00-defaults.confserver_tokens off;
gzip on;
gzip_vary on;
gzip_min_length 1024;
gzip_types text/plain text/css application/javascript application/json application/xml image/svg+xml;
server {
listen 80 default_server;
listen [::]:80 default_server;
server_name _;
return 444;
}
server {
listen 443 ssl default_server;
listen [::]:443 ssl default_server;
server_name _;
ssl_reject_handshake on;
}Ces deux blocs ferment la connexion lorsqu'une requête ne correspond à aucun de vos domaines. Créez ensuite le virtual host :
sudo nano /etc/nginx/conf.d/votre-domaine.com.confserver {
listen 80;
listen [::]:80;
server_name votre-domaine.com www.votre-domaine.com;
root /var/www/votre-domaine.com/public;
index index.php index.html;
access_log /var/log/nginx/votre-domaine.com.access.log;
error_log /var/log/nginx/votre-domaine.com.error.log;
client_max_body_size 32m;
location ~ /\.(?!well-known) {
deny all;
}
location ^~ /uploads/ {
location ~ \.php$ {
deny all;
}
}
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
try_files $uri =404;
fastcgi_pass unix:/run/php/votre-domaine.com.sock;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
fastcgi_param DOCUMENT_ROOT $realpath_root;
}
}Cette configuration refuse l'accès aux fichiers cachés comme .env et l'exécution de PHP dans uploads. Testez et rechargez :
sudo nginx -t
sudo systemctl reload nginxÉtape 7 : vérifier le site
Depuis le serveur :
curl -i -H 'Host: votre-domaine.com' http://127.0.0.1/La réponse doit être 200 OK, avec la version de PHP, l'utilisateur webapp et OPcache: on. Vérifiez aussi les protections :
echo 'test' > /var/www/votre-domaine.com/public/.test
curl -s -o /dev/null -w '%{http_code}\n' -H 'Host: votre-domaine.com' http://127.0.0.1/.test
rm /var/www/votre-domaine.com/public/.testLe code attendu est 403. Ouvrez ensuite http://votre-domaine.com dans votre navigateur. Une requête directe vers l'adresse IP n'obtient pas de réponse : c'est l'effet voulu du bloc par défaut.
Étape 8 : activer HTTPS
Suivez le guide Installer un certificat SSL avec Let's Encrypt, section Nginx. Ignorez sa partie sur sites-available : votre fichier est /etc/nginx/conf.d/votre-domaine.com.conf. La commande principale est :
sudo certbot --nginx -d votre-domaine.com -d www.votre-domaine.comUne fois le certificat installé, activez HTTP/2 en ajoutant cette ligne dans le bloc server qui contient listen 443 ssl :
http2 on;Ajoutez aussi cette ligne à /etc/php/8.5/fpm/conf.d/90-custom.ini pour réserver les cookies de session à HTTPS :
session.cookie_secure = 1Appliquez puis contrôlez :
sudo nginx -t
sudo systemctl reload nginx
sudo systemctl restart php8.5-fpm
curl -I https://votre-domaine.com
sudo certbot renew --dry-runUne fois vos tests terminés, remplacez la page de test par votre application.
Dimensionner PHP-FPM
pm.max_children limite le nombre de requêtes PHP traitées en même temps. Une valeur trop haute peut épuiser la mémoire. Mesurez la consommation moyenne, de préférence sous charge réelle :
ps --no-headers -o rss -C php-fpm8.5 | awk '{s+=$1; n++} END {printf "%.0f Mo\n", s/n/1024}'
free -mCalculez ensuite : mémoire disponible pour PHP ÷ consommation moyenne d'un processus. Par exemple, 1 024 Mo ÷ 60 Mo donnent environ 17 processus. Gardez une marge pour le système et la base de données, puis rechargez avec sudo systemctl reload php8.5-fpm.
Mises à jour
sudo apt update
sudo apt upgrade
sudo nginx -t
sudo systemctl status nginx php8.5-fpmPour passer à une nouvelle branche de PHP, installez ses paquets, copiez votre pool et 90-custom.ini dans le dossier de la nouvelle version, arrêtez l'ancien service, puis démarrez le nouveau. Le socket conservant le même nom, le virtual host ne change pas. Testez votre application au préalable.
Sauvegarde
Sauvegardez le site et sa configuration, puis copiez l'archive hors du serveur :
sudo tar czf site-backup.tar.gz /var/www/votre-domaine.com /etc/nginx /etc/php/8.5/fpm /etc/letsencrypt
sudo chmod 600 site-backup.tar.gzL'archive contient les clés privées de vos certificats. Si le site utilise une base de données, sauvegardez-la séparément, par exemple avec mariadb-dump (voir Installer et sécuriser MariaDB).
En cas de problème
Les journaux utiles sont /var/log/nginx/votre-domaine.com.error.log et /var/log/php8.5-fpm.log.
502 Bad Gateway avec connect() ... failed (13: Permission denied)
Nginx n'a pas accès au socket. Vérifiez listen.owner et listen.group dans le pool, puis redémarrez PHP-FPM.
502 Bad Gateway avec connect() ... failed (2: No such file or directory)
PHP-FPM est arrêté, ou le chemin du socket diffère entre le pool et fastcgi_pass. Consultez sudo systemctl status php8.5-fpm et sudo php-fpm8.5 -t.
File not found. ou Primary script unknown
Le fichier n'existe pas à l'emplacement indiqué par root, ou l'utilisateur webapp ne peut pas le lire. Vérifiez le chemin et les droits avec namei -l /var/www/votre-domaine.com/public/index.php.
Le navigateur télécharge le fichier PHP
Le bloc location ~ \.php$ n'est pas pris en compte. Vérifiez que le domaine correspond à server_name, puis rechargez Nginx.
413 Request Entity Too Large
Augmentez client_max_body_size dans Nginx ainsi que upload_max_filesize et post_max_size dans PHP, avec des valeurs cohérentes.
504 Gateway Timeout
Le script dépasse le délai de Nginx. Optimisez-le si possible, ou ajustez ensemble fastcgi_read_timeout, max_execution_time et request_terminate_timeout.
server reached pm.max_children setting
Toutes les places du pool sont occupées. Recherchez d'abord les requêtes lentes, puis augmentez pm.max_children si la mémoire le permet.
bind() to 0.0.0.0:80 failed (98: Address already in use)
Un autre service, souvent Apache, occupe le port. Identifiez-le avec sudo ss -ltnp | grep ':80 '.
curl: (52) Empty reply from server
La requête ne correspond à aucun server_name et le bloc par défaut a fermé la connexion. Vérifiez l'en-tête Host et le domaine configuré.