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
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
apt update && apt upgrade -y... 212 upgraded, 8 newly installed, 0 to remove and 4 not upgraded. (les nombres dépendent de l'âge de l'image)
dnf upgrade -y... Complete!
dnf upgrade -y... Complete!
apk update && apk upgrade && reboot... 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.
zypper -n refresh && zypper -n updateAll 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.
apt install -y apache2 php libapache2-mod-php php-mysql php-curl php-gd php-mbstring php-xml php-zip php-intl... Setting up libapache2-mod-php8.3 ... Setting up apache2 ... (php8.4 sur Debian 13 ; Apache démarre tout seul)
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... 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)
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... 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)
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... * service apache2 added to runlevel default * Starting apache2 ... [ ok ] (php84-apache2 est le module PHP pour Apache ; curl sert aux vérifications)
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... 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.
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.phpPHP 8.3.6 via apache2handler
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.phpPHP 8.3.33 via fpm-fcgi
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.phpPHP 8.5.10 via fpm-fcgi
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.phpPHP 8.4.25 via apache2handler
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.phpPHP 8.4.24 via apache2handler
apache2 -v && php -v | head -1Server 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)
httpd -v && php -v | head -1Server 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)
httpd -v && php -v | head -1Server 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)
httpd -v && php84 -v | head -1Server 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)
httpd -v && php -v | head -1Server 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.
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 apache2Enabling site monsite. Site 000-default disabled. Syntax OK (le rechargement applique le nouveau 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 httpdSyntax OK
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 httpdSyntax OK
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 reloadSyntax OK * Reloading apache2 ... [ ok ]
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 apache2Syntax OK
curl -H 'Host: monsite.exemple.ca' http://127.0.0.1/PHP 8.3.6 (apache2handler) upload 2M memoire 128M fuseau UTC (Debian 13 : PHP 8.4.24)
curl -H 'Host: monsite.exemple.ca' http://127.0.0.1/PHP 8.3.33 (fpm-fcgi) upload 2M memoire 128M fuseau UTC (CentOS Stream : PHP 8.3.19)
curl -H 'Host: monsite.exemple.ca' http://127.0.0.1/PHP 8.5.10 (fpm-fcgi) upload 2M memoire 128M fuseau UTC
curl -H 'Host: monsite.exemple.ca' http://127.0.0.1/PHP 8.4.25 (apache2handler) upload 2M memoire 128M fuseau UTC
curl -H 'Host: monsite.exemple.ca' http://127.0.0.1/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.
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 apache2cat > /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-fpmcat > /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-fpmcat > /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 restartcat > /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 apache2curl -H 'Host: monsite.exemple.ca' http://127.0.0.1/PHP 8.3.6 (apache2handler) upload 64M memoire 256M fuseau America/Toronto (Debian 13 : PHP 8.4.24)
curl -H 'Host: monsite.exemple.ca' http://127.0.0.1/PHP 8.3.33 (fpm-fcgi) upload 64M memoire 256M fuseau America/Toronto (CentOS Stream : PHP 8.3.19)
curl -H 'Host: monsite.exemple.ca' http://127.0.0.1/PHP 8.5.10 (fpm-fcgi) upload 64M memoire 256M fuseau America/Toronto
curl -H 'Host: monsite.exemple.ca' http://127.0.0.1/PHP 8.4.25 (apache2handler) upload 64M memoire 256M fuseau America/Toronto
curl -H 'Host: monsite.exemple.ca' http://127.0.0.1/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.
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.txt403 (403 : Apache refuse le fichier grâce au .htaccess, appliqué aussitôt. Sans AllowOverride All, le fichier resterait accessible et le .htaccess serait ignoré)
rm /var/www/monsite/.htaccess /var/www/monsite/prive.txt7Ouvrir 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.
apt install -y ufw && ufw allow 22/tcp && ufw allow 80/tcp && ufw allow 443/tcp && ufw --force enable... Firewall is active and enabled on system startup
dnf install -y firewalld && systemctl enable --now firewalld && firewall-cmd --permanent --add-service=http --add-service=https && firewall-cmd --reload... success success
dnf install -y firewalld && systemctl enable --now firewalld && firewall-cmd --permanent --add-service=http --add-service=https && firewall-cmd --reload... success success
apk add ufw && ufw allow 22/tcp && ufw allow 80/tcp && ufw allow 443/tcp && ufw --force enable && rc-update add ufw default... Firewall is active and enabled on system startup * service ufw added to runlevel default
systemctl enable --now firewalld && firewall-cmd --permanent --add-service=http --add-service=https && firewall-cmd --reloadsuccess 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.
apt install -y certbot python3-certbot-apachednf install -y epel-release && dnf install -y certbot python3-certbot-apachednf install -y certbot python3-certbot-apache python3-pyparsingapk add certbot certbot-apachezypper -n install python313-certbot-apachecertbot --apache -d monsite.exemple.caLes commandes du quotidien
apachectl configtest && systemctl reload apache2systemctl status apache2php -mtail -f /var/log/apache2/monsite.error.logapachectl configtest && systemctl reload httpdsystemctl status httpd php-fpmphp -mtail -f /var/log/httpd/monsite.error.logapachectl configtest && systemctl reload httpdsystemctl status httpd php-fpmphp -mtail -f /var/log/httpd/monsite.error.loghttpd -t && rc-service apache2 reloadrc-service apache2 statusphp84 -mtail -f /var/log/apache2/monsite.error.logapachectl configtest && systemctl reload apache2systemctl status apache2php -mtail -f /var/log/apache2/monsite.error.logApache 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
L'image du serveur a été construite sur un autre disque et GRUB demande où se réinstaller : choisissez le disque de la machine (celui que lsblk affiche, en général /dev/sda) ; la mise à jour continue ensuite.
Apache n'a pas de module PHP branché, ou il n'a pas été rechargé après l'installation : il sert le fichier tel quel. Sur Ubuntu, Debian, Alpine et openSUSE, vérifiez que le module PHP est chargé (mod_php) ; sur openSUSE, il faut a2enmod php8 (étape 2). Sur AlmaLinux, Rocky, CentOS et Fedora, c'est PHP-FPM qui manque : vérifiez qu'il tourne.
Apache passe par PHP-FPM (fpm-fcgi) et PHP-FPM est arrêté : le journal du site dit « (2)No such file or directory: ... AH01079: failed to make connection to backend ». Redémarrez-le avec systemctl restart php-fpm. Sur Ubuntu, Debian, Alpine et openSUSE ce cas n'existe pas : PHP est dans Apache, il n'y a pas de service séparé.
L'hôte virtuel n'a pas AllowOverride All pour ce dossier (étape 4) : Apache lit les .htaccess seulement là où c'est autorisé. Sans cela, la règle de l'étape 6 ne bloque rien. Après avoir ajouté AllowOverride All, rechargez Apache.
SELinux : hors de /var/www, les fichiers n'ont pas l'étiquette web et Apache ne peut pas les lire (journal : « (13)Permission denied »). C'est le cas quand SELinux est en mode Enforcing (Rocky et CentOS le sont d'origine ; les images AlmaLinux et Fedora sont en Permissive et laissent passer). Gardez le site sous /var/www, ou étiquetez son dossier : semanage fcontext -a -t httpd_sys_content_t '/srv/monsite(/.*)?' && restorecon -R /srv/monsite.
Apache ne connaît pas son propre nom : c'est un avertissement, pas une erreur, il démarre quand même. Il disparaît dès que vous avez un hôte virtuel avec ServerName (étape 4), ou en posant ServerName dans la configuration principale.
Le fichier .ini a été déposé dans le mauvais dossier, ou Apache n'a pas redémarré. Le module Apache lit /etc/php/VERSION/apache2/conf.d, pas /etc/php/VERSION/cli/conf.d (la ligne de commande) : vérifiez le chemin de l'étape 5, puis systemctl restart apache2.