doc-fr/install/windows/apache2.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 2871f7103c7cfcfd95db64eb0930085965fd9330 Maintainer: Fan2Shrek Status: ready -->
<!-- Reviewed: yes -->
<sect1 xml:id="install.windows.apache2" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>Installation for Apache 2.x on Windows systems</title>
 <para>
  Cette section contient des notes et des astuces spécifiques aux installations
  d'Apache 2.x de PHP sur les systèmes Microsoft Windows.
 </para>
 <note>
  <para>
   Veuillez lire d'abord les <link linkend="install.windows.manual">étapes
   d'installation manuelle</link> !
  </para>
 </note>

 <para>
  Il est fortement recommandé de consulter la
  <link xlink:href="&url.apache2.docs;">documentation d'Apache</link>
   pour obtenir une compréhension de base du serveur Apache 2.x.
   Considérez également la lecture des
   <link xlink:href="&url.apache2.windows;">notes spécifiques à Windows</link>
   pour Apache 2.x avant de continuer ici.
 </para>

 <para>
  Téléchargez la version la plus récente de
  <link xlink:href="&url.apachelounge.download;">Apache 2.x</link>
  et une version PHP correspondante. Suivez les
  <link linkend="install.windows.manual">étapes d'installation manuelle</link>
  et revenez pour continuer avec l'intégration de PHP et Apache.
 </para>

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

 &note.apache.slashes;

 <sect2 xml:id="install.windows.apache2.module">
  <title>Installation en tant que gestionnaire Apache</title>
  <note>
   <simpara>
    Lors de l'utilisation de l'interface SAPI apache2handler, la version Thread Safe (TS) de
    PHP doit être utilisée.
   </simpara>
  </note>
  <para>
   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 :
   <example>
    <title>PHP en tant que gestionnaire Apache 2.x</title>
    <programlisting role="apache-conf">
<![CDATA[
# Avant PHP 8.0.0 the 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"
]]>
    </programlisting>
   </example>
  </para>
  <note>
   <simpara>
    Le chemin réel vers PHP doit être substitué à la place de
    <filename>C:/php/</filename> dans les exemples ci-dessus.
    Assurez-vous que le fichier référencé dans la directive <literal>LoadModule</literal> est à
    l'emplacement spécifié. Utilisez <filename>php7apache2_4.dll</filename>
    pour PHP 7, ou <filename>php8apache2_4.dll</filename> pour PHP 8.
   </simpara>
  </note>
 </sect2>

 <sect2 xml:id="install.windows.apache2.cgi">
  <title>Exécution de PHP en tant que CGI</title>

  <para>
   Il est fortement recommandé de consulter la
   <link xlink:href="&url.apache.cgi;">documentation d'Apache CGI</link>
   pour une compréhension plus complète de l'exécution de CGI sur Apache.
  </para>

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

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

   <example>
    <title>PHP et Apache 2.x en tant que CGI</title>
    <programlisting>
<![CDATA[
#!C:/php/php.exe
<?php
  phpinfo();
?>
]]>
    </programlisting>
   </example>
  </para>
  &warn.install.cgi;
 </sect2>

 <sect2 xml:id="install.windows.apache2.fastcgi">
  <title>Exécution de PHP en tant que FastCGI</title>

  <para>
   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 :
  </para>
  <para>
   Obtenez <literal>mod_fcgid</literal> depuis
   <link xlink:href="&url.apachelounge.download;">&url.apachelounge;</link>.
   Les binaires Win32 sont disponibles en téléchargement sur ce site.
   Installez le module selon les instructions qui l'accompagneront.
  </para>
  <para>
   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 :

   <example>
    <title>Configurer Apache pour executer PHP en tant que FastCGI</title>
    <programlisting>
<![CDATA[
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
]]>
    </programlisting>
   </example>

   Les fichiers avec une extension <literal>.php</literal> seront maintenant exécutés par l'enveloppe
   PHP FastCGI.
  </para>
 </sect2>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->