Server-parsed html
|
| Einführung | Q: Was ist SSI? Warum haben manche Seiten die Endung .shtml?
EinführungAuch ein Web-Server kann bei der Gestaltung von Web-Seiten helfen, dazu stehen auf vielen Servern die sogenannten Server Side Includes (SSI) bereit. SSI besteht aus einem Satz relativ einfacher Befehle, die in eine HTML Seite eingebettet werden und direkt auf dem Server ausgeführt werden. Ein Befehl hat die Syntax:
Damit ist es zum Beispiel möglich, das aktuelle Tagesdatum, die Uhrzeit, die Dateigröße oder die URL in eine HTML Seite zu übernehmen. Der Besucher merkt davon nichts, nicht einmal der Quellcode gibt einen Hinweis auf den Einsatz von SSI: Denn mit dem Aufruf im Browser werden die SSI Befehle sofort ausgeführt und dann erst mit dem Seitencode ausgegeben. Seine wahre Pracht entfaltet SSI aber erst mit dem Einsatz von "Includes". Das bedeutet: Sie werden mit einem einfachen Befehl in die Lage versetzt, den Inhalt einer HTML- oder Textseite in eine andere einzufügen und zwar vollautomatisch. Auf diese Weise lassen sich wiederkehrende Elemente wie Menüleisten, Fußzeilen oder Adressen ganz einfach in eine beliebig große Zahl von Seiten einbetten. Muss später etwas verändert werden, brauchen nur die ausgelagerte Elemente angepasst zu werden, nicht jedoch die Seiten selbst. SSI ist nicht Browserabhängig, da es vom Server verarbeitet wird.
So gehen Sie vor: Legen Sie eine Datei "menu.html" im Unterverzeichnis "daten" an. Diese Datei enthält eine Menüleiste, ein HTML-Kopfbereich braucht nicht definiert zu werden. Kopieren Sie den folgenden Code in eine beliebige HTML Seite und setzten Sie in dorthin, wo später das Menü erscheinen soll: <!--#include virtual="/daten/menu.html"--> Geben Sie Ihrer Datei eine neue Endung - sie muss auf .shtml lauten. Das ist wichtig, damit der Server weiß, dass sich in dieser Datei SSI-Befehle befinden, die er auszuführen hat. Den Vorgang der Ausführung nennt man "parsen". Rufen Sie anschließend die Datei mit dem Browser auf. Die Menüleiste wird an dem für sie vorgesehenen Platz erscheinen. Ein Blick in den Quellcode der Seite verrät nichts Auffälliges, die SSI Befehle sind verschwunden und durch das Menü ersetzt. Alles wirkt so, als sei die Seite bereits so geschrieben worden. Achtung: Das Verfahren funktioniert nur online (Abruf über einen WEB-Server), schließlich werden die Includes auf dem Server ausgeführt. Via SSI lassen sich auch CGI-Skripte ausführen und deren Ergebnisse direkt in die Seite übernehmen. Angewendet wird das zum Beispiel bei Umfragen, Gästebüchern oder Countern.
| |
| [nach oben] | Die Befehle | |
| Befehle
|
Include VariablenZusätzlich zu den Standard CGI-Variablen (s.a. printenv) sind folgende Variablen für die Kommandos echo,if und elif und jedes aufgerufene Programm verfügbar.
Variablen SubstitutionVariable substitution is done within quoted strings in most cases where they may reasonably occur as an argument to an SSI directive. This includes the config, exec, flastmod, fsize, include, and set directives, as well as the arguments to conditional operators. You can insert a literal dollar sign into the string using backslash quoting: <!--#if expr="$a = \$test" --> If a variable reference needs to be substituted in the middle of a character sequence that might otherwise be considered a valid identifier in its own right, it can be disambiguated by enclosing the reference in braces, à la shell substitution:
<!--#set var="Zed" value="${REMOTE_HOST}_${REQUEST_METHOD}" -->
This will result in the Zed variable being set to "X_Y" if REMOTE_HOST is "X" and REQUEST_METHOD is "Y". EXAMPLE: the below example will print "in foo" if the DOCUMENT_URI is /foo/file.html, "in bar" if it is /bar/file.html and "in neither" otherwise:
<!--#if expr="\"$DOCUMENT_URI\" = \"/foo/file.html\"" -->
in foo
<!--#elif expr="\"$DOCUMENT_URI\" = \"/bar/file.html\"" -->
in bar
<!--#else -->
in neither
<!--#endif -->
Flow Control ElementsThese are available in Apache 1.2 and above. The basic flow control elements are:
<!--#if expr="test_condition" -->
<!--#elif expr="test_condition" -->
<!--#else -->
<!--#endif -->
The The The test_condition is one of the following:
"=" and "!=" bind more tightly than "&&" and "||". "!" binds most tightly. Thus, the following are equivalent:
<!--#if expr="$a = test1 && $b = test2" -->
<!--#if expr="($a = test1) && ($b = test2)" -->
Anything that's not recognized as a variable or an operator is treated as a string. Strings can also be quoted: 'string'. Unquoted strings can't contain whitespace (blanks and tabs) because it is used to separate tokens such as variables. If multiple strings are found in a row, they are concatenated using blanks. So, string1 string2 results in string1 string2 'string1 string2' results in string1 string2 | |
| [nach oben] | Anmerkungen | |
| Ob Ihr Server (->Konfiguration) in der Lage ist SSI auszuführen, erfahren Sie entweder vom Provider, oder Sie probieren es einfach aus. Fügen Sie zum Beispiel die Befehlszeile für das Datum in eine HTML Seite, geben Sie ihr einen Namen, der auf .shtml (oder .sht oder .shtm) endet, nach dem anschließenden Upload, rufen Sie die Datei mit dem Browser auf. Erscheint das Datum, ist alles OK. Ein Server wird durch viele SSI Aufrufe stärker belastet; ob das zum Tragen kommt, hängt von der Performance des Rechners ab und der Zahl der Seitenaufrufe. Suchmaschinen haben keine Problem mit Dateien, die auf .shtml enden.
| ||
| globale Konfiguration nur vom Administrator des WEB-Servers möglich. | Server-Konfiguration: Aktivierung von Server-Side Includes.shtml - Dokumente werden vom Server nur korrekt behandelt, wenn dieser auch richtig konfiguriert ist. Dazu sind (mindestens) 3 Anweisungen in der Serverkonfiguration (httpd.conf bzw. srm.conf) erforderlich.Die AddType-Anweisung [1] bewirkt, daß .shtml-Seiten als html-Seiten behandelt werden. Wenn diese Option nicht angegeben wird, dann bekommen Sie im Browser eigenartige Download-Fenster zu sehen:AddType text/html .shtml #[1] AddHandler server-parsed .shtml #[2]
In der Die Ausführung von CGI- und shell Komandos kann unterbunden werden mit der OptionOptions +Includes #[3] Options IncludesNOEXEC #[4] | |
| [nach oben] Wenn der Server-Admin es erlaubt (oder nicht bedacht hat), kann man mittels lokaler .htaccess-Dateien Verzeichnisse so konfigurieren, daß es 'doch' klappt :-) | Lokale Konfiguration in .htaccess - Dateien | |
Sie können die Anweisungen [1], [3] und [4] auch in lokalen .htaccess-Dateien angeben, wenn dies in der zentralen Konfiguration mit AllowOverride erlaubt wurde. .htaccess: AddType text/html .shtml #[1] Options +Includes #[3] Für WEB-Admins ohne direkten Server-Zugriff ist dies oft die einzige Möglichkeit. Achten Sie immer darauf, daß die .htaccess-Dateien nicht herunter geladen werden können.
| ||
| [nach oben] | Weiterführende Links | |
| (engl.) Beschreibung des Include-Moduls (Apache) | ||
| (engl.) Beschreibung des CGI-Moduls (Apache) | ||
| Die Options - Direktive des Apache-Servers. | ||
| komplette Apache-Dokumentation (und vieles mehr) | ||
| Weitergehende Erweiterung (die php3-Dateien), mit der sehr viel mächtigere Befehle vom Server ausgeführt werden. php ermöglicht u.a. auch Datenbankanbindungen (mysql). | ||
| Es gibt auch Module für 'richtige' Script-Sprachen wie perl, tcl usw. Hiermit wird der jeweilige Interpreter direkt in den Server 'eingebaut'. Im Gegensatz zu cgi-Scripten werden hier keine externen Prozesse vom Server benötigt (=> schneller). | ||
