Skip to content

Commit

Permalink
Sync with EN
Browse files Browse the repository at this point in the history
  • Loading branch information
@msamesch
msamesch committed Oct 2, 2024
1 parent f56948b commit a819818
Show file tree
Hide file tree
Showing 8 changed files with 982 additions and 224 deletions.
38 changes: 33 additions & 5 deletions faq/installation.xml
View file
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 8e732e84a1425cf0ab3a5b0da8fe113c7a6da85e Maintainer: samesch Status: ready -->
<!-- EN-Revision: 2dbf3d9064d4cb07f0a2f7d06641c877a2e5ed24 Maintainer: samesch Status: ready -->
<chapter xml:id="faq.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Installation</title>
<titleabbrev>Installation</titleabbrev>
Expand Down Expand Up @@ -60,7 +60,7 @@
<filename>&lt;install-path&gt;/lib</filename> ist. Die Meisten werden
das beim Übersetzen mit der Option
<link linkend="configure.with-config-file-path">--with-config-file-path</link>
ändern wollen. Sie können das z. B. mit
ändern wollen. Sie können das &zb; mit
<programlisting role="shell">
--with-config-file-path=/etc
</programlisting>
Expand All @@ -75,7 +75,7 @@
<para>
Unter Windows ist der standardmäßige Pfad für die &php.ini; das
Windows-Verzeichnis. Falls die den Apache Webserver verwenden, wird die
&php.ini; zuerst im Apache-Installationsverzeichnis, z. B.
&php.ini; zuerst im Apache-Installationsverzeichnis, &zb;
<filename>c:\program files\apache group\apache</filename>, gesucht.
Dadurch können Sie auf demselben Rechner verschiedene &php.ini;-Dateien
für verschiedene Apache-Versionen haben.
Expand Down Expand Up @@ -474,7 +474,7 @@ cgi error:
<listitem>
<para>
Geben Sie Ihr PHP-Verzeichnis mit vorangestelltem ';' am Ende ein
(z. B. <literal>;C:\php</literal>)
(&zb; <literal>;C:\php</literal>)
</para>
</listitem>
<listitem>
Expand Down Expand Up @@ -509,6 +509,34 @@ cgi error:
</answer>
</qandaentry>

<qandaentry xml:id="faq.installation.windows-temporary-path">
<question>
<simpara>
Windows: Wie kann ich überprüfen, ob PHP unter IIS in das temporäre
Verzeichnis schreiben kann?
</simpara>
</question>
<answer>
<procedure>
<step>
<simpara>
Klicken Sie im Datei-Explorer mit der rechten Maustaste auf das
temporäre Verzeichnis (<varname>%TEMP%</varname>), um die
Berechtigungen zu überprüfen.
Das temporäre Verzeichnis kann über die Konfiguration oder über die
Funktion <function>phpinfo</function> ermittelt werden.
</simpara>
</step>
<step>
<simpara>
Überprüfen Sie beim IIS, ob der Benutzer <literal>IIS_User</literal>
die Berechtigung <literal>MODIFY</literal> hat.
</simpara>
</step>
</procedure>
</answer>
</qandaentry>

<qandaentry xml:id="faq.installation.apache.multiviews">
<question>
<para>
Expand Down Expand Up @@ -545,7 +573,7 @@ AddType text/html php
</question>
<answer>
<para>
Nein, es ist möglich, jede Anfragemethode zu bearbeiten, z. B. auch
Nein, es ist möglich, jede Anfragemethode zu bearbeiten, &zb; auch
CONNECT. Ein korrekter Antwortstatus kann mit
<function>header</function> gesendet werden. Falls nur die Methoden GET
und POST bearbeitet werden sollen, kann das mit dieser
Expand Down
29 changes: 14 additions & 15 deletions install/cloud/azure.xml
View file
Original file line number Diff line number Diff line change
@@ -1,36 +1,35 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 5d591c30aeef70c8cd325ab914c102333cc9bd8f Maintainer: nobody Status: ready -->
<!-- EN-Revision: 2dbf3d9064d4cb07f0a2f7d06641c877a2e5ed24 Maintainer: nobody Status: ready -->
<sect1 xml:id="install.cloud.azure" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Azure App Services</title>
<para>
PHP wird häufig auf Azure App Services (alias Microsoft Azure, Windows Azure,
Azure Web Apps) verwendet.
PHP wird häufig auf Azure App Services (auch bekannt als Microsoft Azure,
Windows Azure, Azure Web Apps) verwendet.
</para>
<para>
Azure App Services verwaltet Pools von Windows-Web-Servern zum Hosten Ihrer Webanwendung,
als Alternative zur Verwaltung Ihres eigenen Webservers auf Ihren eigenen Azure Compute VMs
oder anderen Servern.
Azure App Services verwaltet Pools von Windows-Webservern zum Hosten Ihrer
Webanwendung, als Alternative zur Verwaltung Ihres eigenen Webservers auf
Ihren eigenen Azure Compute VMs oder anderen Servern.
</para>
<para>
PHP ist bereits automatisch für Ihre Azure App Services Website aktiviert. Wählen Sie im
Azure-Portal Ihre Website aus, und Sie können wählen, welche Version von PHP verwendet
werden soll. Möglicherweise möchten Sie eine neuere Version als Standardversion wählen.
PHP ist bereits automatisch für Ihre Azure App Services Website aktiviert.
Wählen Sie im Azure-Portal Ihre Website aus, und Sie können wählen, welche
Version von PHP verwendet werden soll. Möglicherweise möchten Sie eine neuere
Version als Standardversion wählen.
</para>

<para>
Daher werden PHP und Erweiterungen auf Azure App Services genauso wie auf anderen
Windows-Servern laufen.
Viele Fehlerbehebungshinweise gelten auch für Azure App Services, also lesen sie auch
<link linkend="install.windows.troubleshooting">Windows-Fehlerbehebungsseite</link>.
Daher werden PHP und Erweiterungen auf Azure App Services genauso wie auf
anderen Windows-Servern laufen.
Das Verwaltungsinterface für Azure App Services ist jedoch anders:
</para>

<itemizedlist spacing="compact">
<listitem>
<para>
Azure-Portal: Erstellen, Bearbeiten von Einstellungen und Löschen von Websites.
<link xlink:href="https://portal.azure.com/">Azure Portal</link>
Azure-Portal: Erstellen, Bearbeiten von Einstellungen und Löschen von
Websites. <link xlink:href="https://portal.azure.com/">Azure Portal</link>
</para>
</listitem>
<listitem>
Expand Down
224 changes: 40 additions & 184 deletions install/unix/index.xml
View file
Original file line number Diff line number Diff line change
@@ -1,193 +1,49 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 645c1b0252ac20e344c151a5184d9c8e594f4811 Maintainer: sammywg Status: ready -->
<!-- EN-Revision: 4cb53ecbd763db2db808e90d7eda63afb380e6df Maintainer: sammywg Status: ready -->
<!-- Reviewed: yes -->
<!-- Rev-Revision: 4eeb07225f615fcde68cbefb84df2fc9bf278f1f Reviewer: samesch -->
<chapter xml:id="install.unix" xmlns="http://docbook.org/ns/docbook">
<title>Installation auf Unix-Systemen</title>
<para>
Dieser Abschnitt leitet Sie durch die generelle Konfiguration und
Installation von PHP auf Unix-Systemen. Bitte lesen Sie zuerst alle
Abschnitte, die speziell auf Ihre Plattform oder Ihren Webserver
zugeschnitten sind, bevor Sie mit dem Installationsprozess beginnen.
</para>
<para>
Wie dieses Handbuch im Abschnitt
<link linkend="install.general">Generelle Installationsüberlegungen</link>
darlegt, behandeln wir in diesem Abschnitt hauptsächlich die
Web-zentrierte Einrichtung von PHP, obwohl wir die Installation von PHP
für die Kommandozeilen-Nutzung ebenso beschreiben.
</para>
<para>
Es gibt veschiedene Wege, PHP auf Unix-Plattformen zu installieren:
Entweder mit einem Kompilierungs- und Konfigurationsprozess oder durch
verschiedene Methoden mit vorgefertigten Paketen. Diese Dokumentation
richtet ihr Augenmerk hauptsächlich auf den Prozess des Kompilierens und
Konfigurierens von PHP. Viele Unix-artige Systeme haben irgendeine Art von
Paket-Installationssystem. Dies kann beim Aufsetzen einer
Standardkonfiguration helfen, aber wenn Sie davon abweichende Features
benötigen (etwa einen sicheren Server oder andere Datenbanktreiber),
könnte es sein, dass Sie PHP und/oder Ihren Webserver selbst bauen müssen.
Falls Ihnen das Bauen und Kompilieren von Software nicht geläufig ist, ist
es lohnenswert zu prüfen, ob bereits jemand ein PHP-Paket mit den von
Ihnen benötigten Features gebaut hat.
</para>
<para>
Folgende Fähigkeiten und Software benötigen Sie für die Kompilierung:
<itemizedlist>
<listitem>
<simpara>
Grundlegende Unix-Fertigkeiten (die Fähigkeit, "make" und einen
C-Kompiler zu bedienen)
</simpara>
</listitem>
<listitem>
<simpara>
Einen ANSI-C-Compiler
</simpara>
</listitem>
<listitem>
<simpara>
Einen Webserver
</simpara>
</listitem>
<listitem>
<simpara>
Modulspezifische Komponenten (wie <acronym>GD</acronym>,
<acronym>PDF</acronym>-Bibliotheken usw.)
</simpara>
</listitem>
</itemizedlist>
</para>
<chapter xml:id="install.unix" xmlns="http://docbook.org/ns/docbook">
<title>Installation auf Unix-Systemen</title>
<simpara>
Die meisten Unix- (und Linux-) Betriebssysteme und Distributionen bieten über
ihr Paketsystem fertige Pakete von PHP und dessen Erweiterungen an.
Weitere Informationen zur Installation von PHP unter diesen Systemen sind in
den entsprechenden Abschnitten zu finden.
</simpara>
<simpara>
Für einige Distributionen gibt es auch Paketquellen von Drittanbietern, die
in der Regel eine größere Auswahl an verfügbaren Versionen und Erweiterungen
enthalten.
</simpara>
<simpara>
Darüber hinaus kann PHP als Bestandteil mancher Anwendungsserver von
Drittanbietern <!-- wie FrankenPHP und Open Swoole--> installiert werden.
</simpara>
<simpara>
Und schließlich kann PHP immer aus dem Quellcode installiert werden, was die
größte Flexibilität bei der Auswahl der zu aktivierenden Funktionen,
Erweiterungen und Server-APIs bietet.
Es gibt Abschnitte mit Informationen über die Kompilierung und Konfiguration
von PHP insbesondere für die Verwendung mit verschiedenen Server-APIs.
</simpara>

<para>
Wenn direkt von den Git-Quellen kompiliert wird oder eigene Änderungen
vorgenommen wurden, könnten folgende Komponenten benötigt werden:
<itemizedlist>
<listitem>
<simpara>
autoconf:
</simpara>
<itemizedlist>
<listitem>
<simpara>
PHP 7.3 und höher: 2.68+
</simpara>
</listitem>
<listitem>
<simpara>
PHP 7.2: 2.64+
</simpara>
</listitem>
<listitem>
<simpara>
PHP 7.1 und früher: 2.59+
</simpara>
</listitem>
</itemizedlist>
</listitem>
<listitem>
<simpara>
automake: 1.4+
</simpara>
</listitem>
<listitem>
<simpara>
libtool: 1.4.x+ (ausgenommen 1.4.2)
</simpara>
</listitem>
<listitem>
<simpara>
re2c:
</simpara>
<itemizedlist>
<listitem>
<simpara>
PHP 8.3 und höher: 1.0.3+
</simpara>
</listitem>
<listitem>
<simpara>
PHP 8.2 und früher: 0.13.4+
</simpara>
</listitem>
</itemizedlist>
</listitem>
<listitem>
<simpara>
bison:
</simpara>
<itemizedlist>
<listitem>
<simpara>
PHP 7.4 und höher: 3.0.0+
</simpara>
</listitem>
<listitem>
<simpara>
PHP 7.3 und früher: 2.4+ (einschließlich Bison 3.x)
</simpara>
</listitem>
</itemizedlist>
</listitem>
</itemizedlist>
</para>

<para>
Der anfängliche PHP Setup- und Konfigurationsprozess wird durch die
Verwendung von Kommandozeilen-Optionen des
<command>configure</command>-Skriptes gesteuert. Sie sollten eine Liste
von allen verfügbaren Optionen zusammen mit einer kurzen Erläuterung durch
den Aufruf von <command>./configure --help</command> erhalten. Unser
Handbuch dokumentiert die verschiedenen Optionen einzeln. Sie finden die
<link linkend="configure.about">grundlegenden Optionen im Anhang</link>,
während die verschiedenen erweiterungsspezifischen Optionen auf den
Referenzseiten der Erweiterungen beschrieben sind.
</para>

<para>
Sobald PHP konfiguriert ist, sind Sie bereit, die Module und/oder die
ausführbaren Dateien zu bauen. Der Befehl <command>make</command> sollte
sich darum kümmern. Falls dies fehlschlägt und Sie nicht herausfinden
können wieso, werfen Sie einen Blick in den Abschnitt
<link linkend="install.problems">Probleme</link>.
</para>

<note>
<para>
Einige Unix-Systeme (wie etwa OpenBSD und SELinux) verbieten
möglicherweise aus Sicherheitsgründen das Zuordnen von Speicherseiten,
die sowohl schreibbar als auch ausführbar sind, was als PaX MPROTECT oder
W^X violation protection bezeichnet wird. Diese Art der Speicherzuordnung
ist allerdings für die JIT-Unterstützung von PCRE erforderlich, sodass
PHP dann entweder
<link linkend="pcre.installation">ohne PCRE-JIT-Unterstützung</link>
kompiliert werden muss, oder die ausführbare PHP-Datei auf irgendeine
vom System bereitgestellte Weise freigegeben (whitelisted) werden muss.
</para>
</note>

<note>
<simpara>
Die Cross-Kompilierung für ARM mit der Android-Toolchain wird zurzeit
nicht unterstützt.
</simpara>
</note>

<!-- web server specific nodes -->
&install.unix.apache2;
&install.unix.nginx;
&install.unix.lighttpd-14;
&install.unix.litespeed;
&install.unix.commandline;
<!-- operating system specific nodes -->
&install.unix.openbsd;
&install.unix.solaris;
<!-- distribution specific nodes -->
&install.unix.debian;

</chapter>
<!-- distribution specific nodes -->
&install.unix.debian;
&install.unix.dnf;
&install.unix.openbsd;
<!-- general from-source instructions -->
&install.unix.source;
<!-- web server specific nodes -->
&install.unix.commandline;
&install.unix.apache2;
&install.unix.nginx;
&install.unix.lighttpd-14;
&install.unix.litespeed;
<!-- operating system specific nodes -->
&install.unix.solaris;

</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
Expand Down
Loading

0 comments on commit a819818

Please sign in to comment.