archived-doc-de/install/windows/apache2.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2871f7103c7cfcfd95db64eb0930085965fd9330 Maintainer: samesch Status: ready -->
<!-- Reviewed: no -->
<sect1 xml:id="install.windows.apache2" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>Installation für Apache 2.x auf Windows-Systemen</title>
 <para>
  Dieser Abschnitt enthält Hinweise und Tipps zur Installation von Apache 2.x
  mit PHP unter Microsoft Windows.
 </para>
 <note>
  <para>
   Bitte lesen Sie zuerst die
   <link linkend="install.windows.manual">Installationsanweisungen für PHP unter Windows</link>!
  </para>
 </note>

 <para>
  Es wird außerdem dringend empfohlen, die
  <link xlink:href="&url.apache2.docs;">Apache-Dokumentation</link> zu lesen,
  um ein grundlegendes Verständnis des Apache 2.x Servers zu bekommen. Lesen
  Sie auch die
  <link xlink:href="&url.apache2.windows;">Windows-spezifischen Hinweise</link>
  für Apache 2.x, bevor Sie hier weiterlesen.
 </para>

 <para>
  Laden Sie die neueste Version von
  <link xlink:href="&url.apachelounge.download;">Apache 2.x</link> und eine
  passende PHP-Version herunter. Folgen Sie den
  <link linkend="install.windows.manual">Installationsanweisungen für PHP unter Windows</link>
  und kommen Sie zurück, um mit der Integration von PHP und Apache fortzufahren.
 </para>

 <para>
  Es gibt drei Möglichkeiten, PHP für die Nutzung mit Apache 2.x unter Windows
  einzurichten. PHP kann als Handler, als CGI oder unter FastCGI ausgeführt
  werden.
 </para>

 &note.apache.slashes;

 <sect2 xml:id="install.windows.apache2.module">
  <title>Installation als Apache-Handler</title>
  <note>
   <simpara>
    Bei Verwendung der SAPI apache2handler muss die threadsichere (Thread Safe,
    TS) Version von PHP verwendet werden.
   </simpara>
  </note>
  <para>
   Um das PHP-Modul für Apache 2.x zu laden, müssen die folgenden Zeilen in
   die Apache-Konfigurationsdatei &httpd.conf; eingefügt werden:
   <example>
    <title>PHP und Apache 2.x als Handler</title>
    <programlisting role="apache-conf">
<![CDATA[
# vor PHP 8.0.0 war der Name des Moduls php7_module
LoadModule php_module "c:/php/php8apache2_4.dll"
<FilesMatch \.php$>
    SetHandler application/x-httpd-php
</FilesMatch>
# Konfigurieren des Pfades zur php.ini
PHPIniDir "C:/php"
]]>
    </programlisting>
   </example>
  </para>
  <note>
   <simpara>
    Statt <filename>C:/php/</filename> muss im obigen Beispiel der
    tatsächliche Pfad zu PHP angegeben werden. Stellen Sie sicher, dass sich
    die Datei, auf die in der <literal>LoadModule</literal>-Direktive
    verwiesen wird, am angegebenen Ort befindet. Verwenden Sie für PHP 7
    <filename>php7apache2_4.dll</filename> und für PHP 8
    <filename>php8apache2_4.dll</filename>.
   </simpara>
  </note>
 </sect2>

 <sect2 xml:id="install.windows.apache2.cgi">
  <title>PHP als CGI ausführen</title>

  <para>
   Es wird dringend empfohlen, die
   <link xlink:href="&url.apache.cgi;">Apache CGI-Dokumentation</link> zu
   konsultieren, um ein umfassenderes Verständnis für die Ausführung von CGI
   unter Apache zu bekommen.
  </para>

  <para>
   Um PHP als CGI laufen zu lassen, müssen die php-cgi-Dateien in einem
   Verzeichnis abgelegt werden, das mit der ScriptAlias-Direktive als
   CGI-Verzeichnis gekennzeichnet ist.
  </para>

  <para>
   In den PHP-Dateien muss eine <literal>#!</literal>-Zeile eingefügt werden,
   die auf den Speicherort des PHP-Programms verweist:

   <example>
    <title>PHP und Apache 2.x als 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>PHP unter FastCGI ausführen</title>

  <para>
   PHP unter FastCGI laufen zu lassen hat eine Reihe von Vorteilen gegenüber
   der Ausführung als CGI. Die Einrichtung ist ziemlich einfach:
  </para>
  <para>
   Sie finden <literal>mod_fcgid</literal> auf
   <link xlink:href="&url.apachelounge.download;">&url.apachelounge;</link>.
   Die Win32-Binärdateien können von dieser Website heruntergeladen werden.
   Installieren Sie das Modul gemäß den Anweisungen, die Sie mit dem Modul
   erhalten.
  </para>
  <para>
   Konfigurieren Sie den Webserver wie im Folgenden gezeigt und passen Sie
   dabei die Pfade entsprechend der Installation auf dem System an:

   <example>
    <title>Apache für die Ausführung von PHP als FastCGI konfigurieren</title>
    <programlisting>
<![CDATA[
LoadModule fcgid_module modules/mod_fcgid.so
# Wo befindet sich die php.ini-Datei?
FcgidInitialEnv PHPRC        "c:/php"
<FilesMatch \.php$>
    SetHandler fcgid-script
</FilesMatch>
FcgidWrapper "c:/php/php-cgi.exe" .php
]]>
    </programlisting>
   </example>

   Dateien mit der Erweiterung <literal>.php</literal> werden nun vom PHP
   FastCGI-Wrapper ausgeführt.
  </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
-->