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