Installer Apache avec PHP sur Linux (Ubuntu, Debian, AlmaLinux)

Tutoriels Linux › Serveurs web

Documentation / Tutoriels Linux / Serveurs web / Installer Apache avec PHP sur Linux (Ubuntu, Debian, AlmaLinux)
Mis à jour le 08/10/2026
670 vues
Débutant
20 minutes

Prérequis

  • Un serveur sous Ubuntu, Debian, AlmaLinux, Rocky, CentOS, Fedora, Alpine ou openSUSE : voir nos VPS au Canada
  • Une connexion SSH ouverte en root : Se connecter en SSH à votre VPS
  • Pour l'étape HTTPS seulement : un nom de domaine dont l'enregistrement A pointe sur l'adresse IP du serveur
Votre serveur :

Apache est le serveur web historique, celui que visent les fichiers .htaccess de WordPress et de la plupart des hébergements mutualisés. Ce guide l'installe avec PHP, montre comment votre système relie les deux (ce n'est pas pareil partout), crée un hôte virtuel pour un site (monsite.exemple.ca, dossier /var/www/monsite), règle PHP, se sert d'un .htaccess, ouvre le pare-feu et passe en HTTPS avec Certbot. Choisissez votre système ci-dessus. Copiez la commande avec le bouton Copier, collez-la dans votre terminal, et comparez avec le résultat attendu.

1Mettre à jour le système

Mettre à jour le système
apt update && apt upgrade -y
Résultat attendu
...
212 upgraded, 8 newly installed, 0 to remove and 4 not upgraded.
(les nombres dépendent de l'âge de l'image)
Mettre à jour le système
dnf upgrade -y
Résultat attendu
...
Complete!
Mettre à jour le système
dnf upgrade -y
Résultat attendu
...
Complete!
Mettre à jour le système, puis redémarrer
apk update && apk upgrade && reboot
Résultat attendu
...
OK: 158 MiB in 209 packages
(les nombres dépendent de l'image ; la connexion SSH se coupe au redémarrage)

Alpine redémarre après la mise à jour : quand elle remplace le noyau, les modules du noyau en cours disparaissent et le pare-feu de l'étape 7 ne peut plus se charger (« Couldn't determine iptables version »). Reconnectez-vous en SSH après une minute.

Mettre à jour le système
zypper -n refresh && zypper -n update
Résultat attendu
All repositories have been refreshed.
...

2Installer Apache et PHP

Il y a deux façons pour Apache d'exécuter du PHP : comme un module dans Apache (mod_php), ou en confiant les fichiers .php à un service séparé, PHP-FPM. Votre système a déjà choisi, et l'étape suivante vous montre laquelle vous avez. Les extensions posées ici sont celles que demandent WordPress et la plupart des applications.

Installer Apache, le module PHP et les extensions courantes
apt install -y apache2 php libapache2-mod-php php-mysql php-curl php-gd php-mbstring php-xml php-zip php-intl
Résultat attendu
...
Setting up libapache2-mod-php8.3 ...
Setting up apache2 ...
(php8.4 sur Debian 13 ; Apache démarre tout seul)
Activer PHP 8.3, installer Apache et PHP, démarrer les deux services
dnf module reset php -y && dnf module enable php:8.3 -y && dnf install -y httpd php php-cli php-mysqlnd php-curl php-gd php-mbstring php-xml php-zip php-intl php-opcache && systemctl enable --now httpd php-fpm
Résultat attendu
...
Complete!
Created symlink /etc/systemd/system/multi-user.target.wants/httpd.service → ...
Created symlink /etc/systemd/system/multi-user.target.wants/php-fpm.service → ...
(sans « module enable php:8.3 », AlmaLinux, Rocky et CentOS installent PHP 8.0, qui n'est plus maintenu)
Installer Apache et PHP, démarrer les deux services
dnf install -y httpd php php-cli php-mysqlnd php-curl php-gd php-mbstring php-xml php-zip php-intl php-opcache && systemctl enable --now httpd php-fpm
Résultat attendu
...
Complete!
Created symlink '/etc/systemd/system/multi-user.target.wants/httpd.service' → ...
Created symlink '/etc/systemd/system/multi-user.target.wants/php-fpm.service' → ...
(Fedora fournit déjà PHP 8.5, rien à activer)
Installer Apache, le module PHP et les extensions courantes, démarrer Apache
apk add apache2 php84-apache2 php84 php84-mysqli php84-pdo_mysql php84-curl php84-gd php84-mbstring php84-xml php84-dom php84-zip php84-intl php84-opcache php84-session php84-openssl curl && rc-update add apache2 default && rc-service apache2 start
Résultat attendu
...
 * service apache2 added to runlevel default
 * Starting apache2 ... [ ok ]
(php84-apache2 est le module PHP pour Apache ; curl sert aux vérifications)
Installer Apache, le module PHP et les extensions, activer le module et démarrer Apache
zypper -n install apache2 apache2-mod_php8 php8 php8-cli php8-mysql php8-curl php8-gd php8-mbstring php8-dom php8-zip php8-intl php8-opcache php8-openssl && a2enmod php8 && systemctl enable --now apache2
Résultat attendu
...
Running post-transaction scripts [...done]
(a2enmod php8 branche le module PHP dans Apache)

3Voir comment Apache exécute PHP

Cette page de test affiche la version de PHP et, entre parenthèses, la façon dont Apache l'exécute : apache2handler veut dire que PHP est un module d'Apache (mod_php), fpm-fcgi qu'Apache passe par le service PHP-FPM. C'est cette différence qui explique le reste du guide.

Ubuntu / DebianPoser une page de test dans le dossier web par défaut, l'appeler, la retirer
echo '<?php echo "PHP ", PHP_VERSION, " via ", php_sapi_name(), "\n";' > /var/www/html/info.php
curl http://127.0.0.1/info.php
rm /var/www/html/info.php
Résultat attendu
PHP 8.3.6 via apache2handler
AlmaLinux / Rocky / CentOSPoser une page de test dans le dossier web par défaut, l'appeler, la retirer
echo '<?php echo "PHP ", PHP_VERSION, " via ", php_sapi_name(), "\n";' > /var/www/html/info.php
curl http://127.0.0.1/info.php
rm /var/www/html/info.php
Résultat attendu
PHP 8.3.33 via fpm-fcgi
FedoraPoser une page de test dans le dossier web par défaut, l'appeler, la retirer
echo '<?php echo "PHP ", PHP_VERSION, " via ", php_sapi_name(), "\n";' > /var/www/html/info.php
curl http://127.0.0.1/info.php
rm /var/www/html/info.php
Résultat attendu
PHP 8.5.10 via fpm-fcgi
AlpinePoser une page de test dans le dossier web par défaut, l'appeler, la retirer
echo '<?php echo "PHP ", PHP_VERSION, " via ", php_sapi_name(), "\n";' > /var/www/localhost/htdocs/info.php
curl http://127.0.0.1/info.php
rm /var/www/localhost/htdocs/info.php
Résultat attendu
PHP 8.4.25 via apache2handler
openSUSEPoser une page de test dans le dossier web par défaut, l'appeler, la retirer
echo '<?php echo "PHP ", PHP_VERSION, " via ", php_sapi_name(), "\n";' > /srv/www/htdocs/info.php
curl http://127.0.0.1/info.php
rm /srv/www/htdocs/info.php
Résultat attendu
PHP 8.4.24 via apache2handler
Vérifier les versions et la méthode
apache2 -v && php -v | head -1
Résultat attendu
Server version: Apache/2.4.58 (Ubuntu)
PHP 8.3.6 (cli) ...
(Debian 13 : Apache 2.4.68 et PHP 8.4.24. La page de test affiche « via apache2handler » : PHP est un module d'Apache)
Vérifier les versions et la méthode
httpd -v && php -v | head -1
Résultat attendu
Server version: Apache/2.4.62 (AlmaLinux)
PHP 8.3.33 (cli) ...
(Rocky : idem ; CentOS Stream : PHP 8.3.19. La page de test affiche « via fpm-fcgi » : Apache passe par PHP-FPM)
Vérifier les versions et la méthode
httpd -v && php -v | head -1
Résultat attendu
Server version: Apache/2.4.68 (Fedora Linux)
PHP 8.5.10 (cli) ...
(la page de test affiche « via fpm-fcgi » : Apache passe par PHP-FPM)
Vérifier les versions et la méthode
httpd -v && php84 -v | head -1
Résultat attendu
Server version: Apache/2.4.68 (Unix)
PHP 8.4.25 (cli) ...
(la page de test affiche « via apache2handler » : PHP est un module d'Apache. La commande PHP s'appelle php84)
Vérifier les versions et la méthode
httpd -v && php -v | head -1
Résultat attendu
Server version: Apache/2.4.66 (Linux/SUSE)
PHP 8.4.24 (cli) ...
(la page de test affiche « via apache2handler » : PHP est un module d'Apache)

4Créer un hôte virtuel

Un hôte virtuel dit à Apache quel dossier servir pour quel nom de domaine. Celui-ci sert /var/www/monsite pour monsite.exemple.ca ; remplacez ce nom par le vôtre. AllowOverride All autorise les fichiers .htaccess dans ce dossier (voir l'étape 6). La page index.php affiche la version de PHP et trois réglages : elle sert de témoin pour la suite.

Ubuntu / DebianCréer le site et l'activer (et retirer le site par défaut)
mkdir -p /var/www/monsite
cat > /var/www/monsite/index.php << 'EOF'
<?php
echo 'PHP ', PHP_VERSION, ' (', php_sapi_name(), ') upload ', ini_get('upload_max_filesize'), ' memoire ', ini_get('memory_limit'), ' fuseau ', date_default_timezone_get(), "\n";
EOF
cat > /etc/apache2/sites-available/monsite.conf << 'EOF'
<VirtualHost *:80>
    ServerName monsite.exemple.ca
    DocumentRoot /var/www/monsite
    <Directory /var/www/monsite>
        AllowOverride All
        Require all granted
    </Directory>
    ErrorLog ${APACHE_LOG_DIR}/monsite.error.log
    CustomLog ${APACHE_LOG_DIR}/monsite.access.log combined
</VirtualHost>
EOF
a2ensite monsite.conf
a2dissite 000-default.conf
chown -R www-data:www-data /var/www/monsite
apachectl configtest && systemctl reload apache2
Résultat attendu
Enabling site monsite.
Site 000-default disabled.
Syntax OK
(le rechargement applique le nouveau site)
AlmaLinux / Rocky / CentOSCréer le site
mkdir -p /var/www/monsite
cat > /var/www/monsite/index.php << 'EOF'
<?php
echo 'PHP ', PHP_VERSION, ' (', php_sapi_name(), ') upload ', ini_get('upload_max_filesize'), ' memoire ', ini_get('memory_limit'), ' fuseau ', date_default_timezone_get(), "\n";
EOF
cat > /etc/httpd/conf.d/monsite.conf << 'EOF'
<VirtualHost *:80>
    ServerName monsite.exemple.ca
    DocumentRoot /var/www/monsite
    <Directory /var/www/monsite>
        AllowOverride All
        Require all granted
    </Directory>
    ErrorLog /var/log/httpd/monsite.error.log
    CustomLog /var/log/httpd/monsite.access.log combined
</VirtualHost>
EOF
chown -R apache:apache /var/www/monsite
httpd -t && systemctl reload httpd
Résultat attendu
Syntax OK
FedoraCréer le site
mkdir -p /var/www/monsite
cat > /var/www/monsite/index.php << 'EOF'
<?php
echo 'PHP ', PHP_VERSION, ' (', php_sapi_name(), ') upload ', ini_get('upload_max_filesize'), ' memoire ', ini_get('memory_limit'), ' fuseau ', date_default_timezone_get(), "\n";
EOF
cat > /etc/httpd/conf.d/monsite.conf << 'EOF'
<VirtualHost *:80>
    ServerName monsite.exemple.ca
    DocumentRoot /var/www/monsite
    <Directory /var/www/monsite>
        AllowOverride All
        Require all granted
    </Directory>
    ErrorLog /var/log/httpd/monsite.error.log
    CustomLog /var/log/httpd/monsite.access.log combined
</VirtualHost>
EOF
chown -R apache:apache /var/www/monsite
httpd -t && systemctl reload httpd
Résultat attendu
Syntax OK
AlpineCréer le site
mkdir -p /var/www/monsite
cat > /var/www/monsite/index.php << 'EOF'
<?php
echo 'PHP ', PHP_VERSION, ' (', php_sapi_name(), ') upload ', ini_get('upload_max_filesize'), ' memoire ', ini_get('memory_limit'), ' fuseau ', date_default_timezone_get(), "\n";
EOF
cat > /etc/apache2/conf.d/monsite.conf << 'EOF'
<VirtualHost *:80>
    ServerName monsite.exemple.ca
    DocumentRoot /var/www/monsite
    <Directory /var/www/monsite>
        AllowOverride All
        Require all granted
    </Directory>
    ErrorLog /var/log/apache2/monsite.error.log
    CustomLog /var/log/apache2/monsite.access.log combined
</VirtualHost>
EOF
chown -R apache:apache /var/www/monsite
httpd -t && rc-service apache2 reload
Résultat attendu
Syntax OK
 * Reloading apache2 ... [ ok ]
openSUSECréer le site
mkdir -p /var/www/monsite
cat > /var/www/monsite/index.php << 'EOF'
<?php
echo 'PHP ', PHP_VERSION, ' (', php_sapi_name(), ') upload ', ini_get('upload_max_filesize'), ' memoire ', ini_get('memory_limit'), ' fuseau ', date_default_timezone_get(), "\n";
EOF
cat > /etc/apache2/vhosts.d/monsite.conf << 'EOF'
<VirtualHost *:80>
    ServerName monsite.exemple.ca
    DocumentRoot /var/www/monsite
    <Directory /var/www/monsite>
        AllowOverride All
        Require all granted
    </Directory>
    ErrorLog /var/log/apache2/monsite.error.log
    CustomLog /var/log/apache2/monsite.access.log combined
</VirtualHost>
EOF
chown -R wwwrun:www /var/www/monsite
apachectl configtest && systemctl reload apache2
Résultat attendu
Syntax OK
Tester la page témoin
curl -H 'Host: monsite.exemple.ca' http://127.0.0.1/
Résultat attendu
PHP 8.3.6 (apache2handler) upload 2M memoire 128M fuseau UTC
(Debian 13 : PHP 8.4.24)
Tester la page témoin
curl -H 'Host: monsite.exemple.ca' http://127.0.0.1/
Résultat attendu
PHP 8.3.33 (fpm-fcgi) upload 2M memoire 128M fuseau UTC
(CentOS Stream : PHP 8.3.19)
Tester la page témoin
curl -H 'Host: monsite.exemple.ca' http://127.0.0.1/
Résultat attendu
PHP 8.5.10 (fpm-fcgi) upload 2M memoire 128M fuseau UTC
Tester la page témoin
curl -H 'Host: monsite.exemple.ca' http://127.0.0.1/
Résultat attendu
PHP 8.4.25 (apache2handler) upload 2M memoire 128M fuseau UTC
Tester la page témoin
curl -H 'Host: monsite.exemple.ca' http://127.0.0.1/
Résultat attendu
PHP 8.4.24 (apache2handler) upload 2M memoire 128M fuseau UTC

Dans le navigateur, http://ADRESSE_IP/ affiche la même ligne. Les valeurs 2M, 128M et UTC sont celles de PHP par défaut : l'étape suivante les change.

5Régler PHP pour un site

Les valeurs par défaut conviennent à une page témoin, pas à un site : 2 Mo par fichier envoyé, 128 Mo de mémoire par script, fuseau UTC. Remplacez America/Toronto par votre fuseau horaire.

PHP étant un module d'Apache, c'est Apache qu'on redémarre pour qu'il relise ces réglages.

PHP passant par PHP-FPM, c'est PHP-FPM qu'on redémarre (redémarrer Apache ne suffirait pas).

PHP passant par PHP-FPM, c'est PHP-FPM qu'on redémarre (redémarrer Apache ne suffirait pas).

PHP étant un module d'Apache, c'est Apache qu'on redémarre pour qu'il relise ces réglages.

PHP étant un module d'Apache, c'est Apache qu'on redémarre pour qu'il relise ces réglages.

Ubuntu / DebianDéposer les réglages et redémarrer Apache
PHPV=$(php -r 'echo PHP_MAJOR_VERSION.".".PHP_MINOR_VERSION;')
cat > /etc/php/$PHPV/apache2/conf.d/90-monsite.ini << 'EOF'
upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 256M
date.timezone = America/Toronto
EOF
systemctl restart apache2
AlmaLinux / Rocky / CentOSDéposer les réglages et redémarrer PHP-FPM
cat > /etc/php.d/90-monsite.ini << 'EOF'
upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 256M
date.timezone = America/Toronto
EOF
systemctl restart php-fpm
FedoraDéposer les réglages et redémarrer PHP-FPM
cat > /etc/php.d/90-monsite.ini << 'EOF'
upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 256M
date.timezone = America/Toronto
EOF
systemctl restart php-fpm
AlpineDéposer les réglages et redémarrer Apache
cat > /etc/php84/conf.d/90-monsite.ini << 'EOF'
upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 256M
date.timezone = America/Toronto
EOF
rc-service apache2 restart
openSUSEDéposer les réglages et redémarrer Apache
cat > /etc/php8/conf.d/90-monsite.ini << 'EOF'
upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 256M
date.timezone = America/Toronto
EOF
systemctl restart apache2
Vérifier par la page témoin
curl -H 'Host: monsite.exemple.ca' http://127.0.0.1/
Résultat attendu
PHP 8.3.6 (apache2handler) upload 64M memoire 256M fuseau America/Toronto
(Debian 13 : PHP 8.4.24)
Vérifier par la page témoin
curl -H 'Host: monsite.exemple.ca' http://127.0.0.1/
Résultat attendu
PHP 8.3.33 (fpm-fcgi) upload 64M memoire 256M fuseau America/Toronto
(CentOS Stream : PHP 8.3.19)
Vérifier par la page témoin
curl -H 'Host: monsite.exemple.ca' http://127.0.0.1/
Résultat attendu
PHP 8.5.10 (fpm-fcgi) upload 64M memoire 256M fuseau America/Toronto
Vérifier par la page témoin
curl -H 'Host: monsite.exemple.ca' http://127.0.0.1/
Résultat attendu
PHP 8.4.25 (apache2handler) upload 64M memoire 256M fuseau America/Toronto
Vérifier par la page témoin
curl -H 'Host: monsite.exemple.ca' http://127.0.0.1/
Résultat attendu
PHP 8.4.24 (apache2handler) upload 64M memoire 256M fuseau America/Toronto

6Se servir d'un .htaccess

C'est la particularité d'Apache : un fichier .htaccess posé dans le dossier d'un site change sa configuration sans toucher à celle du serveur, à condition qu'AllowOverride All soit dans l'hôte virtuel (étape 4). WordPress s'en sert pour ses jolies URL, et vous pour protéger un fichier. L'exemple interdit l'accès à un fichier : Apache répond alors 403, sans qu'on ait rechargé quoi que ce soit.

Interdire un fichier avec un .htaccess
cat > /var/www/monsite/.htaccess << 'EOF'
<Files "prive.txt">
    Require all denied
</Files>
EOF
echo 'donnees privees' > /var/www/monsite/prive.txt
curl -o /dev/null -w '%{http_code}\n' -H 'Host: monsite.exemple.ca' http://127.0.0.1/prive.txt
Résultat attendu
403
(403 : Apache refuse le fichier grâce au .htaccess, appliqué aussitôt. Sans AllowOverride All, le fichier resterait accessible et le .htaccess serait ignoré)
Retirer l'exemple
rm /var/www/monsite/.htaccess /var/www/monsite/prive.txt

7Ouvrir le pare-feu

Le pare-feu laisse passer SSH, HTTP et HTTPS, et refuse le reste. Le détail est dans le tutoriel Configurer le pare-feu.

Activer le pare-feu (SSH reste autorisé) et ouvrir HTTP et HTTPS
apt install -y ufw && ufw allow 22/tcp && ufw allow 80/tcp && ufw allow 443/tcp && ufw --force enable
Résultat attendu
...
Firewall is active and enabled on system startup
Activer le pare-feu (SSH reste autorisé) et ouvrir HTTP et HTTPS
dnf install -y firewalld && systemctl enable --now firewalld && firewall-cmd --permanent --add-service=http --add-service=https && firewall-cmd --reload
Résultat attendu
...
success
success
Activer le pare-feu (SSH reste autorisé) et ouvrir HTTP et HTTPS
dnf install -y firewalld && systemctl enable --now firewalld && firewall-cmd --permanent --add-service=http --add-service=https && firewall-cmd --reload
Résultat attendu
...
success
success
Activer le pare-feu (SSH reste autorisé) et ouvrir HTTP et HTTPS
apk add ufw && ufw allow 22/tcp && ufw allow 80/tcp && ufw allow 443/tcp && ufw --force enable && rc-update add ufw default
Résultat attendu
...
Firewall is active and enabled on system startup
 * service ufw added to runlevel default
Activer le pare-feu (SSH reste autorisé) et ouvrir HTTP et HTTPS
systemctl enable --now firewalld && firewall-cmd --permanent --add-service=http --add-service=https && firewall-cmd --reload
Résultat attendu
success
success

8Passer en HTTPS avec Certbot

À faire quand votre nom de domaine pointe sur le serveur. Certbot obtient le certificat Let's Encrypt, réécrit l'hôte virtuel pour servir en HTTPS et le renouvelle tout seul. Le détail (vérifications, renouvellement selon le système, erreurs) est dans le tutoriel Installer un certificat Let's Encrypt avec Certbot.

Installer Certbot pour Apache
apt install -y certbot python3-certbot-apache
Installer Certbot pour Apache (dépôt EPEL)
dnf install -y epel-release && dnf install -y certbot python3-certbot-apache
Installer Certbot pour Apache
dnf install -y certbot python3-certbot-apache python3-pyparsing
Installer Certbot pour Apache
apk add certbot certbot-apache
Installer Certbot pour Apache
zypper -n install python313-certbot-apache
Demander le certificat et activer HTTPS sur le site
certbot --apache -d monsite.exemple.ca

Les commandes du quotidien

Vérifier la configuration puis recharger Apache
apachectl configtest && systemctl reload apache2
État du service
systemctl status apache2
Extensions PHP chargées
php -m
Suivre les erreurs du site en direct (Ctrl+C pour sortir)
tail -f /var/log/apache2/monsite.error.log
Vérifier la configuration puis recharger Apache
apachectl configtest && systemctl reload httpd
État du service (Apache et PHP-FPM)
systemctl status httpd php-fpm
Extensions PHP chargées
php -m
Suivre les erreurs du site en direct (Ctrl+C pour sortir)
tail -f /var/log/httpd/monsite.error.log
Vérifier la configuration puis recharger Apache
apachectl configtest && systemctl reload httpd
État du service (Apache et PHP-FPM)
systemctl status httpd php-fpm
Extensions PHP chargées
php -m
Suivre les erreurs du site en direct (Ctrl+C pour sortir)
tail -f /var/log/httpd/monsite.error.log
Vérifier la configuration puis recharger Apache
httpd -t && rc-service apache2 reload
État du service
rc-service apache2 status
Extensions PHP chargées
php84 -m
Suivre les erreurs du site en direct (Ctrl+C pour sortir)
tail -f /var/log/apache2/monsite.error.log
Vérifier la configuration puis recharger Apache
apachectl configtest && systemctl reload apache2
État du service
systemctl status apache2
Extensions PHP chargées
php -m
Suivre les erreurs du site en direct (Ctrl+C pour sortir)
tail -f /var/log/apache2/monsite.error.log
Apache et PHP en service

Apache sert votre site, PHP l'anime, un .htaccess protège vos fichiers, le pare-feu est ouvert et HTTPS tient en une commande. Pour la base de données, voyez Installer MySQL ou MariaDB ; pour comparer avec l'autre grand serveur web, Installer Nginx avec PHP-FPM.

Erreurs fréquentes

💬 Écrivez-nous sur Messenger !