doc/de/INSTALL

   1 ===========================
   2 == suPHP                 ==
   3 ===========================
   4
   5 Installation
   6 ------------
   7
   8 1. Einführung
   9
  10 Das suPHP Apache Modul bietet zusammen mit suPHP selbst eine einfache
  11 Möglichlkeit 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 Fällen nicht den Apache "Safe Mode"
  17 benutzen, der viele Einschränkungen für die Skripte bedeutet.
  18
  19 Bitte beachten Sie, dass die suPHP Binary als "root" mit gesetztem
  20 "SetUID"-Bit installiert werden muss, d.h. eine Sicherheitslücke in suPHP
  21 würde es wahrscheinlich Angreifern erlauben Befehle mit "root"-Rechten
  22 auszuführen. Obwohl mir zur Zeit keine solchen Fehler in suPHP bekannt sind,
  23 kann ich nicht garantieren, dass es keine gibt.
  24
  25
  26 2. Installation
  27
  28 Führen Sie "./configure" mit den entsprechenden Paramatern für Ihr System
  29 aus.
  30
  31 Auf den meisten Systemen dürfte ein
  32  ./configure --prefix=/usr
  33 genügen.
  34
  35 Dem "./configure"-Skript könenn die üblichen GNU autoconf Parameter plus den
  36 folgenden suPHP spezifischen Paramtern übergen werden:
  37
  38 --disable-checkpath: Diese Option bewirkt, dass suPHP nicht überprüft, ob
  39                      sich ein Skript (oder ein Symlink darauf) auch
  40                      tatsächlich im DOCUMENT_ROOT befinden. Sie werden diese
  41                      Option wahrscheinlich benutzen wollen, wenn Sie
  42                      von der "Alias"-Direktive Gebrauch machen.
  43
  44 --disable-checkuid:  Diese Option kann angegeben werden, um PHP-Skripte mit
  45                      UIDs ausführen zu können, für die kein Eintrag in der
  46                      /etc/passwd vorhanden ist.
  47
  48 --disable-checkgid:  Diese Option kann angegeben werden, um PHP-Skripte mit
  49                      GIDs ausführen zu können, für die kein Eintrag in der
  50                      /etc/group vorhanden ist.
  51
  52 --with-apxs=FILE:    Der Pfad zum "apxs" Ihrer Apache Installation. Wenn die
  53                      Option nicht angegenben wird, sucht "configure" im PATH
  54                      nach "apxs". Wenn "apxs" nicht gefunden wird oder Ihr
  55                      Apache nicht mit DSO-Unterstützung kompiliert wurde,
  56                      wird mod_suphp nicht kompiliert. Bitte stellen Sie
  57                      sicher, dass der Pfad zu apxs richtig ist, da suPHP
  58                      apxs benutzt um festzustellen, ob mod_suphp für
  59                      Apache 1 oder Apache2 kompiliert werden soll.
  60
  61 --with-min-uid=UID:  Die kleinste UID für die suPHP die Ausführung von
  62                      PHP-Skripten zulässt (Standard: 100).
  63
  64 --with-min-gid=GID:  Die kleinste GID für die suPHP die Ausführung von
  65                      PHP-Skripten zulässt (Standard: 100).
  66
  67 --with-apache-user=USERNAME:
  68                      Benutzername (nicht UID), unter dem Apache läuft
  69                      (Standard: "wwwrun").
  70
  71 --with-php=FILE:     Pfad zum PHP-Interpreter (Standard: /usr/bin/php).
  72
  73 --with-logfile=FILE: Pfad zur suPHP Logdatei (Standard:
  74                      /var/log/http/suphp_log).
  75
  76 --with-setid-mode=MODE:
  77                      Für MODE gibt es folgende Möglichkeiten:
  78                      "owner":   Skripte mit der UID/GID des Besitzers
  79                                 ausführen.
  80                      "force":   Skripte mit UID/GID ausführen, die in der
  81                                 Apache-Konfiguration angegeben ist.
  82                      "paranoid: Skripte mit der UID/GID des Besitzers
  83                                 ausführen und zusätzlich überprüfen, ob diese
  84                                 mit der UID/GID aus der Apache-Konfiguration
  85                                 übereinstimmt.
  86
  87 Kompilieren Sie jetzt suPHP mit Hilfe von "make" und, falls keine Fehler
  88 dabei auftreten, installieren Sie es mit "make install". Stellen Sie sicher,
  89 dass Sie als "root" eingeloggt sind, wenn Sie "make install" ausführen.
  90
  91 Wenn Ihr Apache mit DSO-Unterstützung läuft und "apxs" während des Laufs von
  92 "./configure" gefunden wurde, ist jetzt alles erledigt. Es muss nur noch die
  93 Konfiguration erfolgen (siehe CONFIG).
  94 Ansonsten müssen Sie Ihren Apache Server mit "mod_suphp.c" darin neu
  95 kompilieren. Wenn Sie ein anderes Prefix als "/usr" verwendet haben, müssen
  96 Sie in der "mod_suphp.c" den Pfad zu suPHP anpassen (dieses kann in
  97 $exec_prefix/sbin/suphp gefunden werden).
  98
  99 Details zur Kompilierung des Apache Webservers mit mod_suphp sind in
 100 apache/INSTALL zu finden.
 101
 102
 103 ===================================
 104 (c)2002-2004 by Sebastian Marsching
 105 <sebastian@marsching.com>
 106 Please see LICENSE for
 107 additional information