SSI - Server Side Includes


Von Lucas Bremgartner (breml auf trash.net)


Gebrauch von Server Side Includes

Server Side Include (SSI)-Kommandos werden ausgeführt, wenn der Server HTML-Dateien bei der Ausführung inspiziert. Mit SSI können lokale Variablen wie Datum und Uhrzeit in das HTML-Dokument eingefügt werden. Weiter können zum Beispiel Dateien wie eine Logo-Datei oder eine Signatur-Datei eingefügt werden.

HTML Dateien die SSI enthalten müssen als Dateierweiterung .shtml verwenden. SSI-Kommandos sind einfach einzufügen, die Syntax muss aber korrekt sein.

<!--#command cmd_argument="argument_value" -->

Stellen Sie sicher, dass ein Leerzeichen dem letzten Gänsefüsschen (") folgt.

Verwendung des echo Kommandos

Mit dem echo Kommando können die fünf Server - Umgebungsvariablen wie im Beispiel unten angezeigt werden.
Variable Beschreibung
Date_Local Momentanes Datum und Uhrzeit des Servers(Durch den Aufstellungsort des Servers bestimmt).
Date_GMT Momentanes Datum und Uhrzeit in GMT (Greenwich Mean Time)
Document_Name Dateinamen des Hauptdokumentes.
Document_URI Pfad und Dateinamen des Hauptdokumentes.
Last_Modified Datum und Uhrzeit wann das Hauptdokument das letzte Mal geändert wurde.

Beispiel:

Datum und Uhrzeit am Aufstellungsort des Servers.
<!--#echo var="Date_Local" -->

Ausgabe: Sunday, January 12, 1997 02:32AM EST

Verwendung des config Kommandos

Das config Kommando wird gebraucht, um die Ausgabe der obigen Variablen zu formatieren. Damit können alternative Darstellungsweisen verwendet werden.

<!--#config timefmt="%A, %B %d, %Y %I:%M%p" -->
<!--#echo var="date_local" -->

Ausgabe: Sunday, January 12, 1997 02:32AM

Nachfolgend die Liste der im Beispiel verwendeten Kodes:

%A Ganzer Wochentag-Name
%B Ganzer Monatsnamen
%d Day of the month
%Y Jahr
%I Stunde
%M Minute
%p a.m. or p.m.

Weitere SSI Kommandos

Das fsize Kommando kann gebraucht werden um die Grösse einer Datei anzugeben. Beispielsweise kann ein kleines Logo anstelle der aktuellen Datei übermittelt werden und dann die aktuelle Grösse der Hauptdatei mit fsize daneben geschrieben werden.

<!--#fsize file="image.gif" -->

Mit dem include Kommando kann eine weitere Datei in die aktuelle Datei eingeschlossen werden. Beispielsweise kann ein Dokumentenkopf, der ja immer gleich aussieht, bei jedem Dokument mit dem include - Kommando eingefügt werden. Der Dokumenten-Kopf erscheint dann wie ein Teil des ursprünglichen Dokumentes.

<!--#include file="any.htm" -->

Ist die Datei die eingefügt weden soll in einem anderen Verzeichnis, so muss der virtual - Befehl verwendet werden. Nachfolgend ist das Dokument im Hauptverzeichnis und das einzufügende Dokument in einem anderen Verzeichnis.

<!--#include virtual="/any.htm" -->

Mit dem exec Kommando kann ein CGI-Script aufgerufen und ausgeführt werden, wenn die HTML-Seite geladen wird. Nachfolgend wird der Script date.pl im relativen Verzeichnis /cgi-local ausgeführt.

<!--#exec cgi="/cgi-local/date.pl" -->

Links zum Thema SSI

Dies ist nur eine kleine Einführung. Wenn Sie sich in dieses Kapitel vertiefen wollen, prüfen Sie diesen Link:

SSI Einführung