Einfügen des Wertes einer Umgebungsvariablen
Der SSI-Befehl Echo weist den Webserver an, den Wert einer Umgebungsvariablen an der Position des Befehls im Quellcode des Dokuments einzufügen, bevor diese zu einem Webbrowser gesendet wird. Eine Umgebungsvariable ist eine vom Server bereitgestellte Information zum aktuellen Dokument oder einem Betriebsaspekt des Servers selbst. Sie können einen Echo-Befehl in einem Dokument nutzen, um z.B. zu veranlassen, dass der Server die Ortszeit oder das Datum der letzten Änderung des Dokuments in einen Absatz an beliebiger Stelle im Dokument einfügt. Der Server bestimmt den Wert der angegebenen Umgebungsvariablen dann, wenn er auf den Echo-Befehl trifft.
So fügen Sie einen Echo-Befehl ein
- Platzieren Sie die Einfügemarke an der Position im aktuellen Dokument, an welcher der Wert der Umgebungsvariablen vom Webserver eingefügt werden soll.
- Klicken Sie auf der benutzerdefinierten Symbolleiste auf SSI, und klicken Sie auf Echo. (Wenn der Befehl SSI nicht angezeigt wird, fügen Sie diesen zur benutzerdefinierten Symbolleiste hinzu, indem Sie in der Kategorienliste die Einstellung Einfügen und anschließend in der Befehlsliste die Option SSI wählen.)
- Geben Sie im Feld Variable die gewünschte Umgebungsvariable ein, oder wählen Sie sie aus. Klicken Sie anschließend auf OK.
Wenn die Anzeige von speziellen Tag-MarkierungenSie können spezielle Tag-Markierungen ein- oder ausblenden, indem Sie auf der Standardsymbolleiste auf “Spezielle Tag-Markierungen ein-/ausblenden” klicken. aktiviert ist, wird ein “SSI”-Feld (
) ebenfalls an der Position des Echo-Befehls unmittelbar vor dem (gegebenenfalls angezeigten) eingefügten Dateiinhalt angezeigt.
Die Umgebungsvariablen, die im Feld Variable auswählbar sind, werden im Folgenden vorgestellt.
Sie können den Namen einer beliebigen Umgebungsvariablen in das Feld Variable eingeben, auch wenn diese im Dropdownmenü nicht verfügbar ist.
Allgemeine Variablen
Diese Variablen sind allgemein nützlich.
|
DATE_GMT |
GMT-Datum und -Uhrzeit (Greenwicher Zeit), an dem bzw. zu der der Webserver den Echo-Befehl ausführt. Das Format wird vom Befehl config timefmt gesteuert. |
|
DATE_LOCAL |
Das lokale Datum und die lokale Uhrzeit, an dem bzw. zu der der Webserver den Echo-Befehl ausführt. Das Format wird vom Befehl config timefmt gesteuert. |
|
DOCUMENT_NAME |
Der Dateiname des aktuellen Dokuments. |
|
DOCUMENT_URI |
Der virtuelle Pfad des aktuellen Dokuments. |
|
HTTP_ACCEPT |
Die vom Browser akzeptierten MIME-Typen. |
|
HTTP_REFERRER |
Der URL der Seite, von welcher der Benutzer zum aktuellen Dokument gelangt ist (in der Regel durch Klicken auf einen Hyperlink), falls vorhanden. |
|
HTTP_USER_AGENT |
Der Name und die Version des Browsers. |
|
LAST_MODIFIED |
Das lokale Datum bzw. die lokale Uhrzeit, an dem bzw. zu der das Dokument zuletzt geändert wurde. Das Format wird vom Befehl config timefmt gesteuert. |
|
REMOTE_ADDR |
Die IP-Adresse des Computers des Benutzers. |
|
REMOTE_HOST |
Der Hostname des Computers des Benutzers. |
|
REMOTE_USER |
Der Benutzername des Benutzers (nur verfügbar, wenn sich der Benutzer für den Zugriff auf das aktuelle Dokument angemeldet hat). |
|
SERVER_NAME |
Hostname, DNS-Alias oder IP-Adresse des Webservers. |
|
SERVER_PORT |
Die Portnummer des Webservers (in der Regel 80) für die aktuelle Datenübertragung. |
|
SERVER_PROTOCOL |
Der Name und die Versionsnummer des Internetprotokolls (wie z.B. HTTP) für die aktuelle Datenübertragung. |
|
SERVER_SOFTWARE |
Der Name und die Version der Webserversoftware. |
CGI-spezifische Variablen
Diese Variablen sind nur von Bedeutung, wenn das angezeigte Dokument von einem CGI-Skript erzeugt wurde.
|
CONTENT_LENGTH |
Die Länge von Inhalten, die vom Browser an die Abfrage angefügt wurden. |
|
CONTENT_TYPE |
Der Typ von Inhalten, die vom Browser an die Abfrage angefügt wurden. |
|
GATEWAY_INTERFACE |
Die vom Server verwendete CGI-Version. |
|
PATH_INFO |
Die zusätzlichen Pfadinformationen, falls vorhanden, die vom Browser an den Pfadnamen des Skripts angefügt wurden. |
|
PATH_TRANSLATED |
Entspricht PATH_INFO, wobei jedoch der virtuelle Pfad in einen physischen Pfad übersetzt wird. |
|
QUERY_STRING |
Die Abfragezeichenfolge, falls vorhanden, die vom Browser an den URL des Skripts angefügt wurde. |
|
QUERY_STRING_UNESCAPED |
Die Version von QUERY_STRING ohne Escape-Zeichen. |
|
REQUEST_METHOD |
Die Methode, gemäß der die Browseranforderung erfolgte (wie z.B. GET oder POST). |
|
SCRIPT_NAME |
Der virtuelle Pfad des aktuellen Skripts. |
Verwandte Themen
Steuern des Uhrzeit- und Datumsformats für einen Echo-Befehl