Installation pour Apache 2.x sur les systèmes Windows

Cette section contient des notes et des astuces spécifiques aux installations d'Apache 2.x de PHP sur les systèmes Microsoft Windows.

Note:
Il convient de lire d'abord les étapes d'installation manuelle !

Il est fortement recommandé de consulter la » documentation d'Apache pour obtenir une compréhension de base du serveur Apache 2.x. Il est également recommandé de lire les » notes spécifiques à Windows pour Apache 2.x avant de continuer ici.

Télécharger la version la plus récente de » Apache 2.x et une version PHP correspondante. Suivre les étapes d'installation manuelle et revenir pour continuer avec l'intégration de PHP et Apache.

Il y a trois façons de configurer PHP pour fonctionner avec Apache 2.x sur Windows. PHP peut être exécuté en tant que gestionnaire, en tant que CGI, ou sous FastCGI.

Note: Souvenez-vous que lorsque vous ajoutez des valeurs représentants un chemin dans la configuration d'Apache sous Windows, tous les antislash, comme c:\repertoire\fichier.ext, devraient être convertis en slashes, comme c:/repertoire/fichier.ext. Un slash final peut également être nécessaire pour les dossiers.

Installation en tant que gestionnaire Apache

Note: Lors de l'utilisation de l'interface SAPI apache2handler, la version Thread Safe (TS) de PHP doit être utilisée.

Pour charger le module PHP pour Apache 2.x, les lignes suivantes dans le fichier de configuration Apache httpd.conf doivent être insérées :

Exemple #1 PHP en tant que gestionnaire Apache 2.x

# Avant PHP 8.0.0 le nom du module était php7_module
LoadModule php_module "c:/php/php8apache2_4.dll"
<FilesMatch \.php$>
    SetHandler application/x-httpd-php
</FilesMatch>
# configurer le chemin du php.ini
PHPIniDir "C:/php"

Note: Le chemin réel vers PHP doit être substitué à la place de C:/php/ dans les exemples ci-dessus. Il faut s'assurer que le fichier référencé dans la directive LoadModule est à l'emplacement spécifié. Utiliser php7apache2_4.dll pour PHP 7, ou php8apache2_4.dll pour PHP 8.

Exécution de PHP en tant que CGI

Il est fortement recommandé de consulter la » documentation d'Apache CGI pour une compréhension plus complète de l'exécution de CGI sur Apache.

Pour exécuter PHP en tant que CGI, les fichiers php-cgi devront être placés dans un répertoire désigné comme répertoire CGI en utilisant la directive ScriptAlias.

Une ligne #! devra être placée dans les fichiers PHP, qui pointent vers l'emplacement du binaire PHP :

Exemple #2 PHP et Apache 2.x en tant que CGI

#!C:/php/php.exe
<?php
  phpinfo();
?>

Avertissement

Un serveur déployé en mode CGI s'expose à plusieurs vulnérabilités possibles. Veuillez lire notre section sur la sécurité en mode CGI pour apprendre comment vous protéger contre ces attaques.

Exécution de PHP en tant que FastCGI

Exécuter PHP sous FastCGI présente un certain nombre d'avantages par rapport à l'exécution en tant que CGI. La configuration est assez simple :

Obtenir mod_fcgid depuis » https://www.apachelounge.com. Les binaires Win32 sont disponibles en téléchargement sur ce site. Installer le module selon les instructions qui l'accompagneront.

Configurer le serveur web comme indiqué ci-dessous, en prenant soin d'ajuster les chemins pour refléter comment c'est installé dans le système :

Exemple #3 Configurer Apache pour exécuter PHP en tant que FastCGI

LoadModule fcgid_module modules/mod_fcgid.so
# Où est le fichier php.ini ?
FcgidInitialEnv PHPRC        "c:/php"
<FilesMatch \.php$>
    SetHandler fcgid-script
</FilesMatch>
FcgidWrapper "c:/php/php-cgi.exe" .php

Les fichiers avec une extension .php seront maintenant exécutés par l'enveloppe PHP FastCGI.