OrgaMon Wiki - Benutzerbeiträge [de]

ECommerce

2005-04-12T12:54:50Z

192.168.115.13:

eCommerce - Funktionen "Überblick"

Erstmalig werden Funktionen für Geschäftsabläufe aus OrgaMon in einem
Zentralen Modul (eCommerce) gesammelt. Das Ziel ist, den ganzen Webshop
bzw. alle Webanfragen ausschließlich über das eCommerce Modul laufen zu
lassen. Dabei werden auch erstmals "r" Connections und "w" Connections
eingesetzt, was dem zukünftigen raib-Server zugute kommt (Clustering).
Nun eine Liste aller eCommerce Funktionen:

eCommerce - Funktionen "XML-RPC-Verfügbar"

abu.ArtikelSuche(SuchStr: string): array of integer; { ARTIKEL_R }
// Suchmaschine für Artikelsuche

abu.ArtikelPreis(AUSGABEART_R, ARTIKEL_R:integer): double;
// liefert den Preis des Artikels in dieser Ausgabeart
// kostenlos = 0; //
// cPreis_vergriffen = -1.0; // Artikel nicht mehr lieferbar.
// cPreis_aufAnfrage = -2.0; // keine Preisinformation verfügbar.

abu.Land(LAND_R: integer): string;
// liefert die Landesbezeichnung (als ISO-Kürzel)

abu.KontoInfo(PERSON_R: integer): double;
// liefert den Kontostand des Kunden (zu zahlen!)
// erzeugt als Nebeneffekt die aktuelle "Mahnung.html"

abu.BestellInfo(PERSON_R: integer): integer;
// liefert den Lieferrückstand des Lieferanten (Erwartete Mengen!)
// erzeugt als Nebeneffekt die aktuelle "Bestellung.html"

abu.Bestellen(PERSON_R: integer): integer;
// erstellt aus dem Einkaufswagen des Kunden eine tatsächliche
// Bestellung. Die (neue) Beleg-Nummer wird zurückgegeben.
//

abu.ArtikelVersendetag(AUSGABEART_R, ARTIKEL_R:integer): integer;
//
// GELBE STATI
// 0=keine Info über Verfügbarkeit vorhanden
//
// ROTE STATI:
// 1=entgültig vergriffen
// 2=zur Zeit vergriffen, Neuauflage jedoch ungewiss
// 3=zur Zeit vergriffen, Neuauflage jedoch sicher
//
//
// GRÜNE STATI:
// 10=heute lieferbar (=ist am Lager, ohne Mengenangabe)
// 11=morgen lieferbar (=wurde z.B. mit dieser Zusage bereits bestellt und kommt morgen)
// 12=in 2 Tagen lieferbar... (=ist z.B. in dieser Zeit zu beschaffen)
// 13=in 3 Tagen lieferbar...
// 14= ... usw ...
//
// GRÜNE STATI:
// 101= heute lieferbar (=ist am Lager, Lagermenge=1)
// 102= heute lieferbar (=ist am Lager, Lagermenge=2)
// 103= heute lieferbar (=ist am Lager, Lagermenge=3)
// ... usw.
//
// GRÜNE STATI:
// >20020101= Konkretes Lieferdatum (z.B. Erscheinungsdatum!)
// 20031003= am 03.10.2003 lieferbar (da es z.B. an diesem Tag erscheint)
// (Vorbestellungen natürlich möglich)
//

abu.Verlag(VERLAG_R:integer): string;
// Names des Verlages zu einem Verlags-RID
// ACHTUNG: aus geschichtlichen Gründen sind VERLAG_R zumeist als PERSON_R(s)
// zu verstehen!

abu.Versandkosten(PERSON_R:integer): double;
// Liefert passend zum "Kunden,Umfang des Einkaufswagen,Versandart des Kunden" die
// passenden Versandkosten. Im Moment als dummy immer 3,33 €.

abu.ArtikelInfo(AUSGABEART_R, ARTIKEL_R, LAND_R, VERLAG_R) : double, string;
// Multi-Info-Funktion für weitere Informationen zu Artikel-Daten
// Ergebnisse: Preis, "ISO-Landeskennzeichen" "-" "Verlag"

abu.BasePlug():array of string;
// liefert diverse Informations-String:
// 1) Datenbankname
// 2) OrgaMon Versions-Nummer
// 3) IBO Versions-Nummer
// 4) Indy Versions-Nummer
// 5) PDF Pfad (public)
// 6) Musik Pfad
// 7) HTML-Pfad (Rechnungen)
// 8) Bild-URL
// * Mit Hilfe des Verbindungsstrings sollte auf die entsprechende Datenbank
// konnektiert werden.
// * In der Datenbank sollten nun alle weiteren Parameter, den Shop betreffend
// eingegeben sein!
// für den Shop wichtige Parameter:
//
// MusicPath=\\Linus\user\abu\Delphi\abu\Musik\
// PDFPath=\\Linus\user\hebu\HeBu PDF\A4PDF\
// XMLRPCHost=BRUTUS
// XMLRPCPort=3049
//

abu.ArtikelRabattPreis(AUSGABEART_R,ARTIKEL_R,PERSON_R) : array of double;
//
// wie Artikel-Preis, soll jedoch bei Kunden mit Rabatt-Code verwendet werden,
// diese Funktion liefert noch die Rabatt-Zahl dazu!
//

abu.PersonNeu : integer; { PERSON_R }
//
// Eine neue Person wird angelegt. Der (neue) RID wird als Ergebnis ge-
// liefert. Der Webshop kann nun weitere Eintragungen machen.
//

abu.Ort(PERSON_R) : string; { Adress-Ortsangabe }
//
// Zu der angegebenen Person wird die Orts-Angabe zusammengestellt.
// Dazu wird Land, Plz, Ortsname und Ortsteil landesspeziefisch
// kombiniert.

abu.Rabatt(PERSON_R) : boolean;
// Zu der angegebenen Person wird ermittelt, ob sie Rabatte bekommt.
// Wenn ja wird true, andernfalls false zurückgegeben.

abu.Preis(AUSGABEART_R,ARTIKEL_R,PERSON_R) : array of double;
//
// Ersetzt in Zukunft die beiden Methoden abu.ArtikelPreis und abu.ArtikelRabattPreis
// Falls der Kunde Rabatte bekommt, was beim Login mit abu.Rabatt geprüft wird,
// wird der Funktion der wirkliche PERSON_R übergeben, andernfalls 0.
// Rückgabewerte sind der Preis und der Rabatt (in Prozent, 0 bei PERSON_R == 0).

eCommerce - Funktionen "intern verfügbar"

procedure e_w_BedarfsAnzeige(AUSGABEART_R, ARTIKEL_R, POSTEN_R, MENGE: integer; Motivation: eMotivation);
// dem Agenten signalisieren, dass Bestell-Bedarf besteht

procedure e_w_Wareneingang(AUSGABEART_R, ARTIKEL_R, MENGE: integer);
// Waren im System verteilen

function e_r_Lieferant(ARTIKEL_R, MENGE: integer): integer; {PERSON_R}
// Ermittelt den Lieferanten zu diesem Artikel

function e_w_BestellBeleg(PERSON_R: integer): integer; {BBELEG_R}
// liefert die Nummer eines Bestellbelegs, ev. wird einer neu erzeugt

function e_r_Menge(AUSGABEART_R, ARTIKEL_R: integer): integer; { MENGE }
// liefert die Lagermenge dieses Artikels in der angegebenen
// Ausprägungsart

function e_w_Menge(AUSGABEART_R, ARTIKEL_R, MENGE: integer): integer; { MENGE }
// bucht eine Lagermenge ab oder zu, oder als read-Only
// liefert die neue Lagermenge

ECommerce

2005-04-12T12:53:48Z

192.168.115.13:

eCommerce - Funktionen "Überblick"

Erstmalig werden Funktionen für Geschäftsabläufe aus OrgaMon in einem
Zentralen Modul (eCommerce) gesammelt. Das Ziel ist, den ganzen Webshop
bzw. alle Webanfragen ausschließlich über das eCommerce Modul laufen zu
lassen. Dabei werden auch erstmals "r" Connections und "w" Connections
eingesetzt, was dem zukünftigen raib-Server zugute kommt (Clustering).
Nun eine Liste aller eCommerce Funktionen:

eCommerce - Funktionen "XML-RPC-Verfügbar"

abu.ArtikelSuche(SuchStr: string): array of integer; { ARTIKEL_R }
// Suchmaschine für Artikelsuche

abu.ArtikelPreis(AUSGABEART_R, ARTIKEL_R:integer): double;
// liefert den Preis des Artikels in dieser Ausgabeart
// kostenlos = 0; //
// cPreis_vergriffen = -1.0; // Artikel nicht mehr lieferbar.
// cPreis_aufAnfrage = -2.0; // keine Preisinformation verfügbar.

abu.Land(LAND_R: integer): string;
// liefert die Landesbezeichnung (als ISO-Kürzel)

abu.KontoInfo(PERSON_R: integer): double;
// liefert den Kontostand des Kunden (zu zahlen!)
// erzeugt als Nebeneffekt die aktuelle "Mahnung.html"

abu.BestellInfo(PERSON_R: integer): integer;
// liefert den Lieferrückstand des Lieferanten (Erwartete Mengen!)
// erzeugt als Nebeneffekt die aktuelle "Bestellung.html"

abu.Bestellen(PERSON_R: integer): integer;
// erstellt aus dem Einkaufswagen des Kunden eine tatsächliche
// Bestellung. Die (neue) Beleg-Nummer wird zurückgegeben.
//

abu.ArtikelVersendetag(AUSGABEART_R, ARTIKEL_R:integer): integer;
//
// GELBE STATI
// 0=keine Info über Verfügbarkeit vorhanden
//
// ROTE STATI:
// 1=entgültig vergriffen
// 2=zur Zeit vergriffen, Neuauflage jedoch ungewiss
// 3=zur Zeit vergriffen, Neuauflage jedoch sicher
//
//
// GRÜNE STATI:
// 10=heute lieferbar (=ist am Lager, ohne Mengenangabe)
// 11=morgen lieferbar (=wurde z.B. mit dieser Zusage bereits bestellt und kommt morgen)
// 12=in 2 Tagen lieferbar... (=ist z.B. in dieser Zeit zu beschaffen)
// 13=in 3 Tagen lieferbar...
// 14= ... usw ...
//
// GRÜNE STATI:
// 101= heute lieferbar (=ist am Lager, Lagermenge=1)
// 102= heute lieferbar (=ist am Lager, Lagermenge=2)
// 103= heute lieferbar (=ist am Lager, Lagermenge=3)
// ... usw.
//
// GRÜNE STATI:
// >20020101= Konkretes Lieferdatum (z.B. Erscheinungsdatum!)
// 20031003= am 03.10.2003 lieferbar (da es z.B. an diesem Tag erscheint)
// (Vorbestellungen natürlich möglich)
//

abu.Verlag(VERLAG_R:integer): string;
// Names des Verlages zu einem Verlags-RID
// ACHTUNG: aus geschichtlichen Gründen sind VERLAG_R zumeist als PERSON_R(s)
// zu verstehen!

abu.Versandkosten(PERSON_R:integer): double;
// Liefert passend zum "Kunden,Umfang des Einkaufswagen,Versandart des Kunden" die
// passenden Versandkosten. Im Moment als dummy immer 3,33 €.

abu.ArtikelInfo(AUSGABEART_R, ARTIKEL_R, LAND_R, VERLAG_R) : double, string;
// Multi-Info-Funktion für weitere Informationen zu Artikel-Daten
// Ergebnisse: Preis, "ISO-Landeskennzeichen" "-" "Verlag"

abu.BasePlug():array of string;
// liefert diverse Informations-String:
// 1) Datenbankname
// 2) OrgaMon Versions-Nummer
// 3) IBO Versions-Nummer
// 4) Indy Versions-Nummer
// 5) PDF Pfad (public)
// 6) Musik Pfad
// 7) HTML-Pfad (Rechnungen)
// 8) Bild-URL
// * Mit Hilfe des Verbindungsstrings sollte auf die entsprechende Datenbank
// konnektiert werden.
// * In der Datenbank sollten nun alle weiteren Parameter, den Shop betreffend
// eingegeben sein!
// für den Shop wichtige Parameter:
//
// MusicPath=\\Linus\user\abu\Delphi\abu\Musik\
// PDFPath=\\Linus\user\hebu\HeBu PDF\A4PDF\
// XMLRPCHost=BRUTUS
// XMLRPCPort=3049
//

abu.ArtikelRabattPreis(AUSGABEART_R,ARTIKEL_R,PERSON_R) : array of double;
//
// wie Artikel-Preis, soll jedoch bei Kunden mit Rabatt-Code verwendet werden,
// diese Funktion liefert noch die Rabatt-Zahl dazu!
//

abu.PersonNeu : integer; { PERSON_R }
//
// Eine neue Person wird angelegt. Der (neue) RID wird als Ergebnis ge-
// liefert. Der Webshop kann nun weitere Eintragungen machen.
//

abu.Ort(PERSON_R) : string; { Adress-Ortsangabe }
//
// Zu der angegebenen Person wird die Orts-Angabe zusammengestellt.
// Dazu wird Land, Plz, Ortsname und Ortsteil landesspeziefisch
// kombiniert.

abu.Rabatt(PERSON_R) : boolean;
// Zu der angegebenen Person wird ermittelt, ob sie Rabatte bekommt.
// Wenn ja, wird true, andernfalls false zurückgegeben.

abu.Preis(AUSGABEART_R,ARTIKEL_R,PERSON_R) : array of double;
//
// Ersetzt in Zukunft die beiden Methoden abu.ArtikelPreis und abu.ArtikelRabattPreis
// Falls der Kunde Rabatte bekommt, was beim Login mit abu.Rabatt geprüft wird,
// wird der Funktion der wirkliche PERSON_R übergeben, andernfalls 0.
// Rückgabewerte sind der Preis und der Rabatt (in Prozent, 0 bei PERSON_R == 0).

eCommerce - Funktionen "intern verfügbar"

procedure e_w_BedarfsAnzeige(AUSGABEART_R, ARTIKEL_R, POSTEN_R, MENGE: integer; Motivation: eMotivation);
// dem Agenten signalisieren, dass Bestell-Bedarf besteht

procedure e_w_Wareneingang(AUSGABEART_R, ARTIKEL_R, MENGE: integer);
// Waren im System verteilen

function e_r_Lieferant(ARTIKEL_R, MENGE: integer): integer; {PERSON_R}
// Ermittelt den Lieferanten zu diesem Artikel

function e_w_BestellBeleg(PERSON_R: integer): integer; {BBELEG_R}
// liefert die Nummer eines Bestellbelegs, ev. wird einer neu erzeugt

function e_r_Menge(AUSGABEART_R, ARTIKEL_R: integer): integer; { MENGE }
// liefert die Lagermenge dieses Artikels in der angegebenen
// Ausprägungsart

function e_w_Menge(AUSGABEART_R, ARTIKEL_R, MENGE: integer): integer; { MENGE }
// bucht eine Lagermenge ab oder zu, oder als read-Only
// liefert die neue Lagermenge

WebShop

2005-02-28T20:07:36Z

192.168.115.13: /* Interbase-Extension für PHP laden */

== 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ünschte Datei herunterladen und entpacken.
Das Setup Programm ausführen. An entsprechender Stelle "Service für alle User bereit
stellen" auswählen.

Zum Test, ob der Server läuft, im Internet Browser einfach "localhost" oder die
IP-Adresse "127.0.0.1" eingeben. Dann müsste 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ü um ein 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ürs erste reichen. Jedoch lassen sich in dieser Datei noch wesentlich mehr Funktionen
einstellen, was zu erklären über den Umfang dieses HowTos hinausgehen würde.
Die einzelnen Einträge sind in englisch kommentiert und erklären 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ätten dieses Verzeichnis gewählt.

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ügen, da es zukünftige Updates erleichtert.
Es muss dann nämlich 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ächstes Kapitel unter PHP5).

Dann muss sie im Editor geöffnet und der Eintrag "register_globals = Off" muss auf "On" gesetzt werden.
Das ist wichtig, da ansonsten keine Variablen von einem Skript zum anderen übergeben werden können.
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 über das Startmenü die Apache-Konfigurations-Datei "httpd.conf" im Editor (Notepad) geöffnet und
ans Ende oder unter eine Stelle mit ähnlichen Einträgen werden folgende drei Zeilen eingefügt:

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öglich, dass die mittlere Zeile ("AddModule...") schon an anderer Stelle in der Datei steht,
dann muss sie nicht mehr eingefügt werden oder kann mit einem "#"-Zeichen als Kommentar unschädlich gemacht werden.

Falls ein Apache 2.0.x-Server benutzt wird muss in der ersten Zeile anstelle von "php4apache.dll" der
Dateiname "php4apache2.dll" stehen.

Nach diesen Änderungen 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ährend der Apache Server läuft.
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".

== Interbase-Extension für PHP laden ==

Damit PHP auf Interbase/Firebird Datenbanken zugreifen kann, müssen die Routinen, die das ermöglichen, beim
Start von PHP als Erweiterung geladen werden. Dies geschieht mit Hilfe zweier Einträge in der "php.ini".
Erstens muss der Eintrag "extension_dir= " auf das Verzeichnis mit den Extension-Dlls gesetzt werden. Diese
befinden sich standardmäßig 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:

extension_dir = "C:\Programme\Php\extensions"

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ührt. 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.

Der WebShop erfordert, dass Timestamps im richtigen Format übergeben 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ür die Interbase-Anbindung zur Verfügung stehen.
Falls dies nicht so ist, liegt es vielleicht daran, das die "php.ini" im falschen Verzeichnis liegt (Lösung 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ändern.

== XML-Remote-Procedure-Calls für PHP und DELPHI/KYLIX ==

Grundsätzliche 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/

== Systemanforderungen beim Benutzer/Client ==

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

WebShop

2005-02-28T11:26:16Z

192.168.115.13: /* PHP installieren */

== 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ünschte Datei herunterladen und entpacken.
Das Setup Programm ausführen. An entsprechender Stelle "Service für alle User bereit
stellen" auswählen.

Zum Test, ob der Server läuft, im Internet Browser einfach "localhost" oder die
IP-Adresse "127.0.0.1" eingeben. Dann müsste 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ü um ein 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ürs erste reichen. Jedoch lassen sich in dieser Datei noch wesentlich mehr Funktionen
einstellen, was zu erklären über den Umfang dieses HowTos hinausgehen würde.
Die einzelnen Einträge sind in englisch kommentiert und erklären 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ätten dieses Verzeichnis gewählt.

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ügen, da es zukünftige Updates erleichtert.
Es muss dann nämlich 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ächstes Kapitel unter PHP5).

Dann muss sie im Editor geöffnet und der Eintrag "register_globals = Off" muss auf "On" gesetzt werden.
Das ist wichtig, da ansonsten keine Variablen von einem Skript zum anderen übergeben werden können.
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 über das Startmenü die Apache-Konfigurations-Datei "httpd.conf" im Editor (Notepad) geöffnet und
ans Ende oder unter eine Stelle mit ähnlichen Einträgen werden folgende drei Zeilen eingefügt:

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öglich, dass die mittlere Zeile ("AddModule...") schon an anderer Stelle in der Datei steht,
dann muss sie nicht mehr eingefügt werden oder kann mit einem "#"-Zeichen als Kommentar unschädlich gemacht werden.

Falls ein Apache 2.0.x-Server benutzt wird muss in der ersten Zeile anstelle von "php4apache.dll" der
Dateiname "php4apache2.dll" stehen.

Nach diesen Änderungen 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ährend der Apache Server läuft.
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".

== Interbase-Extension für PHP laden ==

Damit PHP auf Interbase/Firebird Datenbanken zugreifen kann, müssen die Routinen, die das ermöglichen, beim
Start von PHP als Erweiterung geladen werden. Dies geschieht mit Hilfe zweier Einträge in der "php.ini".
Erstens muss der Eintrag "extension_dir= " auf das Verzeichnis mit den Extension-Dlls gesetzt werden. Diese
befinden sich standardmäßig 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:

extension_dir = "C:\Programme\Php\extensions"

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ührt. 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.

Jetzt sollten die PHP-Routinen für die Interbase-Anbindung zur Verfügung stehen.
Falls dies nicht so ist, liegt es vielleicht daran, das die "php.ini" im falschen Verzeichnis liegt (Lösung 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ändern.

== XML-Remote-Procedure-Calls für PHP und DELPHI/KYLIX ==

Grundsätzliche 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/

== Systemanforderungen beim Benutzer/Client ==

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