[svn-inject] Applying Debian modifications to trunk
[manu/suphp.git] / doc / de / apache / INSTALL
1 ===========================
2 == suPHP Apache module   ==
3 ===========================
4
5 Installation
6 ------------
7
8 1. Einführung
9
10 Das suPHP Apache Modul bietet zusammen mit suPHP selbst eine einfache
11 Mvglichlkeit PHP Skripte unter verschiedenen Benutzern auf dem selben Server
12 auszuf|hren.
13
14 Es bietet dadurch Sicherheit, dass die PHP-Skripte nicht mit den Rechten des
15 Webservers ausgef|hrt werden.
16 Dadurch muss man in den meisten Fdllen nicht den Apache "Safe Mode"
17 benutzen, der viele Einschrdnkungen f|r die Skripte bedeutet.
18
19 Bitte lesen Sie zuerst die "README" in diesem Verzeichnis und sowohl
20 "README" als auch "INSTALL" in dem übergeordneten Verzeichnis.
21
22
23 2. Kurze Zusammenfassung
24
25 In diesem Teil werden die wichtigsten Informationen für Leute, die wissen,
26 wie man den Apache Server mit zusätzlichen Modulen kompiliert, gegeben.
27 Wenn Sie sich damit nicht auskennen, finden Sie eine
28 Schritt-für-Schritt-Anleitung im dritten Teil dieser Dokumentation.
29
30 mod_suphp besteht aus nur einer Datei mit den Namen "mod_suphp.c".
31 Wenn sich die suPHP Binary nicht im Standard-Pfad (/usr/sbin/suphp)
32 befindet, müssen Sie die entsprechende Zeile in der "mod_suphp.c"
33 entsprechend anpassen, bevor Sie es zu den Apache Sourcen hinzufügen.
34  
35 Die einfachste Möglichkeit mod_suphpzu installieren, ist es als ein
36 dynamisch ladbares Modul (DSO) zu kompilieren. Wenn Ihr Apache mit
37 DSO-Unterstützung kompiliert wurde und sich entweder "apxs" im PATH befindet
38 oder Sie den Pfad zu "apxs" angegeben haben, als Sie "./configure"
39 ausgeführt haben, wird das Apache Modul automatisch kompiliert wenn Sie
40 "make" und installiert wenn Sie "make install" ausführen.
41
42 Informationen darüber, wie mod_suphp konfiguriert wird, können Sie in der
43 Datei "CONFIG" in diesem Verzeichnis finden.
44
45 Bitte beachten Sie dass mod_suphp für Apache 1.3.2x und Apache 2.0.x 
46 entwickelt wurde und möglicherweise nicht mit anderen Apache-Versionen 
47 funktioniert.
48
49 suPHP wurde für Linux entwickelt, möglicherweise funktioniert es auch auf
50 einigen anderen *NIX-Systemen. Es scheint eine FreeBSD-Port von suPHP zu
51 geben, da ich jedoch momentan kein FreeBSD-System habe, kann ich nicht
52 ausprobieren, welche Änderugen an der aktuellen Version von suPHP
53 vorgenommen werden müssen, damit es unter FreeBSD läuft. Wenn es jemand
54 weiß, möge er es mir bitte mitteilen, so dass ich die GNU autoconf Skripte
55 modifizieren kann, damit die entsprechenden Entscheidungen beim Kompilieren
56 automatischen getroffen werden könnne.
57
58 Wenn Sie es auf einem anderen System ausprobiert haben und es funktioniert,
59 wäre es nett, wenn Sie mir dies mitteilen würden.
60
61
62 3. Schritt-für-Schritt-Anleitung
63
64 Wenn Sie bereits Apache mit DSO-Unterstützung am Laufen haben, sollte
65 mod_suphp automatisch in Ihrem Apache Server installiert worden sein.
66
67 Wenn es nicht funktioniert sollten Sie nach den folgenden beiden Zeilen in
68 Ihrer "httpd.conf" sehen:
69
70  LoadModule suphp_module       /usr/lib/httpd/mod_suphp.so
71  AddModule mod_suphp.c
72
73 Manchmal fügt "apxs" diese Zeilen an der falschen Stelle ein. In diesem Fall
74 müssen Sie die Zeilen an die richtige Stelle verschieben (lesen Sie die
75 Apache Dokumentation für Details).
76
77 Um den Apache aus dem Quelltext mit mod_suphp (statisch) zu kompilieren,
78 müssen Sie die folgenden Schritte ausführen.
79
80 Ändern Sie ggf. den Pfad zur suPHP Binary in der "mod_suphp.c".
81
82 Laden Sie die Apache Quellen von http://www.apache.org/ und entapcken Sie
83 diese. Wechseln Sie jetzt in das neu angelegte Verzeichnis und starten Sie
84 "./configure --help". Es werden sehr nützliche Information über das
85 "configure"-Skript ausgegeben.
86
87 Führen Sie anschließend das "configure"-Skript mit den Paramtern, die Ihren
88 Anforderungen entsprechen, aus und fügen Sie außerdem die Option
89 "--ad-module=/path/to/mod_suphp.c" hinzu.
90
91 Dies wird "mod_suphp.c" zu den Apache Quellen kopieren und es aktivieren.
92
93 Sie können jetzt Apache mit "make" kompilieren und anschließenden mit "make
94 install" installieren.
95
96 Bitte beachten Sie, dass suPHP wahrscheinlich nicht funktionieren wird, wenn
97 Sie auch mod_php kompilieren.
98
99 Um mit suPHP PHP-Skripte zu verarbeiten müssen Sie nur eine Zeile wie
100
101 AddHandler x-httpd-php .php
102
103 in Ihre Apache-Konfiguration einfügen und mod_suphp für die entsprechenden
104 VHosts aktivieren.
105
106 Sie können mod_suphp einschalten, indem Sie die Zeile
107
108 suPHP_Engine on
109
110 in Ihrer globalen Apache-Konfiguration hinzufügen.
111 Dies aktiviert suPHP für alle VirtualHosts.
112
113 Informationen über zusätzliche Optionen können in der "CONFIG"-ReadMe
114 gefunden werden.
115
116 4. Zusätzliche Informationen
117
118 Bitte beachten Sie, dass mod_suphp in den meisten Fällen *NICHT*
119 funktionieren wird, wenn mod_php in Ihrem Apache-Server installiert ist,
120 weil beide den gleiche MIME-Typ "x-httpd-php" benutzen. Mir wurde von
121 einigen Benutzern berichtet, die beide Module gleichzeitig am Laufen haben,
122 aber eine solche Konfiguration dürfte nicht trivial sein, weshalb ich keine
123 Fragen darüber, wie man mod_php und mod_suphp gleichzeitig laufen lassen
124 kann, beantworten werde.
125
126
127 ===================================
128 (c)2002-2004 by Sebastian Marsching
129 <sebastian@marsching.com>
130 Please see LICENSE for
131 additional information