Live-Seiten: Unterschied zwischen den Versionen
Ole (Diskussion | Beiträge) K |
|||
Zeile 16: | Zeile 16: | ||
==SPML-Seiten mit Benutzerdefinierten Templates== | ==SPML-Seiten mit Benutzerdefinierten Templates== | ||
− | Je nach Anwendungsfall kann es auch sinvoll sein den SPML-Code zunächst in ein Template zu schreiben, sodaß jeder Artikel der dieses Template verwendet, den SPML-Code enthält. Da SPML aber auch für die Template-Sprache selber verwendet wird ist darauf zu achten, | + | Je nach Anwendungsfall kann es auch sinvoll sein den SPML-Code zunächst in ein Template zu schreiben, sodaß jeder Artikel der dieses Template verwendet, den SPML-Code enthält. Da SPML aber auch für die Template-Sprache selber verwendet wird, ist darauf zu achten, daß SPML-Code der nicht zur Generierungszeit der Seite ausgeführt werden soll, in <code><sp:code></code>-Tags stehen muß. Code innerhalb dieser Tags wird zur Generierungszeit ignoriert und direkt in die Seite geschrieben. Dieser SPML-Code wird dann erst bei Aufruf der Seite ausgeführt. |
− | So ist es | + | So ist es möglich Teile die zur Generierungszeit fest stehen schon beim Erzeugen der Seite zu ermitteln und nur die 'echten' Liveanteile der SPML-Seite beim Aufruf auszuführen. |
− | Im Out-Teil des Templates sollte als erstes das Template SPML Standard Output (Anchor: template.spml.standard.output) includet werden, da dieses den notwendigen SPML-Header in die Seite schreibt. | + | Im Out-Teil des Templates sollte als erstes das Template SPML Standard Output (Anchor: <code>template.spml.standard.output<code>) includet werden, da dieses den notwendigen SPML-Header in die Seite schreibt. |
<source lang="xml"> | <source lang="xml"> | ||
Zeile 35: | Zeile 35: | ||
==IES Nutzer anmelden== | ==IES Nutzer anmelden== | ||
− | Um Daten des IES lesen und schreiben zu können ist ein angemeldeter Nutzer nötig. Mit dessen Rechten wird entschieden ob bestimmte Daten gelesen oder geschrieben werden dürfen. | + | Um Daten des IES lesen und schreiben zu können ist ein angemeldeter Nutzer nötig. Mit dessen Rechten wird entschieden, ob bestimmte Daten gelesen, oder geschrieben werden dürfen. |
− | Es gibt mehrere Möglichkeiten einen Nutzer anzumelden | + | Es gibt mehrere Möglichkeiten einen Nutzer anzumelden: |
*Über ein Login-Formular, das an den LoginHandler (siehe LoginHandler) gesendet wird. | *Über ein Login-Formular, das an den LoginHandler (siehe LoginHandler) gesendet wird. | ||
− | *Mit Hilfe von sp:login | + | *Mit Hilfe von <code>sp:login</code> |
*Implizit über die Module-Konfiguration | *Implizit über die Module-Konfiguration | ||
*Über Basic-Authentikation | *Über Basic-Authentikation | ||
===Login über ein Formular=== | ===Login über ein Formular=== | ||
− | Mit Hilfe des LoginHandlers können Nutzer mit Hilfe von Formular-Feldern angemeldet werden. Dazu wird ein Formular wie folgendes Verwendet. | + | Mit Hilfe des <code>LoginHandlers</code> können Nutzer mit Hilfe von Formular-Feldern angemeldet werden. Dazu wird ein Formular wie folgendes Verwendet. |
<source lang="xml"> | <source lang="xml"> | ||
Zeile 63: | Zeile 63: | ||
</source> | </source> | ||
− | Mit sp:form wird das Formular erzeugt. Mit uri wird angegeben welche Seite nach dem ausgeführten Login aufgerufen werden soll. Mit handler wird der LoginHandler angegeben, um das Login durchzuführen. Die für den LoginHandler erforderlichen Felder SYS_LGIN_login, SYS_LGIN_password und SYS_LGIN_client müssen mit angegeben werden. Für SYS_LGIN_client kann entweder die Client ID oder der Anchor des Clients verwendet werden. | + | Mit <code>sp:form</code> wird das Formular erzeugt. Mit <code>uri</code> wird angegeben, welche Seite nach dem ausgeführten Login aufgerufen werden soll. Mit <code>handler</code> wird der LoginHandler angegeben, um das Login durchzuführen. Die für den LoginHandler erforderlichen Felder <code>SYS_LGIN_login</code>, <code>SYS_LGIN_password</code> und <code>SYS_LGIN_client</code> müssen mit angegeben werden. Für <code>SYS_LGIN_client</code> kann entweder die Client ID oder der Anchor des Clients verwendet werden. |
− | Um zu verhindern | + | Um zu verhindern, daß Seiten aufgerufen werden können, ohne daß ein Nutzer angemeldet ist, können bestimmte Seiten geschützt werden. Weiter solle im Fehlerfall (ungültiger Login, Aufruf einer geschützen Seiten von einem nicht angemeldeten Nutzer) eine definierte Seite aufgerufen werden. Dazu ist in der Konfigurationsdatei <code>DOCUMENT_ROOT/WEB-INF/ies-module.xml</code> des entsprechenden Publikationsbereich folgendes einzutragen: |
<source lang="xml"> | <source lang="xml"> | ||
Zeile 85: | Zeile 85: | ||
:Hier wird definiert welche Seiten ohne Login aufgerufen werden dürfen. | :Hier wird definiert welche Seiten ohne Login aufgerufen werden dürfen. | ||
− | <allowed pattern="/login.spml" /> aufruf von login.spml ist immer erlaubt. | + | <code><allowed pattern="/login.spml" /></code> aufruf von <code>login.spml</code> ist immer erlaubt. |
− | <denied pattern="/.*" /> alle anderen Seiten dürfen nicht aufgerufen werden | + | <code><denied pattern="/.*" /></code> alle anderen Seiten dürfen nicht aufgerufen werden. |
− | Hierbei ist noch zu beachten, | + | Hierbei ist noch zu beachten, daß nur die Seiten geschützt werden, die vom IES ausgeführt/ausgeliefert werden (HTML-Seiten, PHP-Seiten, Bilder, CSS, ... gehören in der Regeln nicht dazu). Je nach gesetzten JkMount's <code>(mod_jk)</code> sind das möglicherweise nur <code>*.spml</code> und <code>*.jsp</code> Dateien. |
− | ;<exception> | + | ;<code><exception></code> |
− | :Werden Seiten von nicht angemeldeten Nutzern aufgerufen, wird von der Seite eine AccessDeniedException geworfen. Um allgemein diese Fehler abzufangen, wird angegeben für welche URL's welche Exception abgefangen und welche Seite danach aufgerufen werden soll. Hier werden für alle Seiten alle Exception abgefangen und anschließend die /login.spml aufgerufen. | + | :Werden Seiten von nicht angemeldeten Nutzern aufgerufen, wird von der Seite eine <code>AccessDeniedException</code> geworfen. Um allgemein diese Fehler abzufangen, wird angegeben für welche URL's welche Exception abgefangen und welche Seite danach aufgerufen werden soll. Hier werden für alle Seiten alle Exception abgefangen und anschließend die <code>/login.spml</code> aufgerufen. |
− | Nach dem sie die Datei ies-module.xml geändert haben muß das Modul des Publikationsbereiches neu geladen werden, damit die Änderungen wirksam werden (Siehe Administration des IES). | + | Nach dem sie die Datei <code>ies-module.xml</code> geändert haben, muß das Modul des Publikationsbereiches neu geladen werden, damit die Änderungen wirksam werden (Siehe Administration des IES). |
==Daten über Liveseiten erzeugen, ändern und löschen== | ==Daten über Liveseiten erzeugen, ändern und löschen== | ||
− | Wie auch IES-Module können auch Liveseiten Daten im IES erzeugen, ändern und löschen. Dazu werden Handler angesprochen, die über HTTP GET- bzw. POST-Parameter gesteuert werden. | + | Wie auch IES-Module können auch Liveseiten Daten im IES erzeugen, ändern und löschen. Dazu werden Handler angesprochen, die über <code>HTTP GET</code>- bzw. <code>POST</code>-Parameter gesteuert werden. |
===Artikel anlegen und ändern=== | ===Artikel anlegen und ändern=== | ||
− | Um einen Artikel über eine Liveseite anzulegen, muß der InformationHandler verwendet werden. Dieser wird über seinen vollen Klassennamen com.sitepark.ies.control.jsp.handler.InformationHandler angesprochen. Siehe InformationHandler. | + | Um einen Artikel über eine Liveseite anzulegen, muß der <code>InformationHandler</code> verwendet werden. Dieser wird über seinen vollen Klassennamen <code>com.sitepark.ies.control.jsp.handler.InformationHandler</code> angesprochen. Siehe [[InformationHandler]]. |
Die Artikeldaten können z.B. in Formularen eingegeben und über Submit an den IES gesendet werden. Der Handler führt die Aktionen aus, Die SPML-Seite stellt anschließend die Ergebnisse dar. | Die Artikeldaten können z.B. in Formularen eingegeben und über Submit an den IES gesendet werden. Der Handler führt die Aktionen aus, Die SPML-Seite stellt anschließend die Ergebnisse dar. | ||
− | Die | + | Die Minimalanforderungen, um einen Artikel anzulegen oder zu ändern sind: |
*Es muß ein Nutzer angemeldet sein, der die nötigen Rechte hat einen Artikel in einem Pool anzulegen | *Es muß ein Nutzer angemeldet sein, der die nötigen Rechte hat einen Artikel in einem Pool anzulegen | ||
− | *Um einen neu angelegten Artikel direkt darzustellen muß die Variable SYS_element mit dem Wert von SYS_INFE_id gesetzt werden. In SYS_INFE_id wird die ID des neu angelegten Artikels gesetzt. SYS_element definiert das | + | *Um einen neu angelegten Artikel direkt darzustellen, muß die Variable <code>SYS_element</code> mit dem Wert von <code>SYS_INFE_id</code> gesetzt werden. In <code>SYS_INFE_id</code> wird die ID des neu angelegten Artikels gesetzt. <code>SYS_element</code> definiert das aktuelle Element |
<source lang="xml"> | <source lang="xml"> | ||
− | + | <sp:set name="SYS_element" object="SYS_INFE_id"/> | |
</source> | </source> | ||
− | Nur wenn diese Variable gesetzt ist, kann auf den aktuellen Artikel mit system.information zugegriffen werden. | + | Nur wenn diese Variable gesetzt ist, kann auf den aktuellen Artikel mit <code>system.information</code> zugegriffen werden. |
− | *Um einen Artikel zu ändern, muß das Feld SYS_INFE_id mit der zu ändernden Artikel-ID und SYS_INFE_action mit dem Wert update mitgesendet werden. | + | *Um einen Artikel zu ändern, muß das Feld <code>SYS_INFE_id</code> mit der zu ändernden Artikel-ID und <code>SYS_INFE_action</code> mit dem Wert <code>update</code> mitgesendet werden. |
− | *Um einen Artikel zu erzeugen müssen die Felder SYS_INFE_articleType für die Typ des Artikels (Artikel, Medium, Resource), SYS_INFE_action mit dem Wert create und SYS_INFE_target mit der ID des Pools, in dem der Artikel angelegt werden soll mitgegeben werden | + | *Um einen Artikel zu erzeugen müssen die Felder <code>SYS_INFE_articleType</code> für die Typ des Artikels (Artikel, Medium, Resource), <code>SYS_INFE_action</code> mit dem Wert <code>create</code> und <code>SYS_INFE_target</code> mit der <code>ID</code> des Pools, in dem der Artikel angelegt werden soll mitgegeben werden |
− | *Für den | + | *Für den Artikel muß mit dem Feld <code>SYS_INFE_name</code> ein Name angegeben werden. |
− | Damit wird ein Artikel angelegt oder geändert, kann aber noch nicht mit Infosite weiter bearbeitet werden. Dazu fehlen noch einige Steuerfelder, die Infosite benötigt werden um in dessen Umgebung lauffähig zu sein. Bei den noch nötigen Feldern handelt es sich um Content-Felder, die mit Hilfe von sp:hidden erzeugt werden können. | + | Damit wird ein Artikel angelegt oder geändert, kann aber noch nicht mit Infosite weiter bearbeitet werden. Dazu fehlen noch einige Steuerfelder, die Infosite benötigt werden, um in dessen Umgebung lauffähig zu sein. Bei den noch nötigen Feldern handelt es sich um Content-Felder, die mit Hilfe von <code>sp:hidden</code> erzeugt werden können. |
− | Die Felder entsprechen den Angaben für den Artikelpool | + | Die Felder entsprechen den Angaben für den Artikelpool in der Artikelpoolverwaltung von Infosite5, in dem der Artikel angelegt werden soll. |
Da sich die Werte auf den Pool, in dem der Artikel abgelegt werden soll beziehen, kann dies z.B. so erfolgen: | Da sich die Werte auf den Pool, in dem der Artikel abgelegt werden soll beziehen, kann dies z.B. so erfolgen: | ||
Zeile 131: | Zeile 131: | ||
</source> | </source> | ||
− | In diesem Beispiel wird der gleiche Pool verwendet, in dem auch die SPML-Seite selber liegt. Im Normalfall werden die angelegten Artikel | + | In diesem Beispiel wird der gleiche Pool verwendet, in dem auch die SPML-Seite selber liegt. Im Normalfall werden die angelegten Artikel vermutlich in anderen Pools liegen. Das Feld <code>editor_template</code> wird in diesem Beispiel auf das erste Template (alphabetisch sortiert) in dem Template-Pool gesetzt. Hier kann auch z.B. über <code>Anchor</code> ein bestimmtes Template angegeben werden. Es ist nur darauf zu achten, daß das Template auch in dem über <code>editor_template_pool</code> angegebenen Template-Pool enthalten ist. |
In dem Artikelpool-Bereich können folgende Angaben für den Pool gemacht werden. | In dem Artikelpool-Bereich können folgende Angaben für den Pool gemacht werden. | ||
;Template Container | ;Template Container | ||
− | :Dieses Feld entspricht dem | + | :Dieses Feld entspricht dem <code>hidden</code>-Feld <code>template</code>. Folgende Anchor für Infosite-Container können verwendet werden: |
− | *gui.container.infosite.standard (Standard Infosite Container) | + | *<code>gui.container.infosite.standard</code> (Standard Infosite Container) |
− | *gui.container.infosite.media (Standard Medien Container) | + | *<code>gui.container.infosite.media</code> (Standard Medien Container) |
;Template für die Eigenschaften | ;Template für die Eigenschaften | ||
− | :Dieses Feld entspricht dem | + | :Dieses Feld entspricht dem <code>hidden</code>-Feld <code>registration_template</code>. Folgende Infosite-Templates können verwendet werden: |
− | *gui.container.infosite.standard.all (alle Artikel-Typen) | + | *<code>gui.container.infosite.standard.all</code> (alle Artikel-Typen) |
− | *gui.container.infosite.standard.page (nur Seiten anlegen) | + | *<code>gui.container.infosite.standard.page</code> (nur Seiten anlegen) |
− | *gui.container.infosite.standard.media (nur Medien anlegen) | + | *<code>gui.container.infosite.standard.media</code> (nur Medien anlegen) |
− | *gui.container.infosite.standard.resource (nur Resourcen anlegen) | + | *<code>gui.container.infosite.standard.resource</code> (nur Resourcen anlegen) |
− | *gui.container.infosite.standard.pageAutoName (nur Seiten ohne Namensvergabe anlegen) | + | *<code>gui.container.infosite.standard.pageAutoName</code> (nur Seiten ohne Namensvergabe anlegen) |
− | *gui.container.infosite.standard.pageAndMedia (nur Seiten und Medien anlegen) | + | *<code>gui.container.infosite.standard.pageAndMedia</code> (nur Seiten und Medien anlegen) |
− | *gui.container.infosite.standard.pageAndResource (nur Seiten und Resourcen anlegen) | + | *<code>gui.container.infosite.standard.pageAndResource</code> (nur Seiten und Resourcen anlegen) |
;Templatepool für die Bearbeitung | ;Templatepool für die Bearbeitung | ||
− | :Dieses Feld entspicht dem | + | :Dieses Feld entspicht dem <code>hidden</code>-Feld <code>editor_template_pool</code>. Hier muß eine ID eines Templates-Pools angegeben werden in dem sich die zu verwendenden Templates befinden |
− | Hier ein kleines Beispiel für das | + | Hier ein kleines Beispiel für das Anlegen und Bearbeiten eines Artikels: |
<source lang="xml"> | <source lang="xml"> | ||
Zeile 195: | Zeile 195: | ||
===Artikel publizieren und depublizieren=== | ===Artikel publizieren und depublizieren=== | ||
Um Artikel zu publizieren bzw. zu depublizieren müssen folgende Felder pro Publikationsbereich mitgesendet werden: | Um Artikel zu publizieren bzw. zu depublizieren müssen folgende Felder pro Publikationsbereich mitgesendet werden: | ||
− | ;SYS_INFE_publicationArea | + | ;<code>SYS_INFE_publicationArea</code> |
− | : | + | :<code>ID</code> des Publikationsbereiches in dem der Artikel publiziert bzw. depubliziert werden soll. z.B. <code>pub1</code> |
− | ;SYS_INFE_publicationChecked | + | ;<code>SYS_INFE_publicationChecked</code> |
− | :Wird diese Feld mitgesendet und hat es als Wert die | + | :Wird diese Feld mitgesendet und hat es als Wert die ID des Publikationsbereiches, so wird der Artikel in diesem Publikationsbereich publiziert. Wird nur das Feld <code>SYS_INFE_publicationArea</code> (ohne <code>SYS_INFE_publicationChecked</code>) mitgesendet, wird der Artikel aus dem Publikationsbereich depubliziert. |
− | ;SYS_INFE_publicationTemplate | + | ;<code>SYS_INFE_publicationTemplate</code> |
− | :Hiermit wird das Template angegeben mit der der Artikel publiziert werden soll. Theoretisch ist es möglich für die Ein- und Ausgabe unterschiedliche Templates anzugeben. Da aber Infosite5 dies nicht unterstüzt ist davon abzuraten. Bitte geben sie hier für alle Publikationsbereich das Template an, | + | :Hiermit wird das Template angegeben mit der der Artikel publiziert werden soll. Theoretisch ist es möglich für die Ein- und Ausgabe unterschiedliche Templates anzugeben. Da aber Infosite5 dies nicht unterstüzt ist davon abzuraten. Bitte geben sie hier für alle Publikationsbereich das Template an, daß sie auch für das Feld <code>editor_template</code> verwendet haben. |
− | Die Felder können z.B. über | + | Die Felder können z.B. über <code>hidden</code>-Felder mitgesendet werden. <code>preview</code> und <code>www</code> sind die Anchor der Publikationsbereiche. |
<source lang="xml"> | <source lang="xml"> | ||
<input type="hidden" name="SYS_INFE_publicationArea" value="<sp:print name="${!{preview}}"/>"> | <input type="hidden" name="SYS_INFE_publicationArea" value="<sp:print name="${!{preview}}"/>"> | ||
Zeile 215: | Zeile 215: | ||
==PHP integration== | ==PHP integration== | ||
− | Es kann Sinnvoll sein SPML-Liveseiten nicht direkt aufzurufen, sondern in PHP-Seiten einzubetten. Dazu müssen die PHP-Seiten einen eigenen Request an die SPML-Seite senden. Dabei benötigt die SPML-Seite | + | Es kann Sinnvoll sein SPML-Liveseiten nicht direkt aufzurufen, sondern in PHP-Seiten einzubetten. Dazu müssen die PHP-Seiten einen eigenen Request an die SPML-Seite senden. Dabei benötigt die SPML-Seite möglicherweise auch die Request-Parameter, die an die PHP-Seite gesendet wurden. Um die SPML-Seite möglichst einfach einzubinden steht die PHP-Class <code>RequestDispatcher.class.php</code> aus der <code>phplib</code> von Sitepark zur Verfügung. |
− | Für diese Art der | + | Für diese Art der Integration sind noch ein paar PHP-Besonderheiten zu beachten. |
;Gleichnamige Request-Parameter bzw. Formularfelder | ;Gleichnamige Request-Parameter bzw. Formularfelder | ||
:Werden an eine PHP-Seite zwei gleichnamige Request-Parameter bzw. Formularfelder gesendet, wird von PHP immer nur der letzte Parameter verwendet. Wird also z.B. die URL | :Werden an eine PHP-Seite zwei gleichnamige Request-Parameter bzw. Formularfelder gesendet, wird von PHP immer nur der letzte Parameter verwendet. Wird also z.B. die URL | ||
Zeile 231: | Zeile 231: | ||
Siehe hierzu auch http://www.php.net/manual/de/faq.html.php#faq.html.arrays | Siehe hierzu auch http://www.php.net/manual/de/faq.html.php#faq.html.arrays | ||
− | ; | + | ;Modifikationen von Request-Parametern und Formularfeldern durch PHP |
− | :Enthalten Namen von Request-Parametern oder Formularfeldern bestimmte Zeichen wird der Name von PHP modifiziert. Aufgrund der oben Array-Regel werden z.B. alle Zeichen nach einem [] abgeschnitten. Wird z.B. ein Request-Parameter mit dem Namen | + | :Enthalten Namen von Request-Parametern oder Formularfeldern bestimmte Zeichen wird der Name von PHP modifiziert. Aufgrund der oben Array-Regel werden z.B. alle Zeichen nach einem <code>[]</code> abgeschnitten. Wird z.B. ein Request-Parameter mit dem Namen |
<source lang="xml"> | <source lang="xml"> | ||
sp_mainIterator[0].sp_text | sp_mainIterator[0].sp_text | ||
Zeile 240: | Zeile 240: | ||
sp_mainIterator | sp_mainIterator | ||
</source> | </source> | ||
− | zugreifbar. | + | zugreifbar. Desweiteren werden alle Punkte, die in einem Request-Parameternamen oder einem Formularfeldnamen enthalten sind durch Unterstriche ersetzt. Wird z.B. ein Request-Parameter mit dem Namen |
<source lang="xml"> | <source lang="xml"> | ||
sp_text.de_DE | sp_text.de_DE | ||
Zeile 252: | Zeile 252: | ||
Siehe hierzu auch http://www.php.net/manual/de/faq.html.php#faq.html.form-image | Siehe hierzu auch http://www.php.net/manual/de/faq.html.php#faq.html.form-image | ||
− | Der IES verwendet Punkte und Eckige Klammern in mit sp:text, sp:textarea, sp:checkbox, sp:select, sp:hidden, sp:upload, sp:password und sp:radio erzeugten Formularfeldern. Würden diese so an eine PHP-Seite gesendet werden gingen nötige Informationen verloren. Um dies zu umgehen, können mit dem Attribute nameencoding des Tags sp:form die Formularfeldnamen encodet werden. Aus einem mit sp:form definiertem Formular | + | Der IES verwendet Punkte und Eckige Klammern in mit <code>sp:text</code>, <code>sp:textarea</code>, <code>sp:checkbox</code>, <code>sp:select</code>, <code>sp:hidden</code>, <code>sp:upload</code>, <code>sp:password</code> und <code>sp:radio</code> erzeugten Formularfeldern. Würden diese so an eine PHP-Seite gesendet werden, gingen nötige Informationen verloren. Um dies zu umgehen, können mit dem Attribute <code>nameencoding</code> des Tags <code>sp:form</code> die Formularfeldnamen encodet werden. Aus einem mit <code>sp:form</code> definiertem Formular |
<source lang="xml"> | <source lang="xml"> | ||
<sp:form uri="test.php"> | <sp:form uri="test.php"> | ||
Zeile 268: | Zeile 268: | ||
</source> | </source> | ||
− | Mit der Angabe eines nameencoding werden die Formularfeldnamen encodet. Aus einem mit sp:form | + | Mit der Angabe eines <code>nameencoding</code> werden die Formularfeldnamen encodet. Aus einem mit <code>sp:form</code> definiertem Formular |
<source lang="xml"> | <source lang="xml"> | ||
<sp:form uri="test.php" nameencoding="hex"> | <sp:form uri="test.php" nameencoding="hex"> | ||
Zeile 285: | Zeile 285: | ||
</source> | </source> | ||
− | Dadurch wird verhindert, das PHP die Formularfeldnamen modifiziert.Der weiter unten beschriebene RequestDispatcher.class.php bietet Methoden mit dem über den originalen Formularfeldnamen auf die Parameter zugegriffen werden kann. | + | Dadurch wird verhindert, das PHP die Formularfeldnamen modifiziert. Der weiter unten beschriebene <code>RequestDispatcher.class.php</code> bietet Methoden, mit dem über den originalen Formularfeldnamen auf die Parameter zugegriffen werden kann. |
===RequestDispatcher.class.php=== | ===RequestDispatcher.class.php=== | ||
− | Die PHP-Klasse RequestDispatcher ist Teil der Sitepark phplib. Sie soll die Integrations von Live-SPML-Seiten in PHP-Seiten vereinfachen, kann aber auch ganz allgemein zur Weiterleitung von HTTP-Requests verwendet werden. | + | Die PHP-Klasse <code>RequestDispatcher</code> ist Teil der Sitepark <code>phplib</code>. Sie soll die Integrations von Live-SPML-Seiten in PHP-Seiten vereinfachen, kann aber auch ganz allgemein zur Weiterleitung von HTTP-Requests verwendet werden. |
Bevor die Klasse verwendet werden kann, muß sie in die PHP-Seite geladen werden. Dies sollte wie folgt erfolgen: | Bevor die Klasse verwendet werden kann, muß sie in die PHP-Seite geladen werden. Dies sollte wie folgt erfolgen: | ||
− | require_once($_SERVER["DOCUMENT_ROOT"] . "/phplib/RequestDispatcher.class.php"); | + | <source>require_once($_SERVER["DOCUMENT_ROOT"] . "/phplib/RequestDispatcher.class.php");</source> |
Um den Dispatcher zu nutzen, muß eine Instanz der Klasse erzeugt werden: | Um den Dispatcher zu nutzen, muß eine Instanz der Klasse erzeugt werden: | ||
− | $dispatcher = new RequestDispatcher("www.domain.de"); | + | <source>$dispatcher = new RequestDispatcher("www.domain.de");</source> |
Dem Konstruktor wird der Host oder die IP-Adresse des Servers angegeben, an den die Request weitergeleitet werden soll. | Dem Konstruktor wird der Host oder die IP-Adresse des Servers angegeben, an den die Request weitergeleitet werden soll. | ||
− | $dispatcher->absorb(); | + | <source>$dispatcher->absorb();</source> |
− | Die Methode absorb() liest alle Request-Parameter, Request-Uploads Cookies, Session-Parameter und Server-Variablen ein, um sie mit der dispatch() Methode weiterzuleiten. | + | Die Methode <code>absorb()</code> liest alle Request-Parameter, Request-Uploads Cookies, Session-Parameter und Server-Variablen ein, um sie mit der <code>dispatch()</code>-Methode weiterzuleiten. Alternativ können auch z.B. nur Request-Parameter mit der Methode <code>absorbRequestParameter()</code> übernommen werden. Weitere Methoden sind <code>absorbRequestUploads()</code>, <code>absorbSessionVariables()</code>, <code>absorbCookies()</code> und <code>absorbServerVariables()</code>. Einzelnen Werte können mit <code>setParameter()</code>, <code>setFile()</code> und <code>setCookie()</code> setzten. Server- und Session-Variablen werden als HTTP-Parameter gesendet. |
− | Die Methode dispatch() führt den Request aus. Dieser Methode wird der Pfad zu der Seite angegeben, an den der Request weitergeleitet werden soll. Die Methode liefert true zurück, wenn der Request erfolgreich weitergeleitet wurde, sonst false. | + | Die Methode <code>dispatch()</code> führt den Request aus. Dieser Methode wird der Pfad zu der Seite angegeben, an den der Request weitergeleitet werden soll. Die Methode liefert <code>true</code> zurück, wenn der Request erfolgreich weitergeleitet wurde, sonst <code>false</code>. |
− | $success = $dispatcher->dispatch("/dir/file.spml"); | + | <source>$success = $dispatcher->dispatch("/dir/file.spml");</source> |
− | Der Dispatcher reichte alle GET- und POST-Parameter der PHP-Seite weiter. Der Request, den der Dispatcher ausfürt ist immer POST. Weiter werden alle Session-Variablen ($_SESSION) und alle Server ($_SERVER) als Parameter mitgesendet. Cookies werden | + | Der Dispatcher reichte alle <code>GET</code>- und <code>POST</code>-Parameter der PHP-Seite weiter. Der Request, den der Dispatcher ausfürt ist immer <code>POST</code>. Weiter werden alle Session-Variablen <code>($_SESSION)</code> und alle Server <code>($_SERVER)</code> als Parameter mitgesendet. Cookies werden als Cookies weitergereicht. |
Anschließend kann eine Fehlerbehandlung erfolgen oder z.B. der Response ausgegeben werden. | Anschließend kann eine Fehlerbehandlung erfolgen oder z.B. der Response ausgegeben werden. | ||
Zeile 322: | Zeile 322: | ||
Für die Ausgabe und Auswertung stehen folgende Methoden zur Verfügung: | Für die Ausgabe und Auswertung stehen folgende Methoden zur Verfügung: | ||
− | getContent() | + | ;<code>getContent()</code> |
+ | :gibt den Inhalt der aufgerufenen Seite zurück | ||
− | + | ;<code>getStatusCode()</code> | |
− | + | :Liefert den HTTP-Status-Code des Response zurück (z.B. 200 für 'OK' oder 404 für 'not found') | |
− | + | ;<code>getStatusMessage()</code> | |
− | + | :Liefert den HTTP-Status-Meldung des Response zurück (z.B. 'OK' oder '... not found') | |
− | + | ;<code>getError()</code> | |
− | + | :Liefert eine Fehlerzeile aus HTTP-Status-Code und -Meldung zurück | |
− | + | ;<code>getResonseHeaders()</code> | |
− | getResonseHeaders() | + | :Liefert ein Assoziatives Array, das die Response Header enthält |
− | + | ;<code>getResonseCookies()</code> | |
− | + | :Liefert ein Assoziatives Array, das die Cookies im Response enthält | |
− | + | ;<code>getRequestURL()</code> | |
− | + | :Liefert die URL, an die der Request weitergeleitet wurde | |
− | + | ;<code>getJSessionId()</code> | |
− | + | :Liefert vor dem dispatch()-Aufruf die JSESSIONID mit der der Request gesendet wird. Nach dem dispatch()-Aufruf wird die vom Request zurückgeliefert JSESSIONID zurückgeliefert. | |
− | |||
Soll für mehrere Aufrufe von SPML-Seite die gleiche Session verwendet werde, muß das dafür notwendige Cookie JSESSIONID vom Dispatcher an die aufrufende PHP-Seite weitergegeben werden. Ist dies erwünscht, ist das vor dem dispatch()-Aufruf dies mit der Methode setWriteCookies(true) einzuschalten. | Soll für mehrere Aufrufe von SPML-Seite die gleiche Session verwendet werde, muß das dafür notwendige Cookie JSESSIONID vom Dispatcher an die aufrufende PHP-Seite weitergegeben werden. Ist dies erwünscht, ist das vor dem dispatch()-Aufruf dies mit der Methode setWriteCookies(true) einzuschalten. | ||
Zeile 351: | Zeile 351: | ||
Das Schreiben des Cookies vom Dispatcher ist standardmässig deaktiviert. Der Grund dafür ist, das der Dispatcher das Cookie nur setzen kann, wenn noch keine Daten an den Client gesendet wurden (Cookies liegen im HTTP-Header). Soll der Dispatcher Cookies an den Client weite reichen, muß die disptach()-Methode aufgerufen werden bevor PHP Daten an den Client sendet (z.B. mit echo). | Das Schreiben des Cookies vom Dispatcher ist standardmässig deaktiviert. Der Grund dafür ist, das der Dispatcher das Cookie nur setzen kann, wenn noch keine Daten an den Client gesendet wurden (Cookies liegen im HTTP-Header). Soll der Dispatcher Cookies an den Client weite reichen, muß die disptach()-Methode aufgerufen werden bevor PHP Daten an den Client sendet (z.B. mit echo). | ||
+ | <source lang="xml"> | ||
... | ... | ||
$dispatcher->setWriteCookies(true); | $dispatcher->setWriteCookies(true); | ||
$success = $dispatcher->dispatch("/dir/file.spml"); | $success = $dispatcher->dispatch("/dir/file.spml"); | ||
... | ... | ||
+ | </source> | ||
Dadurch wird das Cookie JSESSIONID an den Browser weitergereicht. Mit dieser Methode kann die PHP-Seite nur eine Session für die SPML-Seiten definieren, da der Cookie-Name JSESSIONID vorgegeben ist. Möglicherweise kann es auch zu konflikten kommen wenn weitere PHP-Seiten eine andere Session verwenden wollen. Aus diesem Grund ist es möglich den Namen des Cookies zu ändern, der an den Browser gesendet werden soll. Mit folgendem Aufruf läßt sich die Cookie-Name ändern. | Dadurch wird das Cookie JSESSIONID an den Browser weitergereicht. Mit dieser Methode kann die PHP-Seite nur eine Session für die SPML-Seiten definieren, da der Cookie-Name JSESSIONID vorgegeben ist. Möglicherweise kann es auch zu konflikten kommen wenn weitere PHP-Seiten eine andere Session verwenden wollen. Aus diesem Grund ist es möglich den Namen des Cookies zu ändern, der an den Browser gesendet werden soll. Mit folgendem Aufruf läßt sich die Cookie-Name ändern. | ||
+ | <source lang="xml"> | ||
... | ... | ||
$dispatcher->setJSessionName("mySessionA"); | $dispatcher->setJSessionName("mySessionA"); | ||
Zeile 363: | Zeile 366: | ||
$success = $dispatcher->dispatch("/dir/file.spml"); | $success = $dispatcher->dispatch("/dir/file.spml"); | ||
... | ... | ||
+ | </source> | ||
Auch die Namensänderung muß vor dem Aufruf der dispatch()-Methode erfolgen. Der Dispatcher sorgt nun dafür, das zwar das Cookie JSESSIONID an die SPML-Seite gesendet wird, im Browser wird die SessionID allerdings in einem Cookie gehalten, dessen Name mit setJSessionName() angegeben werden kann. | Auch die Namensänderung muß vor dem Aufruf der dispatch()-Methode erfolgen. Der Dispatcher sorgt nun dafür, das zwar das Cookie JSESSIONID an die SPML-Seite gesendet wird, im Browser wird die SessionID allerdings in einem Cookie gehalten, dessen Name mit setJSessionName() angegeben werden kann. | ||
Zeile 368: | Zeile 372: | ||
Im Normalfall leitet der RequestDispatcher alle Request-Parameter mit der die PHP-Seite aufgerufen wurde an die angegebene URL weiter. Es können allerdings noch weitere Parameter und auch Upload-Dateien hinzugefügt werden. Diese können vor dem dispatch()-Aufruf mit folgender Methode gesetzt werden. | Im Normalfall leitet der RequestDispatcher alle Request-Parameter mit der die PHP-Seite aufgerufen wurde an die angegebene URL weiter. Es können allerdings noch weitere Parameter und auch Upload-Dateien hinzugefügt werden. Diese können vor dem dispatch()-Aufruf mit folgender Methode gesetzt werden. | ||
+ | <source lang="xml"> | ||
... | ... | ||
$dispatcher->setParameter("myparam", "abc"); // HTTP-Parameter hinzufügen | $dispatcher->setParameter("myparam", "abc"); // HTTP-Parameter hinzufügen | ||
Zeile 373: | Zeile 378: | ||
$success = $dispatcher->dispatch("/dir/file.spml"); | $success = $dispatcher->dispatch("/dir/file.spml"); | ||
... | ... | ||
+ | </source> | ||
Wurden an die PHP-Seite Formulardaten eines mit sp:form erzeugten Formulars gesendet ist wie oben beschrieben die Angabe eines nameencodings notwendig. Um dennoch über den originalen Fomularfeldnamen auf die Felder zugreifen zu können ist es möglich das Encoding bei den Methoden setParameter(), addParameter(), removeParameter(), getParameter(), setFile(), addFile(), removeFile() und getFile() mit anzugeben. | Wurden an die PHP-Seite Formulardaten eines mit sp:form erzeugten Formulars gesendet ist wie oben beschrieben die Angabe eines nameencodings notwendig. Um dennoch über den originalen Fomularfeldnamen auf die Felder zugreifen zu können ist es möglich das Encoding bei den Methoden setParameter(), addParameter(), removeParameter(), getParameter(), setFile(), addFile(), removeFile() und getFile() mit anzugeben. | ||
+ | <source lang="xml"> | ||
... | ... | ||
$dispatcher->setParameter("myparam", "abc", "hex"); // HTTP-Parameter hinzufügen | $dispatcher->setParameter("myparam", "abc", "hex"); // HTTP-Parameter hinzufügen | ||
$dispatcher->getParameter("test", "hex"); // liefert den HTTP-Parameter zurück | $dispatcher->getParameter("test", "hex"); // liefert den HTTP-Parameter zurück | ||
... | ... | ||
+ | </source> | ||
− | + | Zusammenfassend noch die Methoden, mit denen der Request gesteuert werden kann | |
− | setJSessionId(jsessionid) | + | ;<code>setJSessionId(jsessionid)</code> |
+ | :Setzt die JSESSIONID die verwendet werden soll. | ||
− | + | ;<code>absorb()</code> | |
− | absorb() | + | :Übernimmt alle Parameter und Variablen der PHP-Seite, um sie weiter zu senden. |
− | + | ;<code>absorbRequestParameter()</code> | |
− | + | :Übernimmt alle Request-Parameter der PHP-Seite, um sie weiter zu senden. | |
− | + | ;<code>absorbRequestUploads()</code> | |
− | + | :Übernimmt alle Request-Uploads der PHP-Seite, um sie weiter zu senden. | |
− | + | ;<code>absorbCookies()</code> | |
− | + | :Übernimmt alle Cookies der PHP-Seite, um sie weiter zu senden. | |
− | + | ;<code>absorbSessionVariables()</code> | |
− | + | :Übernimmt alle Session-Variablen der PHP-Seite, um sie weiter zu senden. | |
− | + | ;<code>absorbServerVariables()</code> | |
− | + | :Übernimmt alle Server-Variablen der PHP-Seite, um sie weiter zu senden. | |
− | + | ;<code>dispatch(path, user, password)</code> | |
− | dispatch(path, user, password) | + | :Führt den Request mit den angegebenen Pfad aus. Optional kann noch ein User und ein Password für BASIC-Authentication angegeben werden. |
− | + | ;<code>setParameter(name, value, encoding)</code> | |
− | + | :Setzt ein Parameter der zusätzlich noch mitgesendet werden soll. Existiert bereis ein Parameter mit dem Name wird dieser überschieben | |
+ | :;Parameter | ||
+ | ::<b><code>name</code></b> Name des Parameters | ||
+ | ::<b><code>value</code></b> Wert des Parameters | ||
+ | ::<b><code>encoding</code></b> (optional) Encoding, mit dem der angegebene Parametername encodet werden soll | ||
− | + | ;<code>addParameter(name, value, encoding)</code> | |
+ | :Setzt ein Parameter der zusätzlich noch mitgesendet werden soll. Existiert bereis ein Parameter mit dem Name wird der neue Wert hinzugefügt. Aus dem value wird ein Array. | ||
+ | :;Parameter | ||
+ | ::<b><code>name</code></b> Name des Parameters | ||
+ | ::<b><code>value</code></b> Wert des Parameters | ||
+ | ::<b><code>encoding</code></b> (optional) Encoding, mit dem der angegebene Parametername encodet werden soll | ||
− | + | ;<code>removeParameter(name, encoding)</code> | |
+ | :Löscht einen Parameter und liefert den Wert des gelöschten Parameters zurück | ||
+ | :;Parameter | ||
+ | ::<b><code>name</code></b> Name des Parameters | ||
+ | ::<b><code>encoding</code></b> (optional) Encoding, mit dem der angegebene Parametername encodet werden soll | ||
− | + | ;<code>getParameter(name, encoding)</code> | |
+ | :Liefert den Wert eines Parameters | ||
+ | :;Parameter | ||
+ | ::<b><code>name</code></b> Name des Parameters | ||
+ | ::<b><code>encoding</code></b>(optional) Encoding, mit dem der angegebene Parametername encodet werden soll | ||
− | + | ;<code>setFile(name, file, mime, encoding)</code> | |
+ | :Setzt eine Datei die zusätzlich noch mitgesendet werden soll. Existiert bereis eine Uploaddatei mit dem Feldnamen wird diese ersetzt. | ||
− | + | :;Parameter | |
+ | ::<b><code>name</code></b> Feldname unter dem die Datei mitgesendet werden soll. | ||
+ | ::<b><code>file</code></b> Absoluter oder relativer (zur PHP-Seite) Pfad der Datei | ||
+ | ::<b><code>mime</code></b> MIME-Type der Datei | ||
+ | ::<b><code>encoding</code></b> (optional) Encoding, mit dem der angegebene Parametername encodet werden soll | ||
− | + | ;<code>addFile(name, file, mime, encoding)</code> | |
+ | :Setzt eine Datei die zusätzlich noch mitgesendet werden soll. Existiert bereis eine Uploaddatei mit dem Feldnamen wird die Datei hinzugefügt. | ||
− | + | :;Parameter | |
+ | ::<b><code>name</code></b> Feldname unter dem die Datei mitgesendet werden soll. | ||
+ | ::<b><code>file</code></b> Absoluter oder relativer (zur PHP-Seite) Pfad der Datei | ||
+ | ::<b><code>mime</code></b> MIME-Type der Datei | ||
+ | ::<b><code>encoding (optional)</code></b> Encoding, mit dem der angegebene Parametername encodet werden soll. | ||
− | + | ;<code>removeFile(name, encoding)</code> | |
− | + | :Sendet die Upload-Datei(en) mit dem angegebenen Feldnamen nicht mit und Liefert die Datei in Form eines Arrays zurück. Das Array hat folgende Felder. | |
− | + | :;<b><code>name</code></b> | |
− | + | ::Feldname | |
− | + | :;<b><code>type</code></b> | |
− | + | ::MIME-Type | |
− | + | :;<b><code>tmp_name</code></b> | |
− | + | ::Pfad zur Datei | |
− | + | :;<b><code>error</code></b> | |
− | + | ::Fehlercode bei übernommenen Dateien | |
− | + | :;<b><code>size</code></b> | |
− | + | ::Dateigröße in Bytes | |
− | + | :;Parameter | |
− | + | ::<b><code>name</code></b> Feldname unter dem die Datei mitgesendet werden soll. | |
− | + | ::<b><code>encoding</code></b> (optional) Encoding, mit dem der angegebene Parametername encodet werden soll. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | removeFile(name, encoding) | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
;<code>getFile(name, encoding)</code> | ;<code>getFile(name, encoding)</code> | ||
:Liefert die zu sendende Datei in Form eines Arrays Das Array hat folgende Felder | :Liefert die zu sendende Datei in Form eines Arrays Das Array hat folgende Felder | ||
:;Parameter | :;Parameter | ||
− | ::<b>name</b> Feldname | + | ::<b><code>name</code></b> Feldname |
− | ::<b>type</b> MIME-Type | + | ::<b><code>type</code></b> MIME-Type |
− | ::<b>tmp_name</b> Pfad zur Datei | + | ::<b><code>tmp_name</code></b> Pfad zur Datei |
− | ::<b>error</b> Fehlercode bei übernommenen Dateien | + | ::<b><code>error</code></b> Fehlercode bei übernommenen Dateien |
− | ::<b>size</b> Dateigröße in Bytes | + | ::<b><code>size</code></b> Dateigröße in Bytes |
;<code>setCookie(name, value)</code> | ;<code>setCookie(name, value)</code> | ||
:Setzt ein Cookie das zusätzlich noch mitgesendet werden soll. | :Setzt ein Cookie das zusätzlich noch mitgesendet werden soll. | ||
:;Parameter | :;Parameter | ||
− | ::<b>name</b> Name des Parameters | + | ::<b><code>name</code></b> Name des Parameters |
− | ::<b>value</b> Wert des Parameters | + | ::<b><code>value</code></b> Wert des Parameters |
;<code>removeCookie(name)</code> | ;<code>removeCookie(name)</code> | ||
:Sendet das angegebene Cookie nicht mit und liefert den Wert des Cookies oder null, wenn des Cookie nicht existiert | :Sendet das angegebene Cookie nicht mit und liefert den Wert des Cookies oder null, wenn des Cookie nicht existiert | ||
:;Parameter | :;Parameter | ||
− | ::<b>name</b> Name des Parameters | + | ::<b><code>name</code></b> Name des Parameters |
;<code>getCookie(name)</code> | ;<code>getCookie(name)</code> | ||
:Liefert den Wert des zu sendenden Cookies oder null, wenn des Cookie nicht existiert | :Liefert den Wert des zu sendenden Cookies oder null, wenn des Cookie nicht existiert | ||
:;Parameter | :;Parameter | ||
− | ::<b>name</b> Name des Parameters | + | ::<b><code>name</code></b> Name des Parameters |
;<code>setJSessionName(name);</code> | ;<code>setJSessionName(name);</code> | ||
:Gibt einen Cookie-Namen an unter dem die JSESSIONID im Browser gespeichert werden soll | :Gibt einen Cookie-Namen an unter dem die JSESSIONID im Browser gespeichert werden soll | ||
:;Parameter | :;Parameter | ||
− | ::<b>name</b> Name des Cookies | + | ::<b><code>name</code></b> Name des Cookies |
;<code>setWriteCookies(writeCookie);</code> | ;<code>setWriteCookies(writeCookie);</code> | ||
:Gibt an, ob die Cookies des Response des weitergereichten Requests bis zum Browser durchgereicht werden sollen. | :Gibt an, ob die Cookies des Response des weitergereichten Requests bis zum Browser durchgereicht werden sollen. | ||
:;Parameter | :;Parameter | ||
− | ::<b>writeCookie</b> <code>true</code>, wenn die Cookies durchgereicht werden sollen. | + | ::<b><code>writeCookie</code></b> <code>true</code>, wenn die Cookies durchgereicht werden sollen. |
Version vom 8. Juli 2008, 15:23 Uhr
Beschreibung
Als Live-Seiten werden SPML-Seiten bezeichnet, die in einem Publikationsbereich generiert werden und somit, wie auch PHP-Seiten, in einer Website aufgerufen werden. Um SPML-Seiten in einem Publikationsbereich ausführen zu können, muß dieser als IES-Module aktiviert sein.
SPML-Seiten mit Fullpage-Template
Die einfachste Art eine SPML-Liveseite zu erzeugen, ist über ein Fullpage Template. Verwenden sie dazu bitte, das im Basis-Paket des IES enthaltene Template Fullpage (spml). Dieses Template stellt für die Eingabe ein Textfeld bereit, in dem der SPML-Code eingetragen werden kann. Für die Ausgabe erzeugt das Template zu dem eingegebenen SPML-Code noch zusätzliche notwendige Setzungen.
Legen Sie einen Seiten-Artikel mit diesem Template an und tragen sie ein das Textfeld z.B. folgenden Code ein
<sp:print name="system.page.name"/>
Publizieren sie den Artikel und rufen sie die generierte Seite auf. In der Seite ist nun der Name des Artikels enthalten.
Bei der Erzeugung von SPML-Seiten über das Fullpage-Template ergibt sich jedoch ein Nachteil. Der in dem Textfeld eingetragene SPML-Code wird 1 zu 1 in die zu generierende SPML-Seite geschrieben. SPML-Code der zum Generierungszeitpunkt ausgeführt werden soll, kann nicht angegeben werden. Ist dies jedoch notwendig, müssen die SPML-Seite über andere Templates erzeugt werden.
SPML-Seiten mit Benutzerdefinierten Templates
Je nach Anwendungsfall kann es auch sinvoll sein den SPML-Code zunächst in ein Template zu schreiben, sodaß jeder Artikel der dieses Template verwendet, den SPML-Code enthält. Da SPML aber auch für die Template-Sprache selber verwendet wird, ist darauf zu achten, daß SPML-Code der nicht zur Generierungszeit der Seite ausgeführt werden soll, in <sp:code>
-Tags stehen muß. Code innerhalb dieser Tags wird zur Generierungszeit ignoriert und direkt in die Seite geschrieben. Dieser SPML-Code wird dann erst bei Aufruf der Seite ausgeführt.
So ist es möglich Teile die zur Generierungszeit fest stehen schon beim Erzeugen der Seite zu ermitteln und nur die 'echten' Liveanteile der SPML-Seite beim Aufruf auszuführen.
Im Out-Teil des Templates sollte als erstes das Template SPML Standard Output (Anchor: template.spml.standard.output
) includet werden, da dieses den notwendigen SPML-Header in die Seite schreibt.
<sp:io type="in">
...
</sp:io><sp:io type="out"><sp:include anchor="template.spml.standard.output"/>
...
<sp:code>
SPML-Code der uninterpretiert in die Seite geschreiben wird.<br>
Uhrzeit: <sp:print name="system.now" dateformat="HH:mm:ss"/>
</sp:code>
</sp:io>
IES Nutzer anmelden
Um Daten des IES lesen und schreiben zu können ist ein angemeldeter Nutzer nötig. Mit dessen Rechten wird entschieden, ob bestimmte Daten gelesen, oder geschrieben werden dürfen.
Es gibt mehrere Möglichkeiten einen Nutzer anzumelden:
- Über ein Login-Formular, das an den LoginHandler (siehe LoginHandler) gesendet wird.
- Mit Hilfe von
sp:login
- Implizit über die Module-Konfiguration
- Über Basic-Authentikation
Login über ein Formular
Mit Hilfe des LoginHandlers
können Nutzer mit Hilfe von Formular-Feldern angemeldet werden. Dazu wird ein Formular wie folgendes Verwendet.
<sp:form name="beliebig" uri="${pageAfterLogin}" handler="com.sitepark.ies.control.jsp.handler.LoginHandler" method="post">
Login: <input name="SYS_LGIN_login"><br>
Passwort: <input name="SYS_LGIN_password" type="password"><br>
<input name="SYS_LGIN_client" type="hidden" value="clientanchor"/>
<input type="submit"/>
</sp:form>
<sp:loop collection="system.error" item="it">
ERROR: <sp:print name="it.key"/>: <sp:print name="it.value"/><br>
</sp:loop>
<sp:loop collection="system.fatal" item="it">
FATAL: <sp:print name="it.key"/>: <sp:print name="it.value"/><br>
</sp:loop>
Mit sp:form
wird das Formular erzeugt. Mit uri
wird angegeben, welche Seite nach dem ausgeführten Login aufgerufen werden soll. Mit handler
wird der LoginHandler angegeben, um das Login durchzuführen. Die für den LoginHandler erforderlichen Felder SYS_LGIN_login
, SYS_LGIN_password
und SYS_LGIN_client
müssen mit angegeben werden. Für SYS_LGIN_client
kann entweder die Client ID oder der Anchor des Clients verwendet werden.
Um zu verhindern, daß Seiten aufgerufen werden können, ohne daß ein Nutzer angemeldet ist, können bestimmte Seiten geschützt werden. Weiter solle im Fehlerfall (ungültiger Login, Aufruf einer geschützen Seiten von einem nicht angemeldeten Nutzer) eine definierte Seite aufgerufen werden. Dazu ist in der Konfigurationsdatei DOCUMENT_ROOT/WEB-INF/ies-module.xml
des entsprechenden Publikationsbereich folgendes einzutragen:
<ies-module ...>
...
<web>
<security-constrains>
<allowed pattern="/login.spml" />
<denied pattern="/.*" />
</security-constrains>
<exception url-pattern=".*">
<catch class=".*" uri="/login.spml" />
</exception>
</web>
</ies-module>
- <security-constrains>
- Hier wird definiert welche Seiten ohne Login aufgerufen werden dürfen.
<allowed pattern="/login.spml" />
aufruf von login.spml
ist immer erlaubt.
<denied pattern="/.*" />
alle anderen Seiten dürfen nicht aufgerufen werden.
Hierbei ist noch zu beachten, daß nur die Seiten geschützt werden, die vom IES ausgeführt/ausgeliefert werden (HTML-Seiten, PHP-Seiten, Bilder, CSS, ... gehören in der Regeln nicht dazu). Je nach gesetzten JkMount's (mod_jk)
sind das möglicherweise nur *.spml
und *.jsp
Dateien.
<exception>
- Werden Seiten von nicht angemeldeten Nutzern aufgerufen, wird von der Seite eine
AccessDeniedException
geworfen. Um allgemein diese Fehler abzufangen, wird angegeben für welche URL's welche Exception abgefangen und welche Seite danach aufgerufen werden soll. Hier werden für alle Seiten alle Exception abgefangen und anschließend die /login.spml
aufgerufen.
Nach dem sie die Datei ies-module.xml
geändert haben, muß das Modul des Publikationsbereiches neu geladen werden, damit die Änderungen wirksam werden (Siehe Administration des IES).
Daten über Liveseiten erzeugen, ändern und löschen
Wie auch IES-Module können auch Liveseiten Daten im IES erzeugen, ändern und löschen. Dazu werden Handler angesprochen, die über HTTP GET
- bzw. POST
-Parameter gesteuert werden.
Artikel anlegen und ändern
Um einen Artikel über eine Liveseite anzulegen, muß der InformationHandler
verwendet werden. Dieser wird über seinen vollen Klassennamen com.sitepark.ies.control.jsp.handler.InformationHandler
angesprochen. Siehe InformationHandler.
Die Artikeldaten können z.B. in Formularen eingegeben und über Submit an den IES gesendet werden. Der Handler führt die Aktionen aus, Die SPML-Seite stellt anschließend die Ergebnisse dar.
Die Minimalanforderungen, um einen Artikel anzulegen oder zu ändern sind:
- Es muß ein Nutzer angemeldet sein, der die nötigen Rechte hat einen Artikel in einem Pool anzulegen
- Um einen neu angelegten Artikel direkt darzustellen, muß die Variable
SYS_element
mit dem Wert von SYS_INFE_id
gesetzt werden. In SYS_INFE_id
wird die ID des neu angelegten Artikels gesetzt. SYS_element
definiert das aktuelle Element
<sp:set name="SYS_element" object="SYS_INFE_id"/>
Nur wenn diese Variable gesetzt ist, kann auf den aktuellen Artikel mit system.information
zugegriffen werden.
- Um einen Artikel zu ändern, muß das Feld
SYS_INFE_id
mit der zu ändernden Artikel-ID und SYS_INFE_action
mit dem Wert update
mitgesendet werden.
- Um einen Artikel zu erzeugen müssen die Felder
SYS_INFE_articleType
für die Typ des Artikels (Artikel, Medium, Resource), SYS_INFE_action
mit dem Wert create
und SYS_INFE_target
mit der ID
des Pools, in dem der Artikel angelegt werden soll mitgegeben werden
- Für den Artikel muß mit dem Feld
SYS_INFE_name
ein Name angegeben werden.
Damit wird ein Artikel angelegt oder geändert, kann aber noch nicht mit Infosite weiter bearbeitet werden. Dazu fehlen noch einige Steuerfelder, die Infosite benötigt werden, um in dessen Umgebung lauffähig zu sein. Bei den noch nötigen Feldern handelt es sich um Content-Felder, die mit Hilfe von sp:hidden
erzeugt werden können.
Die Felder entsprechen den Angaben für den Artikelpool in der Artikelpoolverwaltung von Infosite5, in dem der Artikel angelegt werden soll.
Da sich die Werte auf den Pool, in dem der Artikel abgelegt werden soll beziehen, kann dies z.B. so erfolgen:
<sp:set name="articlePool" object="system.page.parent"/>
...
<sp:hidden name="template" value="${articlePool.container}"/>
<sp:hidden name="editor_template_pool" value="${articlePool.editorTemplatePool}"/>
<sp:hidden name="registration_template" value="${articlePool.registrationTemplate}"/>
<sp:hidden name="editor_template" value="${articlePool.editorTemplatePool.sortedElements[0]}"/>
...
In diesem Beispiel wird der gleiche Pool verwendet, in dem auch die SPML-Seite selber liegt. Im Normalfall werden die angelegten Artikel vermutlich in anderen Pools liegen. Das Feld editor_template
wird in diesem Beispiel auf das erste Template (alphabetisch sortiert) in dem Template-Pool gesetzt. Hier kann auch z.B. über Anchor
ein bestimmtes Template angegeben werden. Es ist nur darauf zu achten, daß das Template auch in dem über editor_template_pool
angegebenen Template-Pool enthalten ist.
In dem Artikelpool-Bereich können folgende Angaben für den Pool gemacht werden.
- Template Container
- Dieses Feld entspricht dem
hidden
-Feld template
. Folgende Anchor für Infosite-Container können verwendet werden:
gui.container.infosite.standard
(Standard Infosite Container)
gui.container.infosite.media
(Standard Medien Container)
- Template für die Eigenschaften
- Dieses Feld entspricht dem
hidden
-Feld registration_template
. Folgende Infosite-Templates können verwendet werden:
gui.container.infosite.standard.all
(alle Artikel-Typen)
gui.container.infosite.standard.page
(nur Seiten anlegen)
gui.container.infosite.standard.media
(nur Medien anlegen)
gui.container.infosite.standard.resource
(nur Resourcen anlegen)
gui.container.infosite.standard.pageAutoName
(nur Seiten ohne Namensvergabe anlegen)
gui.container.infosite.standard.pageAndMedia
(nur Seiten und Medien anlegen)
gui.container.infosite.standard.pageAndResource
(nur Seiten und Resourcen anlegen)
- Templatepool für die Bearbeitung
- Dieses Feld entspicht dem
hidden
-Feld editor_template_pool
. Hier muß eine ID eines Templates-Pools angegeben werden in dem sich die zu verwendenden Templates befinden
Hier ein kleines Beispiel für das Anlegen und Bearbeiten eines Artikels:
<sp:set name="SYS_element" object="SYS_INFE_id"/>
<sp:login login="nutzerlogin" password="nutzerpassword" client="mandantenanchor" scope="application"/>
<sp:set name="articlePool" object="system.page.parent"/>
<sp:form name="createAndEdit" uri="${system.page.url}" handler="com.sitepark.ies.control.jsp.handler.InformationHandler" method="post">
<sp:condition>
<sp:if name="system.information">
<input type="hidden" name="SYS_INFE_id" value="<sp:print name="system.information.id"/>">
<input type="hidden" name="SYS_INFE_action" value="update">
</sp:if>
<sp:else>
<input type="hidden" name="SYS_INFE_action" value="create">
<input type="hidden" name="SYS_INFE_articleType" value="article">
<input type="hidden" name="SYS_INFE_target" value="<sp:print name="articlePool"/>">
</sp:else>
</sp:condition>
Name:<br>
<input name="SYS_INFE_name" value="<sp:print name="name"/>"><br>
Dateiname:<br>
<input name="SYS_INFE_file" value="<sp:print name="filename"/>"><br>
<input type="submit" value="speichern"><br>
<sp:hidden name="template" value="${articlePool.container}"/>
<sp:hidden name="editor_template_pool" value="${articlePool.editorTemplatePool}"/>
<sp:hidden name="registration_template" value="${articlePool.registrationTemplate}"/>
<sp:hidden name="editor_template" value="${articlePool.editorTemplatePool.sortedElements[0]}"/>
<sp:loop collection="system.error" item="it">
ERROR: <sp:print name="it.key"/>: <sp:print name="it.value"/><br>
</sp:loop>
<sp:loop collection="system.fatal" item="it">
FATAL: <sp:print name="it.key"/>: <sp:print name="it.value"/><br>
</sp:loop>
</sp:form>
Artikel publizieren und depublizieren
Um Artikel zu publizieren bzw. zu depublizieren müssen folgende Felder pro Publikationsbereich mitgesendet werden:
SYS_INFE_publicationArea
ID
des Publikationsbereiches in dem der Artikel publiziert bzw. depubliziert werden soll. z.B. pub1
SYS_INFE_publicationChecked
- Wird diese Feld mitgesendet und hat es als Wert die ID des Publikationsbereiches, so wird der Artikel in diesem Publikationsbereich publiziert. Wird nur das Feld
SYS_INFE_publicationArea
(ohne SYS_INFE_publicationChecked
) mitgesendet, wird der Artikel aus dem Publikationsbereich depubliziert.
SYS_INFE_publicationTemplate
- Hiermit wird das Template angegeben mit der der Artikel publiziert werden soll. Theoretisch ist es möglich für die Ein- und Ausgabe unterschiedliche Templates anzugeben. Da aber Infosite5 dies nicht unterstüzt ist davon abzuraten. Bitte geben sie hier für alle Publikationsbereich das Template an, daß sie auch für das Feld
editor_template
verwendet haben.
Die Felder können z.B. über hidden
-Felder mitgesendet werden. preview
und www
sind die Anchor der Publikationsbereiche.
<input type="hidden" name="SYS_INFE_publicationArea" value="<sp:print name="${!{preview}}"/>">
<input type="hidden" name="SYS_INFE_publicationChecked" value="<sp:print name="${!{preview}}"/>"/>
<input type="hidden" name="SYS_INFE_publicationTemplate" value="<sp:print name="${articlePool.editorTemplatePool.sortedElements[0]}"/>">
<input type="hidden" name="SYS_INFE_publicationArea" value="<sp:print name="${!{www}}"/>">
<input type="hidden" name="SYS_INFE_publicationChecked" value="<sp:print name="${!{www}}"/>"/>
<input type="hidden" name="SYS_INFE_publicationTemplate" value="<sp:print name="${articlePool.editorTemplatePool.sortedElements[0]}"/>">
PHP integration
Es kann Sinnvoll sein SPML-Liveseiten nicht direkt aufzurufen, sondern in PHP-Seiten einzubetten. Dazu müssen die PHP-Seiten einen eigenen Request an die SPML-Seite senden. Dabei benötigt die SPML-Seite möglicherweise auch die Request-Parameter, die an die PHP-Seite gesendet wurden. Um die SPML-Seite möglichst einfach einzubinden steht die PHP-Class RequestDispatcher.class.php
aus der phplib
von Sitepark zur Verfügung.
Für diese Art der Integration sind noch ein paar PHP-Besonderheiten zu beachten.
- Gleichnamige Request-Parameter bzw. Formularfelder
- Werden an eine PHP-Seite zwei gleichnamige Request-Parameter bzw. Formularfelder gesendet, wird von PHP immer nur der letzte Parameter verwendet. Wird also z.B. die URL
http://www.domain.de/test.php?test=1&test=2
aufgerufen, erhält man mit $_GET["test"] den Wert 2. Das gleiche gilt für POST Formularfelder. Möchte man beide Parameter erhalten muß noch ein [] am Parameternamen bzw. Formularfeldnamen angehängt werden. Das obige Beispiel würde dann so aussehen:
http://www.domain.de/test.php?test[]=1&test[]=2
$_GET["test"]
enthält nun ein Array mit den Werten $_GET["test"][0]=1
und $_GET["test"][1]=2
Siehe hierzu auch http://www.php.net/manual/de/faq.html.php#faq.html.arrays
- Modifikationen von Request-Parametern und Formularfeldern durch PHP
- Enthalten Namen von Request-Parametern oder Formularfeldern bestimmte Zeichen wird der Name von PHP modifiziert. Aufgrund der oben Array-Regel werden z.B. alle Zeichen nach einem
[]
abgeschnitten. Wird z.B. ein Request-Parameter mit dem Namen
sp_mainIterator[0].sp_text
an eine PHP-Seite geschickt, ist der Wert des Feldes nur noch über den Namen
sp_mainIterator
zugreifbar. Desweiteren werden alle Punkte, die in einem Request-Parameternamen oder einem Formularfeldnamen enthalten sind durch Unterstriche ersetzt. Wird z.B. ein Request-Parameter mit dem Namen
sp_text.de_DE
an eine PHP-Seite geschickt, ist der Wert des Feldes nur noch über den Namen
sp_text_de_DE
zugreifbar.
Siehe hierzu auch http://www.php.net/manual/de/faq.html.php#faq.html.form-image
Der IES verwendet Punkte und Eckige Klammern in mit sp:text
, sp:textarea
, sp:checkbox
, sp:select
, sp:hidden
, sp:upload
, sp:password
und sp:radio
erzeugten Formularfeldern. Würden diese so an eine PHP-Seite gesendet werden, gingen nötige Informationen verloren. Um dies zu umgehen, können mit dem Attribute nameencoding
des Tags sp:form
die Formularfeldnamen encodet werden. Aus einem mit sp:form
definiertem Formular
<sp:form uri="test.php">
<sp:iterator collection="sp_list" min="1">
<sp:text name="sp_text"/>
</sp:iterator>
</sp:form>
wird folgender HTML-Code erzeugt:
<form action="/test.php" method="post" id="form:0"><div>...</div>
<input type="text" name="sp_list[0].sp_text" value="" id="tag:0">
<div><input type="hidden" name="SYS_pageParameter" value="..."></div></form>
Mit der Angabe eines nameencoding
werden die Formularfeldnamen encodet. Aus einem mit sp:form
definiertem Formular
<sp:form uri="test.php" nameencoding="hex">
<sp:iterator collection="sp_list" min="1">
<sp:text name="sp_text"/>
</sp:iterator>
</sp:form>
wird folgender HTML-Code erzeugt:
<form action="/test.php" method="post" id="form:0"><div>...</div>
<input type="text" name="hex:73705f6c6973745b305d2e73705f74657874" value="" id="tag:0">
<div><input type="hidden" name="SYS_pageParameter" value="..."></div></form>
Dadurch wird verhindert, das PHP die Formularfeldnamen modifiziert. Der weiter unten beschriebene RequestDispatcher.class.php
bietet Methoden, mit dem über den originalen Formularfeldnamen auf die Parameter zugegriffen werden kann.
RequestDispatcher.class.php
Die PHP-Klasse RequestDispatcher
ist Teil der Sitepark phplib
. Sie soll die Integrations von Live-SPML-Seiten in PHP-Seiten vereinfachen, kann aber auch ganz allgemein zur Weiterleitung von HTTP-Requests verwendet werden.
Bevor die Klasse verwendet werden kann, muß sie in die PHP-Seite geladen werden. Dies sollte wie folgt erfolgen:
require_once($_SERVER["DOCUMENT_ROOT"] . "/phplib/RequestDispatcher.class.php");
Um den Dispatcher zu nutzen, muß eine Instanz der Klasse erzeugt werden:
$dispatcher = new RequestDispatcher("www.domain.de");
Dem Konstruktor wird der Host oder die IP-Adresse des Servers angegeben, an den die Request weitergeleitet werden soll.
$dispatcher->absorb();
Die Methode absorb()
liest alle Request-Parameter, Request-Uploads Cookies, Session-Parameter und Server-Variablen ein, um sie mit der dispatch()
-Methode weiterzuleiten. Alternativ können auch z.B. nur Request-Parameter mit der Methode absorbRequestParameter()
übernommen werden. Weitere Methoden sind absorbRequestUploads()
, absorbSessionVariables()
, absorbCookies()
und absorbServerVariables()
. Einzelnen Werte können mit setParameter()
, setFile()
und setCookie()
setzten. Server- und Session-Variablen werden als HTTP-Parameter gesendet.
Die Methode dispatch()
führt den Request aus. Dieser Methode wird der Pfad zu der Seite angegeben, an den der Request weitergeleitet werden soll. Die Methode liefert true
zurück, wenn der Request erfolgreich weitergeleitet wurde, sonst false
.
$success = $dispatcher->dispatch("/dir/file.spml");
Der Dispatcher reichte alle GET
- und POST
-Parameter der PHP-Seite weiter. Der Request, den der Dispatcher ausfürt ist immer POST
. Weiter werden alle Session-Variablen ($_SESSION)
und alle Server ($_SERVER)
als Parameter mitgesendet. Cookies werden als Cookies weitergereicht.
Anschließend kann eine Fehlerbehandlung erfolgen oder z.B. der Response ausgegeben werden.
if ($success) {
echo $dispatcher->getContent();
} else {
echo "<b>FEHLER</b>: " . $dispatcher->getError() . "<br>";
}
Für die Ausgabe und Auswertung stehen folgende Methoden zur Verfügung:
getContent()
- gibt den Inhalt der aufgerufenen Seite zurück
getStatusCode()
- Liefert den HTTP-Status-Code des Response zurück (z.B. 200 für 'OK' oder 404 für 'not found')
getStatusMessage()
- Liefert den HTTP-Status-Meldung des Response zurück (z.B. 'OK' oder '... not found')
getError()
- Liefert eine Fehlerzeile aus HTTP-Status-Code und -Meldung zurück
getResonseHeaders()
- Liefert ein Assoziatives Array, das die Response Header enthält
getResonseCookies()
- Liefert ein Assoziatives Array, das die Cookies im Response enthält
getRequestURL()
- Liefert die URL, an die der Request weitergeleitet wurde
getJSessionId()
- Liefert vor dem dispatch()-Aufruf die JSESSIONID mit der der Request gesendet wird. Nach dem dispatch()-Aufruf wird die vom Request zurückgeliefert JSESSIONID zurückgeliefert.
Soll für mehrere Aufrufe von SPML-Seite die gleiche Session verwendet werde, muß das dafür notwendige Cookie JSESSIONID vom Dispatcher an die aufrufende PHP-Seite weitergegeben werden. Ist dies erwünscht, ist das vor dem dispatch()-Aufruf dies mit der Methode setWriteCookies(true) einzuschalten.
Das Schreiben des Cookies vom Dispatcher ist standardmässig deaktiviert. Der Grund dafür ist, das der Dispatcher das Cookie nur setzen kann, wenn noch keine Daten an den Client gesendet wurden (Cookies liegen im HTTP-Header). Soll der Dispatcher Cookies an den Client weite reichen, muß die disptach()-Methode aufgerufen werden bevor PHP Daten an den Client sendet (z.B. mit echo).
...
$dispatcher->setWriteCookies(true);
$success = $dispatcher->dispatch("/dir/file.spml");
...
Dadurch wird das Cookie JSESSIONID an den Browser weitergereicht. Mit dieser Methode kann die PHP-Seite nur eine Session für die SPML-Seiten definieren, da der Cookie-Name JSESSIONID vorgegeben ist. Möglicherweise kann es auch zu konflikten kommen wenn weitere PHP-Seiten eine andere Session verwenden wollen. Aus diesem Grund ist es möglich den Namen des Cookies zu ändern, der an den Browser gesendet werden soll. Mit folgendem Aufruf läßt sich die Cookie-Name ändern.
...
$dispatcher->setJSessionName("mySessionA");
$dispatcher->setWriteCookies(true);
$success = $dispatcher->dispatch("/dir/file.spml");
...
Auch die Namensänderung muß vor dem Aufruf der dispatch()-Methode erfolgen. Der Dispatcher sorgt nun dafür, das zwar das Cookie JSESSIONID an die SPML-Seite gesendet wird, im Browser wird die SessionID allerdings in einem Cookie gehalten, dessen Name mit setJSessionName() angegeben werden kann.
Im Normalfall leitet der RequestDispatcher alle Request-Parameter mit der die PHP-Seite aufgerufen wurde an die angegebene URL weiter. Es können allerdings noch weitere Parameter und auch Upload-Dateien hinzugefügt werden. Diese können vor dem dispatch()-Aufruf mit folgender Methode gesetzt werden.
...
$dispatcher->setParameter("myparam", "abc"); // HTTP-Parameter hinzufügen
$dispatcher->setFile("myfile", "/tmp/image.jpg", "image/jpg"); // HTTP-Upload-Datei hinzufügen
$success = $dispatcher->dispatch("/dir/file.spml");
...
Wurden an die PHP-Seite Formulardaten eines mit sp:form erzeugten Formulars gesendet ist wie oben beschrieben die Angabe eines nameencodings notwendig. Um dennoch über den originalen Fomularfeldnamen auf die Felder zugreifen zu können ist es möglich das Encoding bei den Methoden setParameter(), addParameter(), removeParameter(), getParameter(), setFile(), addFile(), removeFile() und getFile() mit anzugeben.
...
$dispatcher->setParameter("myparam", "abc", "hex"); // HTTP-Parameter hinzufügen
$dispatcher->getParameter("test", "hex"); // liefert den HTTP-Parameter zurück
...
Zusammenfassend noch die Methoden, mit denen der Request gesteuert werden kann
setJSessionId(jsessionid)
- Setzt die JSESSIONID die verwendet werden soll.
absorb()
- Übernimmt alle Parameter und Variablen der PHP-Seite, um sie weiter zu senden.
absorbRequestParameter()
- Übernimmt alle Request-Parameter der PHP-Seite, um sie weiter zu senden.
absorbRequestUploads()
- Übernimmt alle Request-Uploads der PHP-Seite, um sie weiter zu senden.
absorbCookies()
- Übernimmt alle Cookies der PHP-Seite, um sie weiter zu senden.
absorbSessionVariables()
- Übernimmt alle Session-Variablen der PHP-Seite, um sie weiter zu senden.
absorbServerVariables()
- Übernimmt alle Server-Variablen der PHP-Seite, um sie weiter zu senden.
dispatch(path, user, password)
- Führt den Request mit den angegebenen Pfad aus. Optional kann noch ein User und ein Password für BASIC-Authentication angegeben werden.
setParameter(name, value, encoding)
- Setzt ein Parameter der zusätzlich noch mitgesendet werden soll. Existiert bereis ein Parameter mit dem Name wird dieser überschieben
- Parameter
name
Name des Parameters
value
Wert des Parameters
encoding
(optional) Encoding, mit dem der angegebene Parametername encodet werden soll
addParameter(name, value, encoding)
- Setzt ein Parameter der zusätzlich noch mitgesendet werden soll. Existiert bereis ein Parameter mit dem Name wird der neue Wert hinzugefügt. Aus dem value wird ein Array.
- Parameter
name
Name des Parameters
value
Wert des Parameters
encoding
(optional) Encoding, mit dem der angegebene Parametername encodet werden soll
removeParameter(name, encoding)
- Löscht einen Parameter und liefert den Wert des gelöschten Parameters zurück
- Parameter
name
Name des Parameters
encoding
(optional) Encoding, mit dem der angegebene Parametername encodet werden soll
getParameter(name, encoding)
- Liefert den Wert eines Parameters
- Parameter
name
Name des Parameters
encoding
(optional) Encoding, mit dem der angegebene Parametername encodet werden soll
setFile(name, file, mime, encoding)
- Setzt eine Datei die zusätzlich noch mitgesendet werden soll. Existiert bereis eine Uploaddatei mit dem Feldnamen wird diese ersetzt.
- Parameter
name
Feldname unter dem die Datei mitgesendet werden soll.
file
Absoluter oder relativer (zur PHP-Seite) Pfad der Datei
mime
MIME-Type der Datei
encoding
(optional) Encoding, mit dem der angegebene Parametername encodet werden soll
addFile(name, file, mime, encoding)
- Setzt eine Datei die zusätzlich noch mitgesendet werden soll. Existiert bereis eine Uploaddatei mit dem Feldnamen wird die Datei hinzugefügt.
- Parameter
name
Feldname unter dem die Datei mitgesendet werden soll.
file
Absoluter oder relativer (zur PHP-Seite) Pfad der Datei
mime
MIME-Type der Datei
encoding (optional)
Encoding, mit dem der angegebene Parametername encodet werden soll.
removeFile(name, encoding)
- Sendet die Upload-Datei(en) mit dem angegebenen Feldnamen nicht mit und Liefert die Datei in Form eines Arrays zurück. Das Array hat folgende Felder.
name
- Feldname
type
- MIME-Type
tmp_name
- Pfad zur Datei
error
- Fehlercode bei übernommenen Dateien
size
- Dateigröße in Bytes
- Parameter
name
Feldname unter dem die Datei mitgesendet werden soll.
encoding
(optional) Encoding, mit dem der angegebene Parametername encodet werden soll.
getFile(name, encoding)
- Liefert die zu sendende Datei in Form eines Arrays Das Array hat folgende Felder
- Parameter
name
Feldname
type
MIME-Type
tmp_name
Pfad zur Datei
error
Fehlercode bei übernommenen Dateien
size
Dateigröße in Bytes
setCookie(name, value)
- Setzt ein Cookie das zusätzlich noch mitgesendet werden soll.
- Parameter
name
Name des Parameters
value
Wert des Parameters
removeCookie(name)
- Sendet das angegebene Cookie nicht mit und liefert den Wert des Cookies oder null, wenn des Cookie nicht existiert
- Parameter
name
Name des Parameters
getCookie(name)
- Liefert den Wert des zu sendenden Cookies oder null, wenn des Cookie nicht existiert
- Parameter
name
Name des Parameters
setJSessionName(name);
- Gibt einen Cookie-Namen an unter dem die JSESSIONID im Browser gespeichert werden soll
- Parameter
name
Name des Cookies
setWriteCookies(writeCookie);
- Gibt an, ob die Cookies des Response des weitergereichten Requests bis zum Browser durchgereicht werden sollen.
- Parameter
writeCookie
true
, wenn die Cookies durchgereicht werden sollen.