FR

Applications

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.

7 min de lecture, mis à jour le 18 novembre 2026

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 root ou un utilisateur sudo
  • 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) :

Terminal
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 :

Terminal
sudo apt update
sudo apt install curl gnupg2 ca-certificates lsb-release debian-archive-keyring

Sur Ubuntu :

Terminal
sudo apt update
sudo apt install curl gnupg2 ca-certificates lsb-release ubuntu-keyring

Importez la clé de signature et affichez ses empreintes :

Terminal
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.gpg

La 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 :

Terminal
. /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.

Terminal
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 update

Installez PHP 8.5 avec les extensions les plus courantes :

Terminal
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-fpm

Installez 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 :

Terminal
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/uploads

Créez une page de test :

Terminal
nano /var/www/votre-domaine.com/public/index.php
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

Terminal
sudo nano /etc/php/8.5/fpm/pool.d/votre-domaine.com.conf
Configuration
[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] = on

Désactivez le pool par défaut, qui ne sert plus :

Terminal
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 :

Terminal
sudo nano /etc/php/8.5/fpm/conf.d/90-custom.ini
Configuration
memory_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 = 2

Testez puis redémarrez PHP-FPM :

Terminal
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 :

Terminal
sudo mv /etc/nginx/conf.d/default.conf /etc/nginx/conf.d/default.conf.disabled
sudo nano /etc/nginx/conf.d/00-defaults.conf
Nginx
server_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 :

Terminal
sudo nano /etc/nginx/conf.d/votre-domaine.com.conf
Nginx
server {
    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 :

Terminal
sudo nginx -t
sudo systemctl reload nginx

Étape 7 : vérifier le site

Depuis le serveur :

Terminal
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 :

Terminal
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/.test

Le 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 :

Terminal
sudo certbot --nginx -d votre-domaine.com -d www.votre-domaine.com

Une fois le certificat installé, activez HTTP/2 en ajoutant cette ligne dans le bloc server qui contient listen 443 ssl :

Nginx
http2 on;

Ajoutez aussi cette ligne à /etc/php/8.5/fpm/conf.d/90-custom.ini pour réserver les cookies de session à HTTPS :

Configuration
session.cookie_secure = 1

Appliquez puis contrôlez :

Terminal
sudo nginx -t
sudo systemctl reload nginx
sudo systemctl restart php8.5-fpm
curl -I https://votre-domaine.com
sudo certbot renew --dry-run

Une 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 :

Terminal
ps --no-headers -o rss -C php-fpm8.5 | awk '{s+=$1; n++} END {printf "%.0f Mo\n", s/n/1024}'
free -m

Calculez 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

Terminal
sudo apt update
sudo apt upgrade
sudo nginx -t
sudo systemctl status nginx php8.5-fpm

Pour 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 :

Terminal
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.gz

L'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é.

Références