debian.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 4cb53ecbd763db2db808e90d7eda63afb380e6df Maintainer: wiesemann Status: ready -->
<!-- Reviewed: yes -->
<!-- Rev-Revision: f8682cd86a71640bf8771186d1d40881c7a0295e Reviewer: samesch -->
<sect1 xml:id="install.unix.debian" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>Installation von Paketen unter Debian GNU/Linux und verwandten Distributionen</title>
 <para>
  PHP kann nicht nur aus dem Quellcode installiert werden, sondern ist auch
  über Pakete von <link xlink:href="&url.debian;">Debian GNU/Linux</link>
  verfügbar. Dies gilt auch für andere auf Debian basierende Distributionen wie
  Ubuntu, Kali Linux und Linux Mint.
 </para>
 &warn.install.third-party-support;
 <para>
  Die Pakete können mit den Befehlen <command>apt</command> oder
  <command>aptitude</command> installiert werden. Auf dieser Handbuchseite
  werden beide Befehle synonym verwendet.
 </para>
 <sect2 xml:id="install.unix.debian.apt">
  <title>Die Verwendung von APT</title>
  <simpara>
   Zunächst ist zu beachten, dass möglicherweise andere zugehörige Pakete
   gewünscht werden, wie <literal>libapache-mod-php</literal> für die
   Integration mit Apache 2, und <literal>php-pear</literal> für PEAR.
  </simpara>
  <simpara>
   Außerdem sollten vor der Installation eines Pakets sichergestellt werden,
   dass die Paketliste auf dem aktuellen Stand ist. Üblicherweise kann dies
   durch das Kommando <command>apt update</command> erledigt werden.
  </simpara>
  <example xml:id="install.unix.debian.apt.example">
   <title>Beispiel einer Debian-Installation mit Apache 2</title>
   <programlisting role="shell">
<![CDATA[
# apt install php-common libapache2-mod-php php-cli
]]>
   </programlisting>
  </example>
  <simpara>
   APT wird automatisch das PHP-Modul für Apache 2 sowie alle seine
   Abhängigkeiten installieren und danach aktivieren. Damit die Änderungen in
   Kraft treten, muss Apache neu gestart werden. Zum Beispiel:
  </simpara>
  <example xml:id="install.unix.debian.apt.example2">
   <title>Stoppen und Starten von Apache nach der Installation von PHP</title>
   <programlisting role="shell">
<![CDATA[
# /etc/init.d/apache2 stop
# /etc/init.d/apache2 start
]]>
   </programlisting>
  </example>
 </sect2>
 <sect2 xml:id="install.unix.debian.config">
  <title>Bessere Kontrolle über die Konfiguration</title>
  <simpara>
   Im letzten Abschnitt wurde PHP nur mit den Basismodulen installiert. In den
   meisten Fällen werden weitere Module wie
   <link linkend="book.mysql">MySQL</link>,
   <link linkend="book.curl">cURL</link> oder
   <link linkend="book.image">GD</link> gewünscht. Auch diese Module können
   mit dem Befehl <command>apt</command> installiert werden.
  </simpara>
  <example xml:id="install.unix.debian.config.example">
   <title>Methoden zur Anzeige weiterer PHP-Pakete</title>
   <programlisting role="shell">
<![CDATA[
# apt-cache search php
# apt search php | grep -i mysql
# aptitude search php
]]>
   </programlisting>
  </example>
  <simpara>
   Die Paketliste enthält eine große Anzahl von Paketen, darunter grundlegende
   PHP-Komponenten wie <literal>php-cgi</literal>, <literal>php-cli</literal>
   und <literal>php-dev</literal> sowie viele PHP-Erweiterungen. Wenn
   Erweiterungen installiert werden, werden bei Bedarf automatisch zusätzliche
   Pakete installiert, um die Abhängigkeiten dieser Pakete zu erfüllen.
  </simpara>
  <example xml:id="install.unix.debian.config.example2">
   <title>PHP mit MySQL und cURL installieren</title>
   <programlisting role="shell">
<![CDATA[
# apt install php-mysql php-curl
]]>
   </programlisting>
  </example>
  <simpara>
   APT fügt die entsprechenden Zeilen automatisch in die verschiedenen zur
   &php.ini; gehörenden Dateien wie <filename>/etc/php/7.4/php.ini</filename>,
   <filename>/etc/php/7.4/conf.d/*.ini</filename> etc. ein. Abhängig von der
   Erweiterung wird es Einträge ähnlich wie
   <literal>extension=foo.so</literal> hinzufügen. Das Neustarten des
   Web-Servers (&zb; Apache) ist erforderlich, damit die Änderungen wirksam
   werden.
  </simpara>
 </sect2>
 <sect2 xml:id="install.unix.debian.faq">
  <title>Bekannte Probleme</title>
  <itemizedlist>
   <listitem>
    <simpara>
     Wenn die PHP-Skripte nicht vom Web-Server geparst werden, ist es
     wahrscheinlich, dass PHP nicht zur Konfigurationsdatei des Web-Servers
     hinzugefügt wurde. Unter Debian ist dies meist
     <filename>/etc/apache2/apache2.conf</filename> (oder ähnlich). Im
     Debian-Handbuch finden Sie weitere Details hierzu.
    </simpara>
   </listitem>
   <listitem>
    <simpara>
     Falls eine Erweiterung anscheinend installiert wurde, aber die Funktionen
     nicht definiert sind, müssen Sie sicherstellen, dass die entsprechede
     INI-Datei geladen wurde und/oder dass der Web-Server nach der
     Installation neu gestartet wurde.
    </simpara>
   </listitem>
  </itemizedlist>
 </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
-->