From 2e9d34aa27890e304e9e4aadcddec262b76554bb Mon Sep 17 00:00:00 2001 From: Moritz Bunkus Date: Mon, 1 Feb 2010 11:58:04 +0100 Subject: [PATCH] FastCGI-Dokumentation erweitert --- doc/INSTALL.fcgi | 33 +++++++++++++++++++-------------- 1 file changed, 19 insertions(+), 14 deletions(-) diff --git a/doc/INSTALL.fcgi b/doc/INSTALL.fcgi index 3f3fdeae7..1aa0ad470 100644 --- a/doc/INSTALL.fcgi +++ b/doc/INSTALL.fcgi @@ -63,19 +63,21 @@ Variante 2: Allow from All - + Order Deny,Allow Deny from All -Variante 1 startet einfach jeden Lx-Office Request als fcgi Prozess. Für sehr -große Installationen ist das die schnellste Version, benötigt aber sehr viel -Arbeitspseicher (ca. 2GB). +Variante 1 startet einfach jeden Lx-Office Request als fcgi +Prozess. Für sehr große Installationen ist das die schnellste Version, +benötigt aber sehr viel Arbeitspseicher: wurden alle Module mindestens +einmal aufgerufen, so werden dauerhaft ca. 2GB pro Installation +belegt. Variante 2 startet nur einen zentralen Dispatcher und lenkt alle Scripte auf diesen. Dadurch dass zur Laufzeit öfter mal Scripte neu geladen werden gibt es -hier kleine Performance Einbußen. +hier kleine Performance Einbußen. Trotzdem ist diese Variante vorzuziehen. =head2 Entwicklungsaspekte @@ -89,12 +91,15 @@ Templates editiert werden muss der Server neu gestartet werden. Es ist möglich die gleiche Lx-Office Version parallel unter cgi und fastcgi zu betreiben. Da nimmt man Variante 2 wie oben beschrieben, und ändert die -MatchAlias Zeile auf eine andere URL, und lässt alle anderen URLs auch +AliasMatch Zeile auf eine andere URL, und lässt alle anderen URLs auch weiterleiten: + # Zugriff ohne FastCGI + Alias /web/path/to/lx-office-erp /path/to/lx-office-erp + # Zugriff mit FastCGI: AliasMatch ^/web/path/to/lx-office-erp-fcgi/[^/]+\.pl /path/to/lx-office-erp/dispatcher.fpl - AliasMatch ^/web/path/to/lx-office-erp-fcgi/(.*) /path/to/lx-office-erp/$1 + Alias /web/path/to/lx-office-erp-fcgi/ /path/to/lx-office-erp/ Dann ist unter C die normale Version erreichbar, und unter C die FastCGI Version. @@ -103,23 +108,23 @@ Bei der Entwicklung f dass das Programm in einer Endlosschleife läuft, müssen folgende Aspekte geachtet werden: -=head3 C, C, C, C, C +=head3 Programmende und Ausnahmen: C, C, C, C, C -Fehler die normalerweise dass Programm sofort beenden (fatale Fehler) werden -mit dem FastCGI Dispatcher abgefangen, um das Programm amLaufen zu halten. Man +Fehler, die dass Programm normalerweise sofort beenden (fatale Fehler), werden +mit dem FastCGI Dispatcher abgefangen, um das Programm am Laufen zu halten. Man kann mit C, C oder C Fehler ausgeben, die dann vom Dispatcher angezeigt werden. Die Lx-Office eigene C<$::form->error()> tut im Prinzip das Gleiche, mit ein paar Extraoptionen. C und C hingegen werden nicht abgefangen. C wird direkt nach STDERR, also in Server Log eine Nachricht schreiben, und C wird die Ausführung beenden. -Prinzipiell ist es ein Beinbruch, wenn sich der Prozess beendet, fcgi wird ihn -sofort neu starten, allerdings sollte das die Ausnahme sein. Quintessenz: Bitte -kein C oder C benutzen, alle anderen Excepionmechanismen sind ok. +Prinzipiell ist es kein Beinbruch, wenn sich der Prozess beendet, fcgi wird ihn +sofort neu starten. Allerdings sollte das die Ausnahme sein. Quintessenz: Bitte +kein C oder C benutzen, alle anderen Exceptionmechanismen sind ok. =head3 Globale Variablen -Um zu vermeiden, dass Informationen von einem Request in einen anderen gelangen +Um zu vermeiden, dass Informationen von einem Request in einen anderen gelangen, müssen alle globalen Variablen vor einem Request sauber initialisiert werden. Das ist besonders wichtig im C<$::cgi> und C<$::auth> Objekt, weil diese nicht gelöscht werden pro Instanz, sondern persistent gehalten werden. -- 2.20.1