WebShop

Der webshop ruft externe Buchungsfunktionen, Details siehe hier ECommerce.
Der webshop verfügt über umfassende Verwaltungs und Diagnosefunktionen, Details siehe WebShop.Admin.

Den Apache-Webserver installieren

  Falls erforderlich, aktuellste Version des Apache von http://www.apache.org downloaden.
  Zur Zeit (September 2002) gibts aber noch Probleme PHP 4.2.x auf dem neuen Apache 2.0.40 laufen zu lassen. 
  Deshalb ist im Moment noch die Version 1.3.2x vorzuziehen.
  Im Index auf den Ordner "Binaries" klicken und danach auf den Ordner "Windows" bzw. 
  "Linux".
  Die gew?e Datei herunterladen und entpacken.
  Das Setup Programm ausf? An entsprechender Stelle "Service f?e User bereit 
  stellen" auswä¨¬en.

  Zum Test, ob der Server läµ¦t, im Internet Browser einfach "localhost" oder die 
  IP-Adresse "127.0.0.1" eingeben. Dann m?folgender Text erscheinen: 
  "Es klappt! Der Apache-Webserver ist auf dieser Website installiert!"

Den Apache-Webserver konfigurieren

  Nach der Installation der Apache Software ist Startmen?in Verzeichnis reicher.
  Dort kann man unter anderem die Apache-Konfigurations Datei "httpd.conf" editieren.
  Den Eintrag "DocumentRoot=" sollte man auf das Verzeichnis setzen in dem die "index.html" 
  oder eine andere Index-Datei der Homepage liegt, die geservt werden soll.
  Den Eintrag <Directory= > sollte man auf das gleiche Verzeichnis setzen.

  Das sollte f?ste reichen. Jedoch lassen sich in dieser Datei noch wesentlich mehr Funktionen 
  einstellen, was zu erklä²¥n ?en Umfang dieses HowTos hinausgehen w?   Die einzelnen Einträ§¥ sind in englisch kommentiert und erklä²¥n sich somit (fast) von selbst.

PHP installieren

  PHP ist von der Seite "www.php.net" zu beziehen. 
  Am besten die neuste Version als .zip Datei herunterladen (auch falls eine .exe Datei vorliegen sollte).
  Nach dem Download die Datei entpacken, z.B. in "C:\Programme\Php". Im Folgenden nehmen 
  wir an, wir hä´´en dieses Verzeichnis gewä¨¬t.

  Die Datei "php4ts.dll" (PHP4) bzw. "php5ts.dll" (PHP5) in "C:\Programme\Php" und die DLLs in "C:\Programme\Php\dlls" werden 
  in das "Windows/System"-Verzeichnis (Win95/98) bzw. das "WINNT/System32"-Verzeichnis (WinNT/2000/XP) kopiert.

  Besser ist es allerdings "C:\Programme\Php" zu Umgebungsvariablen PATH hinzuzuf?da es zuk?e Updates erleichtert.
  Es muss dann nä¬ich nichts mehr kopiert werden.

  Die Datei "C:\Programme\Php\php.ini-dist" oder besser "C:\Programme\Php\php.ini-recommended" 
  wird ins "Windows"-Verzeichnis bzw. ins "WINNT"-Verzeichnis kopiert und in "php.ini" umbenannt.
  (Wird ein Apache 2.0.x Server benutzt, muss die Datei nicht kopiert werden, sondern der Pfad zur ini-Datei kann dem Apache
   in dessen conf-Datei angegeben werden, siehe nä£¨stes Kapitel unter PHP5).

  Dann muss sie im Editor ge?et und der Eintrag "register_globals = Off" muss auf "On" gesetzt werden. 
  Das ist wichtig, da ansonsten keine Variablen von einem Skript zum anderen ?ben werden k?n.
  Ausserdem muss "register_argc_argv = On" gesetzt werden. Dies ist in der "php.ini-recommended" auf "Off" gesetzt,
  um die Performance zu verbessern.

  Fertig.

  Weitere Informationen zur Installation von PHP stehen in der Datei "C:\Programme\Php\install.txt".

PHP & Apache

  Angenommen PHP ist auf dem Rechner im Verzeichnis "C:\Programme\Php" installiert (siehe vorheriges Kapitel).
  Jetzt wird ?as Startmen?Apache-Konfigurations-Datei "httpd.conf" im Editor (Notepad) ge?et und 
  ans Ende oder unter eine Stelle mit ä¨®lichen Einträ§¥n werden folgende drei Zeilen eingef?   PHP4:
  LoadModule php4_module "C:/Programme/Php/sapi/php4apache.dll"
  AddModule mod_php4.c
  AddType application/x-httpd-php .php

  PHP5: 
  LoadModule php5_module "c:/php/php5apache.dll"
  AddType application/x-httpd-php .php
  # configure the path to php.ini
  PHPIniDir "C:/Programme/Php"

  Eventuell ist es m?ch, dass die mittlere Zeile ("AddModule...") schon an anderer Stelle in der Datei steht, 
  dann muss sie nicht mehr eingef?rden oder kann mit einem "#"-Zeichen als Kommentar unschä¤¬ich gemacht werden.

  Falls ein Apache 2.0.x-Server benutzt wird muss in der ersten Zeile anstelle von "php{Version}apache.dll" der 
  Dateiname "php{Version}apache2.dll" stehen.

  Nach diesen Ä®derungen sollte PHP unter Apache laufen. 
  Ob PHP funktioniert, sieht man, wenn man das im Anhang vorhandene Skript "phpinfo.php"
  aus dem Browser (nicht per Doppelklick) aufruft, wä¨²end der Apache Server läµ¦t.
  Dann wird eine Seite mit allen PHP-Informationen angezeigt. Auch der Pfad in dem PHP die "php.ini" erwartet. 
  Sollte dieser sich von dem im vorigen Kapitel angegebenen Windows-Verzeichnis unterscheiden, sollte die Ini 
  dorthin verschoben werden.

  Weitere Informationen zur Installation von PHP stehen in der Datei "C:\Programme\Php\install.txt".

PHP & firebird, interbase.so compilieren

Linux.firebird

Interbase-Extension f? laden

Damit PHP auf Interbase/Firebird Datenbanken zugreifen kann, m?die Routinen, die das erm?chen, beim Start von PHP als Erweiterung geladen werden. Dies geschieht mit Hilfe zweier Einträ§¥ in der "php.ini". Erstens muss der Eintrag "extension_dir= " auf das Verzeichnis mit den Extension-Dlls gesetzt werden. Diese befinden sich standardmäŸ©g im Verzeichnis "extensions". Falls PHP zum Beispiel in "C:\Programme\Php" installiert wurde, liegen die Erweiterungs-Dlls im Verzeichnis "C:\Programme\Php\extensions". Der Eintrag in der "php.ini" lautet dann:

  Win32
  extension_dir = "C:\Programme\Php\extensions"
  Linux
  extension_dir = "/usr/lib/php/extension"

Zweitens gibt es in der "php.ini" einen Abschnitt, der sich "Dynamic Extensions" nennt. Dort sind alle Erweiterungen in der Form ";extension=php_....dll" aufgef?Da ein Semikolon am Anfang steht, beachtet PHP diese Zeile nicht als Eintrag sondern als Kommentar. In der Zeile ";extension=php_interbase.dll" muss dieses Semikolon nun entfernt werden.

  Win32
  extension=php_interbase.dll
  Linux
  extension=interbase.so

Der WebShop erfordert, dass Timestamps im richtigen Format ?ben werden. Dies geschieht durch folgende zwei Zeilen, die am besten ans Ende der "php.ini" gestellt werden:

  [Interbase]
  ibase.timestampformat=%m-%d-%Y %H:%M:%S

Jetzt sollten die PHP-Routinen f? Interbase-Anbindung zur Verf?stehen. Falls dies nicht so ist, liegt es vielleicht daran, das die "php.ini" im falschen Verzeichnis liegt (L?g siehe Ende vorletztes Kapitel) oder der Pfad im Eintrag "extension_dir=" falsch gesetzt ist.

Session Verzeichnis

  Verzeichnis namens "Sess" in C:\Programme\Apache Group\Apache\" oder im selben Verzeichnis wie "DocumentRoot" anlegen.
  In der Datei "php.ini" den Eintrag "session.save_path = " auf im ersten Falle

  session.save_path = C:/Programme/Apache Group/Apache/Sess
  
  abä®¤ern.

XML-Remote-Procedure-Calls f? und DELPHI/KYLIX

  Grundsä´ºliche Infos zu xml-rpc: http://www.xmlrpc.com
  
  a) Aus dem Anhang die php-xmlrpc.zip entpacken und die Datei "xmlrpc.inc" ins 
     Webverzeichnis unter "xmlrpc.inc.php" abspeichern.

  b) Link zum Download der Delphi/Kylix Komponente xml-rpc: http://www.codepunk.com/

Virtual Hosts unter Confixx Webserver

joe /etc/httpd/confixx_vhosts.conf

die entsprechende php direktive open_basedir muss auskommentiert werden.

#php_admin_value open_basedir ...

Verzeichnisschutz für den Admin-Bereich

Der Admin-Bereich des TWebShops sollte geschützt sein.

Dazu liefert TWebShop ab Rev 1.074 die passenden Dateien:

 .htaccess
 .htpasswd

Diese müssen nun noch angepasst werden.

In der Datei .htaccess muss eventuell der Pfad zur Datei .htpasswd (AuthUserFile) korrigiert werden.

Bei Bedarf kann auch der Username (admin) geändert werden.

.htaccess:

 AuthType Basic
 AuthName "Zugang zum WebShop-Admin-Bereich" 
 AuthUserFile "/srv/www/htdocs/twebshop/admin/.htpasswd"
 require user admin

Wichtig dabei ist, dass der Pfad in Anführungszeichen steht.

Das Passwort befindet sich mit dem zugehörigen Usernamen in der Datei .htpasswd. Es lautet standardmäßig "0000".

Dies sollte in jedem Fall geändert werden. Dazu liefert Apache unter Windows das Helferlein "htpasswd.exe."

 \Apache2\bin\htpasswd.exe

Dieses erstellt über folgenden Befehl in der Eingabezeile eine neue .htpasswd Datei.

 htpasswd.exe -cb .htaccess user passwort

Hierbei "user" durch den Benutzernamen (z.B. admin) und "passwort" durch das neue Passwort ersetzt werden.

Beide .ht* Dateien werden im "/twebshop/admin"-Verzeichnis des TWebShops abgelegt.

Nun muss noch die Datei httpd.conf (Windows) bzw. die Datei default-server.conf (Linux) angepasst werden.

Die Dateien sind zu finden unter (bei Standardinstallation des Apache2):

 Windows: C:\Programme\Apache Group\Apache2\conf\httpd.conf
 Linux:   /etc/apache2/default-server.conf

Darin muss beim <Directory> Eintrag zum DocumentRoot-Verzeichnis des Apache eine Änderung der Direktive AllowOverride vorgenommen werden. Nach "AllowOverride" sollte "All" oder besser noch "AuthConfig" stehen.

 <Directory "/srv/www/htdocs/">
   ...
   AllowOverride AuthConfig
   ...
 </Directory>

Fertig !!

Anmerkung für Perfektionisten:

Besser noch wäre für das /admin Verzeichnis einen separaten <Directory> Eintrag vorzunehmen:

 <Directory "/srv/www/htdocs/twebshop/admin/">
   ...
   AllowOverride AuthConfig
   ...
 </Directory>

Dies hat den Vorteil, das Apache nicht in jedem Unterverzeichnis von seiner DocumentRoot nach vorhandenen .htaccess Dateien sucht, sondern nur im "/twebshop/admin"-Verzeichnis, was unnötigen Aufwand spart.

Systemanforderungen beim Benutzer/Client

  + Der benutzte Browser muss Cookies akzeptieren und annehmen. Ansonsten ist ein Login nicht m?ch.
    Die Einstellungen findet man z.B. im IE unter Extras->Internetoptionen->Datenschutz
    Hier sollte die Stufe "Mittel" eingestellt sein.