Datei welche von Embperl bearbeitet werden soll.

Optional. Hat die selbe Bedeutung wie die Umgebungsvariable QUERY_STRING eines CGI Skripts. QUERY_STRING beinhaltet alles nach dem ersten "?" in der URL. query_string sollte URL kodiert sein. Default ist kein query_string.

Optional. Gibt den Dateinamen an, in den das Ergebnis geschrieben wird. Default ist die Standardausgabe.

Optional. Name der Logdatei. Default ist /tmp/embperl.log.

Optional. Gibt an, welche Debuginformationen in die Logdatei geschrieben werden. (siehe EMBPERL_DEBUG für mögliche Werte)

Mittels inputfile wird die Datei angegeben, die von Embperl bearbeitet werden soll. Ist der Parameter input ebenso vorhanden, sollte inputfile einen eindeutigen Namen spezifizieren. Jedesmal wenn Embperl den selben Namen sieht, geht es davon aus, daß die Quelle die selbe ist und verwendet den selben Packagenamen, sowie compiliert die Perlteile nur wenn mtime sich ändert oder undefiniert ist.

Ruft die durch diesen Parameter angegebene Funktion auf (siehe auch [$ "sub" $]). Momentan muß die Funktion entweder in der selben Embperldatei definiert sein oder die Embperldatei muß vorher importiert worden sein.

Referenz auf einen Skalar, welcher den Quellentext enthält. inputfile sollte ebenso angegeben werden, um die Quelle zu benennen. Der Name kann dabei beliebiger Text sein.

Zeitpunkt der letzten Änderung des Quellentextes. Der Quellentext wird nur dann neu übersetzt, wenn sich mtime ändert oder wenn mtime undef ist.

Datei, in die die Ausgabe geschrieben wird. Ist keine Datei angegeben, wird die Standardausgabe benutzt.

Referenz auf einen Skalar, in welchen die Ausgabe geschrieben werden soll.

Ein Wert von Null veranlasst Embperl die Seite nicht auszuführen, sondern alle darin enthaltenen Funktionen zu definieren. Dies ist nötig, um sie mittels des sub Parameters der Execute Funktion aufrufen zu können oder als Vorbereitung für einen späteren Import.

Ein Wert von Eins veranlasst Embperl die Seite nicht auszuführen, sondern alle darin enthaltenen Funktionen zu definieren und diese in das aktuelle Package zu importieren.

Siehe auch [$ sub $] Metacommand.

Dieser Wert gibt an, ob and wann das "Cleanup" des Packages ausgeführt werden soll. (Siehe auch Variablen Gültigkeitsbereich und Cleanup)

	cleanup = -1
	Es wird kein Cleanup ausgeführt.
	cleanup = 0 oder nicht spezifiziert
	Unter mod_perl wird das Cleanup erst ausgeführt, nachdem die Verbindung zum Client beendet wurde, auch wenn Execute mehrfach während eines Request aufgerufen wird. In allen anderen Fällen wird das Cleanup sofort ausgeführt.
	cleanup = 1
	Cleanup wird sofort ausgeführt.

Eine Referenz auf ein Array, um dem aufgerufenen Dokument Parameter zu übergeben.

 Beispiel:

    HTML::Embperl::Execute(..., param => [1, 2, 3]) ;
    HTML::Embperl::Execute(..., param => \@parameters) ;

ber das Array @param kann die aufgerufene Seite auf die Parameter zugreifen. Siehe eg/x/Excute.pl aus der Embperl Distribution für ein detailliertes Beispiel.

Kann benutzt werden, um die beiden Embperlvariablen @ffld und %fdat zu setzen.

Gibt die erste Zeilennummer der Quellendatei an (Default: 1)

Wie EMBPERL_OPTIONS (siehe unten), außer für Cleanup.

HINWEIS: optDisableFormData sollte gesetzt werden, wenn die Formulardaten eines POST Request bereits von der Standardeingabe eingelesen wurden, ansonsten versucht Execute die Daten ein zweites Mal einzulesen, was dazu führt, das der Request hängt.

Wie EMBPERL_DEBUG (siehe unten).

Wie EMBPERL_ESCMODE (siehe unten).

Wie EMBPERL_PACKAGE (siehe unten).

Wie EMBPERL_VIRTLOG (siehe unten). Wenn virtlog gleich uri ist, wird die Embperl Logdatei gesendet.

Wie EMBPERL_ALLOW (siehe unten)

Wie EMBPERL_PATH (siehe unten)

Die URI des Request. Wird nur für Virtlog Feature benötigt.

Wie EMBPERL_COMPARTMENT (siehe unten).

Wie EMBPERL_INPUT_FUNC (siehe unten). Zusätzlich ist es möglich eine Codereferenz anzugeben, die entsprechende Funktion wird dann als Eingabefunktion aufgerufen. Ebenso ist die Angabe einer Arrayreferenz möglich, wobei das erste Element dann die Codereferenz enthält und alle weiteren Elemente als Parameter der Funktion übergeben werden.

Wie EMBPERL_OUTPUT_FUNC (siehe unten). Zusätzlich ist es möglich eine Codereferenz anzugeben, die entsprechende Funktion wird dann als Ausgabefunktion aufgerufen. Ebenso ist die Angabe einer Arrayreferenz möglich, wobei das erste Element dann die Codereferenz enthält und alle weiteren Elemente als Parameter der Funktion übergeben werden.

Wie EMBPERL_COOKIE_NAME (siehe unten).

Wie EMBPERL_COOKIE_PATH (siehe unten).

Wie EMBPERL_COOKIE_DOMAIN (siehe unten).

Wie EMBPERL_COOKIE_EXPIRES (siehe unten).

Erwartet eine Referenz auf ein Array. Nach der Rückkehr der Funktion enthält das Array alle Fehlermeldungen der aufgerufenen Seite, soweit welche aufgetreten sind.

Erwartet einen Dateinamen und liefert eine Hashreferenz zurück, die in das Package der Datei "geblessed" ist, d.h. die Hashreferenze kann dazu genutzt werden, um Funktionen die in der Datei definiert sind, also Methoden aufzurufen. Zusätzlich kann durch den isa Parameter (siehe unten) eine Vererbungshierachie zwischen Embperlseiten aufgebaut werden. Außerdem ist es möglich in dem Hash Objektdaten zu speichern.

  Beispiel:

  [# Die Datei eposubs.htm definiert zwei Funktionen: txt1 und txt2 #]
  [# Als erstes erstellen wir ein neues Objekt #]
  [- $subs = Execute ({'object' => 'eposubs.htm'}) -]

  [# Nun kann man Methoden aufrufen #]
  txt1: [+ $subs -> txt1 +] <br>

  txt2: [+ $subs -> txt2 +] <br>

Erwarten den Namen einer Datei und schiebt den Packagename der Datei auf das @ISA Array der aktuellen Seite. Dadurch wird es möglich eine Vererbung zwischen Embperlseiten aufzubauen. Dies ist auch innerhalb von EmbperlObject hilfreich.

  Beispiel:

    [! Execute ({'isa' => '../eposubs.htm'}) !]

In der Version 1.3.x wird lediglich der Wert 'Text' akzetiert, dieser führt dazu, dass das Verhalten von Embperl 2.0 emuliert wird und der Text lediglich durchgereicht wird und keine Verarbeitung stattfindet.

Diese Funktion dient dazu, die Logdatei sowie die Debugflags, die für die folgenden Aufrufe von Execute genutzt werden, zu setzen. Es kann immer nur eine Logdatei existieren, der Pfad kann jedoch jederzeit geändert werden.

Durchsucht alle Umgebungsvariablen (%ENV) und setzt %params für die Benutzung von Execute. Alle Embperl Konfigurationsvariablen, außer EMBPERL_LOG, werden erkannt.