apache2.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: e51792efe0f103ec8724ad199524d7543610c978 Maintainer: sammywg Status: ready -->
<sect1 xml:id="install.unix.apache2" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>Apache 2.x auf Unixsystemen</title>
 <para>
  Dieser Abschnitt enthält Hinweise und Tipps, die sich auf die Installation
  von PHP speziell für Apache 2.x auf Unixsystemen beziehen.
 </para>

 &warn.apache2.compat;

 <para>
  Die <link xlink:href="&url.apache2.docs;">Apache Dokumentation</link> ist
  die maßgebliche Informationsquelle für den Apache 2.x Server. Dort können
  weitere Informationen über Installationsoptionen für Apache gefunden
  werden.
 </para>

 <para>
  Die aktuellste Version des Apache HTTP Servers kann von der
  <link xlink:href="&url.apache;">Apache Download Site</link> bezogen werden,
  und eine passende PHP-Version von den oben angegebenen Quellen.
  Dieser Schnelleinstieg behandelt nur die Grundlagen, um mit Apache 2.x und
  PHP einzusteigen. Für mehr Informationen lesen Sie bitte die
  <link xlink:href="&url.apache2.docs;">Apache-Dokumentation</link>.
  Versionsnummern wurden hier ausgelassen, um sicherzustellen, dass die
  Anweisungen nicht inkorrekt sind. In den folgenden Beispielen sollte 'NN'
  durch die spezifische Version des verwendeten Apache ersetzt werden.
 </para>

 <para>
  Es gibt aktuell zwei Versionen von Apache 2.x: 2.4 und 2.2. Obwohl es
  verschiedene Gründe gibt, sich für eine zu entscheiden, ist 2.4 die
  aktuellste Version, und diejenige, die empfohlen wird, wenn sie diese
  Möglichkeit haben. Allerdings funktionieren die folgenden Anweisungen
  sowohl für 2.4 als auch 2.2. Es ist zu beachten, dass Apache httpd 2.2
  offiziell das Lebensende erreicht hat, so dass keine Weiterentwicklungen oder
  Fehlerkorrekturen mehr erfolgen werden.
 </para>

 <orderedlist>
  <listitem>
   <para>
    Beziehen Sie den Apache HTTP Server vom oben genannten Ort,
    und entpacken Sie ihn:
   </para>
   <informalexample>
    <screen>
<![CDATA[
tar -xzf httpd-2.x.NN.tar.gz
]]>
    </screen>
   </informalexample>
  </listitem>
  <listitem>
   <para>
    Beziehen und entpacken Sie die PHP-Quellen gleichermaßen:
   </para>
   <informalexample>
    <screen>
<![CDATA[
tar -xzf php-NN.tar.gz
]]>
    </screen>
   </informalexample>
  </listitem>

  <listitem>
   <para>
    Kompilieren und installieren Sie Apache. Entnehmen Sie der
    Apache-Installationsdokumentation weitere Details zur Kompilierung.
   </para>
   <informalexample>
    <screen>
<![CDATA[
cd httpd-2_x_NN
./configure --enable-so
make
make install
]]>
    </screen>
   </informalexample>
  </listitem>

  <listitem>
   <para>
    Nun steht Ihnen Apache 2.x.NN unter /usr/local/apache2 zur Verfügung,
    konfiguriert mit Unterstützung für nachladbare Module und dem
    Standard MPM Prefork. Um diese Installation zu testen, verwenden Sie die
    übliche Prozedur, den Apacheserver zu starten, also &zb;:
    <informalexample>
     <screen>
<![CDATA[
/usr/local/apache2/bin/apachectl start
]]>
     </screen>
    </informalexample>
    Stoppen Sie nun den Server, um mit der Konfiguration von PHP fortzufahren:
    <informalexample>
     <screen>
<![CDATA[
/usr/local/apache2/bin/apachectl stop
]]>
     </screen>
    </informalexample>
   </para>
  </listitem>

  <listitem>
   <para>
    Konfigurieren und kompilieren Sie nun Ihr PHP. Dies ist die Stelle, an der
    Sie Ihr PHP mit verschiedenen Optionen, wie etwa installierten
    Erweiterungen, anpassen können. Rufen Sie
    <command>./configure --help</command> auf, um eine Liste der verfügbaren
    Optionen zu erhalten. In unserem Beispiel werden wir eine einfache
    Konfiguration mit Unterstützung für Apache 2 und MySQL erzeugen.
   </para>
   <para>
    Wenn Sie Apache aus den Quelltexten kompiliert haben, wie oben beschrieben
    wurde, dann stimmt im folgenden Beispiel der Pfad von
    <command>apxs</command>, aber wenn Sie Apache auf andere Weise installiert
    haben, müssen Sie den Pfad von <command>apxs</command> entsprechend
    anpassen. Es ist zu beachten, dass einige Distros möglicherweise
    <command>apxs</command> zu <command>apxs2</command> umbenennen.
   </para>
   <informalexample>
    <screen>
<![CDATA[
cd ../php-NN
./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-pdo-mysql
make
make install
]]>
    </screen>
   </informalexample>
   <para>
    Wenn Sie sich entscheiden, Ihre Konfigurationsoptionen nach der
    Installation zu ändern, müssen Sie die Schritte
    <command>configure</command>, <command>make</command>, und
    <command>make install</command> erneut ausführen.
    Um das neue Modul nutzen zu können, muss Apache nur neu gestartet werden.
    Eine erneute Kompilierung des Apache ist nicht nötig.
   </para>
   <para>
    Beachten Sie, dass, wenn nicht anders erwähnt,
    <command>make install</command> ebenso PEAR und verschiedene PHP-Werkzeuge
    wie <link linkend="install.pecl.phpize">phpize</link>, PHP CLI und anderes
    installieren wird.
   </para>
  </listitem>

  <listitem>
   <para>
    Ihre <filename>php.ini</filename> einrichten
   </para>
   <informalexample>
    <screen>
<![CDATA[
cp php.ini-development /usr/local/lib/php.ini
]]>
    </screen>
   </informalexample>
   <para>
    Sie können Ihre <literal>.ini</literal>-Datei ändern, um verschiedene
    PHP-Optionen zu setzen. Wenn Sie die <filename>php.ini</filename>-Datei
    an einer anderen Stelle bevorzugen, verwenden Sie
    <literal>--with-config-file-path=/some/path</literal> in Schritt 5.
   </para>
   <para>
    Wenn Sie sich stattdessen für <filename>php.ini-production</filename>
    entscheiden, stellen Sie sicher, dass Sie die darin enthaltene Liste von
    Änderungen lesen, da diese das Verhalten von PHP beeinflussen.
   </para>
  </listitem>

  <listitem>
   <para>
    Bearbeiten Sie Ihre <filename>httpd.conf</filename>, um das PHP Modul zu
    laden. Der Pfad auf der rechten Seite der Anweisung
    <literal>LoadModule</literal> muss auf den Ort des PHP-Moduls auf Ihrem
    System zeigen. Das obige <command>make install</command> könnte dies
    bereits für Sie hinzugefügt haben, aber Stellen Sie sicher, dass dies der
    Fall ist.
   </para>
   <informalexample>
    <para>
     Für PHP 8:
    </para>
    <programlisting role="apache-conf">
<![CDATA[
LoadModule php_module modules/libphp.so
]]>
    </programlisting>
   </informalexample>

   <informalexample>
    <para>
     Für PHP 7:
    </para>
    <programlisting role="apache-conf">
<![CDATA[
LoadModule php7_module modules/libphp7.so
]]>
    </programlisting>
   </informalexample>
  </listitem>

  <listitem>
   <para>
    Weisen Sie Apache an, bestimmte Dateiendungen als PHP Skripte zu behandeln.
    Zum Beispiel werden wir den Apache Dateien mit der Endung
    <literal>.php</literal> als PHP ausführen lassen. Anstatt nur die
    Apache-Direktive <literal>AddType</literal> zu verwenden, wollen wir
    zusätzlich verhindern, dass potentiell gefährliche hochgeladene und
    erzeugte Dateien wie <filename>exploit.php.jpg</filename> als PHP-Dateien
    ausgeführt werden. Wenn Sie dieses Beispiel verwenden, können Sie jede
    Dateiendung als PHP interpretieren lassen, wenn Sie sie einfach hinzufügen.
    Wir demonstrieren dies, indem wir <literal>.php</literal> einfügen.
   </para>
   <informalexample>
    <programlisting role="apache-conf">
<![CDATA[
<FilesMatch \.php$>
    SetHandler application/x-httpd-php
</FilesMatch>
]]>
    </programlisting>
   </informalexample>
   <para>
    Oder wenn wir erlauben wollen, dass nur Dateien mit den Endungen
    <literal>.php</literal>, <literal>.php2</literal>, <literal>.php3</literal>,
    <literal>.php4</literal>, <literal>.php5</literal>, <literal>.php6</literal>
    und <literal>.phtml</literal> als PHP interpretiert werden können, verwenden
    wir ein Statement wie dieses:
   </para>
   <informalexample>
    <programlisting role="apache-conf">
<![CDATA[
<FilesMatch "\.ph(p[2-6]?|tml)$">
    SetHandler application/x-httpd-php
</FilesMatch>
]]>
    </programlisting>
   </informalexample>
   <para>
    Und um zu erlauben, dass <literal>.phps</literal>-Dateien vom PHP
    Source-Filter verarbeitet und als Quellcode mit Syntax-Highlighting
    angezeigt werden, verwenden Sie:
   </para>
   <informalexample>
    <programlisting role="apache-conf">
<![CDATA[
<FilesMatch "\.phps$">
    SetHandler application/x-httpd-php-source
</FilesMatch>
]]>
    </programlisting>
   </informalexample>
   <para>
    <literal>mod_rewrite</literal> kann verwendet werden, um zu erlauben, dass
    jede beliebige <literal>.php</literal>-Datei als Quellcode mit
    Syntax-Highlighting angezeigt wird, ohne dass Sie die Datei zu
    <literal>.phps</literal> umbenennen oder kopieren müssen:
   </para>
   <informalexample>
    <programlisting role="apache-conf">
<![CDATA[
RewriteEngine On
RewriteRule (.*\.php)s$ $1 [H=application/x-httpd-php-source]
]]>
    </programlisting>
   </informalexample>
   <para>
    Der PHP-Source-Filter sollte auf Produktionssystemen nicht aktiviert werden,
    da er vertrauliche oder anderweitig sensible Informationen, die im Quellcode
    enthalten sind, preisgeben könnte.
   </para>
  </listitem>

  <listitem>
   <para>
    Verwenden Sie die übliche Prozedur, um den Apache-Server zu starten, &zb;:
   </para>
   <informalexample>
    <screen>
<![CDATA[
/usr/local/apache2/bin/apachectl start
]]>
    </screen>
   </informalexample>

   <para>ODER</para>
   <informalexample>
    <screen>
<![CDATA[
service httpd restart
]]>
    </screen>
   </informalexample>
  </listitem>
 </orderedlist>

 <para>
  Wenn Sie den obigen Anweisungen folgen, werden Sie einen laufenden
  Apache2 mit Unterstützung für PHP als <literal>SAPI</literal>-Modul
  erhalten. Natürlich existieren für Apache und PHP viele weitere
  Konfigurationseinstellungen. Verwenden Sie
  <command>./configure --help</command> im jeweiligen Quellcodeverzeichnis,
  um weitere Informationen zu erhalten.
 </para>
 <para>
  Apache2 kann multithreaded kompiliert werden, indem das
  <filename>worker</filename>-MPM anstatt des standardmäßigen
  <filename>prefork</filename>-MPM für den Build gewählt wird. Dies erfolgt,
  indem die folgende Option zu dem Argument, das weiter oben in Schritt 3 an
  <command>./configure</command> übergeben wird, hinzugefügt wird:
 </para>
 <informalexample>
  <screen>
<![CDATA[
--with-mpm=worker
]]>
  </screen>
 </informalexample>
 <para>
  Dies sollte nicht durchgeführt werden, ohne sich der Konsequenzen dieser
  Entscheidung bewusst zu sein, und zumindest eine angemesse Kenntnis der
  Implikationen zu haben. Die Apache-Dokumentation bezüglich der
  <link xlink:href="&url.apache2.mpm;">MPM-Module</link> erörtert MPMs sehr
  ausführlich.
 </para>
 <note>
  <para>
   Das <link linkend="faq.installation.apache.multiviews">Apache MultiViews FAQ</link>
   erörtert die Verwendung von Multiviews mit PHP.
  </para>
 </note>
 <note>
  <para>
   Um eine Multithreaded-Version von Apache zu erzeugen, muss das Zielsystem
   Threads unterstützen. In diesem Fall sollte auch PHP mit der Zend Thread
   Safety (ZTS) kompiliert werden. Unter dieser Konfiguration sind nicht alle
   Erweiterungen verfügbar. Die empfohlene Einstellung ist es, Apache mit dem
   standardmäßigen <filename>prefork</filename>-MPM-Modul zu bauen.
  </para>
 </note>
</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
-->