Server - Apache

Dieser Teil enthält Anmerkungen und Tipps zur Installation von Apache mit PHP, sowohl für die Unix als auch für die Windows Version.

Details der Installation von PHP mit Apache auf Unix

Aus der Kompletten Liste der Konfigurationsoptionen können Sie die weitere Argumente für configure in Zeile 8 wählen.

Beispiel 3-5. Installationsanweisungen (Apache Modulversion)

1.  gunzip apache_1.3.x.tar.gz
2.  tar xvf apache_1.3.x.tar
3.  gunzip php-x.x.x.tar.gz
4.  tar xvf php-x.x.x.tar
5.  cd apache_1.3.x
6.  ./configure --prefix=/www
7.  cd ../php-x.x.x
8.  ./configure --with-mysql --with-apache=../apache_1.3.x --enable-track-vars
9.  make
10. make install
11. cd ../apache_1.3.x
12. for PHP 3: ./configure --activate-module=src/modules/php3/libphp3.a
    for PHP 4: ./configure --activate-module=src/modules/php4/libphp4.a
13. make
14. make install

  Statt diesem Schritt können Sie auch die httpd Binärdatei einfach über
  Ihre existierende Binärdatei kopieren. Stellen Sie jedoch sicher, dass
  der Server zuvor heruntergefahren wurde.

15. cd ../php-x.x.x
16. for PHP 3: cp php3.ini-dist /usr/local/lib/php3.ini
    for PHP 4: cp php.ini-dist /usr/local/lib/php.ini

  Sie können Ihre .ini Datei editieren, um PHP Optionen auszuwählen. 
  Wenn Sie diese Datei an einer anderen Stelle haben möchten, verwenden 
  Sie in Schritt 8 --with-config-file-path=/path 

17. Editieren Sie Ihre httpd.conf oder srm.conf Datei, und fügen Sie 
    hinzu: 
      
     Für PHP 3:   AddType application/x-httpd-php3 .php3
     Für PHP 4:   AddType application/x-httpd-php .php
 
  Sie können jede gewünschte Dateinamenserweiterung wählen,  .php wird 
  von uns einfach nur vorgeschlagen. Sie können selbst .html einbinden.

18. Verwenden Sie Ihre normale Prozedur, um den Apache Server zu starten.
    (Sie müssen den Server stoppen und wieder starten, und ihn nicht nur 
    mittels einem HUP oder USR1 Signal zu einem Reload veranlassen).

Es gibt abhängig von Ihrer Apache Installation und Unix Variante viele mögliche Wege den Server zu stoppen und neu zu starten. Nachstehend finden Sie einige typische Zeilen für einen Server Restart auf verschiedenen apache/unix Installationen. Ersetzen Sie /path/to/ mit dem Pfad zu diesen Applikationen auf Ihrem System.

1. Verschiedene Linux und SysV Varianten:
/etc/rc.d/init.d/httpd restart

2. Verwendung von apachectl Skripten:
/path/to/apachectl stop
/path/to/apachectl start

3. httpdctl und httpsdctl (Verwendet OpenSSL), ähnlich zu apachectl:
/path/to/httpsdctl stop
/path/to/httpsdctl start

4. Verwenden von mod_ssl oder einem anderen SSL Server, vielleicht 
möchten Sie manuell stoppen und wieder starten:
/path/to/apachectl stop
/path/to/apachectl startssl

Der Ort der apachectl und http(s)dctl Binaries ändert sich häufig. Wenn Ihr System über locate, whereis oder which Kommandos verfügt, sind diese beim Auffinden Ihrer Server contrl Programme hilfreich.

Verschiedene Beispiele zum Kompilieren von PHP für Apache:

./configure --with-apxs --with-pgsql

Dies erstellt eine libphp4.so Shared Library, welche in den Apache geladen wird, wenn eine LoadModule Zeile in der httpd.conf von Apache existiert. Die PostgreSQL Unterstützung ist in der libphp4.so Bibliothek eingelagert.

./configure --with-apxs --with-pgsql=shared

Dies erstellt ebenfalls eine libphp4.so Shared Library, jedoch wird zusätzlich auch eine pgsql.so Shared Library erstellt. Diese wird entweder aufgrund der Extension Option in der php.ini, oder durch die Verwendung der Funktion dl() in einem Skript von PHP geladen.

./configure --with-apache=/path/to/apache_source --with-pgsql

Dies erstellt eine libmodphp4.a Bibliothek, eine mod_php4.c und einige begleitende Dateien, und kopiert diese in das src/modules/php4 Verzeichnis im Apache Source Tree. Dann kompilieren Sie Apache mit --activate-module=src/modules/php4/libphp4.a, und das Apache Build System erstellt libphp4.a, und linkt es statisch in die httpd Binary. Die PostgreSQL Unterstützung ist in dieser httpd Binary inkludiert, was in einer einzigen httpd Binary inkl. komplettem Apache und komplettem PHP resultiert.

./configure --with-apache=/path/to/apache_source --with-pgsql=shared

Wie vorher, außer dass die PostgreSQL Unterstützung nicht direkt in die httpd inkludiert, sondern eine pgsql.so Shared Library erstellt wird. Diese können Sie entweder mittels der Extension Option in der php.ini, oder direkt mittels dl() in PHP laden.

Bevor Sie sich für einen Weg PHP zu kompilieren entscheiden, sollten Sie die Vor- und Nachteile der jeweiligen Methode bedenken. Die Kompilation als verteiltes Objekt heißt, dass Sie Apache separat kompilieren können, und nicht für alles in PHP hinzugefügte bzw. geänderte neu kompilieren müssen. PHP direkt in Apache einzukompilieren (statische Methode) heißt, dass PHP schneller lädt, und schneller läuft. Weitere Informationen finden Sie auf der Apache webpage on DSO support.

Installation von PHP auf Windows mit Apache 1.3.x

Es gibt zwei Arten, PHP mit Apache 1.3.x unter Windows aufzusetzen. Eine ist die Verwendung des CGi Moduls (php.exe), die andere ist der Einsatz der Apache Modul dll. In beiden Fällen müssen Sie den Apache Server stoppen, und Ihre srm.conf oder httpd.conf editieren, um Apache für die Zusammenarbeit mit PHP zu konfigurieren.

Obwohl einige Variationen in der Konfiguration von PHP unter Apache möglich sind, sollten diese auch für Neulinge einfach genug sein. Für weitere Konfigurationsmöglichkeiten konsultieren Sie bitte die Apache Dokumentation.

Wenn Sie die PHP Distribution wie im Teil Manuelle Installationsschritte beschrieben nach c:\php\ entpackt haben, müssen Sie die folgenden Zeilen in Ihrer Apache Konfigurationsdatei einfügen, um das CGI-Modul aufzusetzen:

ScriptAlias /php/ "c:/php/"
AddType application/x-httpd-php .php .phtml
Action application/x-httpd-php "/php/php.exe"

Beachten Sie, dass die zweite Zeile der obigen Liste in den aktuellen Versionen von httpd.conf bereits enthalten, jedoch auskommentiert ist. Vergessen Sie nicht, nach der Änderung der Konfigurationsdatei den Server neu zu starten, z.B. mit NET STOP APACHE, gefolgt von NET START APACHE wenn Sie Apache als Windows Service nutzen, oder verwenden Sie Ihre Shortcuts.

Wenn Sie PHP als Apache Modul einsetzen möchten, kopieren Sie die php4ts.dll in Ihr windows/system (für Windows 9x/Me) oder winnt/system32 (für Windows NT/2000) Verzeichnis, und überschreiben die dort eventuell bereits existierende Datei. Dann sollten Sie die folgenden zwei Zeilen in Ihrer Apache conf Datei einfügen:

LoadModule php4_module c:/php/sapi/php4apache.dll
AddType application/x-httpd-php .php .phtml

Anmerkung: Apache 1.3.22 for Windows hat in seiner Konfigurationsdatei (httpd.conf-dist-win) die ClearModuleList Direktive standardmäßig inkludiert. Wird diese Direktive verwendet, muss eine AddModule mod_php4.c in die AddModule Liste aufgenommen werden, da PHP sonst nicht als ein Apache Modul registriert wird.

Um das Source Code Highlighting Feature verwenden zu können, erstellen Sie einfach eine PHP Skriptdatei, und fügen diesen Code ein: <?php show_source ("original_php_script.php"); ?>. Ersetzen Sie original_php_script.php durch den Dateinamen der Datei, dessen Sourcecode Sie anzeigen lassen möchten (Das ist der einzige Weg, dies zu tun, da unter Windows kein Feature wie .phps existiert).

Anmerkung: Auf Win-Apache müssen alle Backslashes "\" in einer Pfadangabe, wie z.B. "c:\directory\file.ext", in Slashes "/" umgewandelt werden, wie z.B. "c:/directory/file.ext".