imported>Summerbrize: Referenz aktualisiert

2026-02-10T22:15:14Z

Referenz aktualisiert

Neue Seite

{{Weiterleitungshinweis|Shtml|Weitere Bedeutungen sind unter [[SHTML]] zu finden.}}
'''Server Side Includes''' ({{enS}} für ''serverseitige Einbindungen''), auch bekannt als '''SSI''', sind in (meist [[HTML]]-)Dokumente eingebettete, einfach zu nutzende [[Skriptsprache|Skript-Befehle]], die auf dem [[Webserver]] ausgeführt werden, bevor das Dokument an den [[Client]] ausgeliefert wird. Sie stellen eine einfach zu verwendende Alternative zu Programmen bzw. Skripten dar, die das ganze Dokument dynamisch generieren. Die Sprache ist [[Turing-Vollständigkeit|Turing-vollständig]].<ref>https://www.janschejbal.de/projekte/ssituring/ Server Side Includes Turing machine, Jan Schejbal, zuletzt abgerufen am 12. August 2010.</ref>

== Entstehung ==

SSI wurden erstmals mit der [[Apache HTTP Server]] Version 1.0 im April 1995 veröffentlicht und waren Bestandteil des Apache-Moduls <code>mod_include</code>.<ref>[https://web.archive.org/web/19961028121928/http://www.apache.org/docs/1.0/modules.html Apache.org – Apache Modules] (archive.org [abgerufen am 10. Februar 2026]).</ref> Heutzutage unterstützen auch andere Webserver die [[Skriptsprache]], unter anderem der [[Microsoft Internet Information Services|IIS]] von [[Microsoft]].

== Verwendung ==
Mit SSI kann der statische Inhalt einer [[Datei]] oder die dynamische Ausgabe eines Programms/Skriptes in ein Dokument eingefügt werden. Die zur Verfügung stehenden Befehle sind bewusst spartanisch gehalten: [[Verzweigung (Programmierung)|Fallunterscheidungen]], [[Variable (Programmierung)|Variablen]] speichern und ausgeben, [[Common Gateway Interface|CGI]]-Programme ausführen oder andere Dateien einbinden.

=== Syntax ===
Server Side Includes haben die folgende [[Syntax]]:
:<code></code>

Das einleitende <code></code> entsprechen den Zeichen für Beginn und Ende eines [[Hypertext Markup Language|HTML]]- oder [[Extensible Markup Language|XML]]-Kommentares und sorgen dafür, dass der [[Webbrowser|Browser]] die Befehle nicht anzeigt, falls SSI deaktiviert ist.

=== Wichtige Befehle ===
{| class="wikitable"
|-class="hintergrundfarbe6"
!Befehl!!Parameter!!Beschreibung!!Beispiel
|- valign="top"
!include
|''file'' oder ''virtual''
|Sorgt dafür, dass der Inhalt der Datei eingefügt wird. ''file'' adressiert diese Datei relativ zum aktuellen Verzeichnis, ''virtual'' relativ zum Root-Dokument-Verzeichnis.
|style="background-color: #fff;" |<code></code>
<code></code>
|- valign="top"
!|set
|''var'', ''value'' oder ''errmsg''
|Schreibt Inhalt von ''value'' in die Variable ''var''. ''Errmsg'' definiert die Standard-Fehlermeldung, die bei den nächsten Fehlern ausgegeben werden soll. Kann z. B. vor ein SSI-Include gesetzt werden und wird dann angezeigt, wenn die Datei nicht geladen werden kann.
|style="background-color: #fff;" |<code></code> oder <code></code>
|- valign="top"
!echo
|''var''
|Gibt Variable ''var'' wieder. Es kann sich dabei um selbstdefinierte Variablen handeln oder um [[Common Gateway Interface|CGI]]-[[Umgebungsvariable]]n wie z. B. <code>${REMOTE_ADDR}</code>.
|style="background-color: #fff;" |<code></code>
|- valign="top"
!exec
|''cgi'' oder ''cmd''
|Führt das Programm ''cgi'' oder den Befehl ''cmd'' aus und fügt dessen Ausgabe ein.
|style="background-color: #fff;" |<code></code>
|- valign="top"
!if
|''expr''
|Prüft den Ausdruck ''expr'', gültig sind dabei = gleich, != ungleich, < kleiner, > größer oder ein [[regulärer Ausdruck]]. Es können mehrere Kriterien aneinander gereiht werden, indem man sie mit <nowiki>||</nowiki> für ODER oder && für UND voneinander trennt.
Ein praktischer Einsatzzweck ist beispielsweise die Internationalisierung einer Webseite:
|style="background-color: #fff;" |<code> HTML  </code> 
<code>
 
FR Inhalt 
 
EN Inhalt 

DE Inhalt 
</code>
|}

=== X-Bit-Hack ===
Der Webserver erkennt HTML-Seiten mit Server Side Includes meist an der [[Dateiendung]] <code>.shtml</code> oder <code>.stm</code>. Somit müssen nicht sämtliche HTML-Seiten nach SSI-Befehlen durchsucht werden, was die Seitenauslieferung beschleunigt. Um allerdings vor dem Benutzer die Verwendung von SSI zu verbergen, besteht eine Alternative, die zuerst vom Apache-Webserver eingeführt wurde. Dabei werden HTML-Dateien, die SSI-Anweisungen enthalten, an einem speziellen Datei-Attribut erkannt. Es handelt sich dabei um den sogenannten „X-Bit-Hack“. Ist diese Funktion im Webserver aktiviert (z. B. durch die Direktive <code>XBitHack on</code> in der .htaccess-Datei), werden alle HTML-Seiten, bei denen das [[Unix-Dateirechte#Grundlegende Rechte|Ausführ-Bit]] (''execute'' bit) gesetzt ist, vom SSI-Interpreter ausgewertet, ehe sie an den Client ausgeliefert werden. Da die Dateirechte vom Client aus nicht sichtbar sind, kann so die Verwendung von SSI vor dem Benutzer verborgen werden.

== Ähnliche Konzepte ==
* Syntaktisch verwandt sind die Programmiersprachen [[PHP]], [[Active Server Pages|ASP]] und [[JavaServer Pages|JSP]], bei denen dynamisch generierter Code durch eine besondere Kennzeichnung in statischem HTML eingebettet werden kann.

== Weblinks ==
* [http://httpd.apache.org/docs/2.0/howto/ssi.html Apache Tutorial: Introduction to Server Side Includes], englischsprachiges [[Tutorial]] vom Apache-Projekt
* [http://www.w3.org/Jigsaw/Doc/User/SSI.html Server Side Include commands], kurze, englischsprachige Übersicht vom [[W3C]]
* [[SELFHTML]]: [https://wiki.selfhtml.org/wiki/Webserver/SSI Server Side Includes], deutschsprachige Dokumentation
* [http://www.apacheweek.com/features/ssi Using Server Side Includes], kurzer englischsprachiger Einführungsartikel, erschienen in der Zeitschrift [[Apache Week]]

== Einzelnachweise ==
<references />

[[Kategorie:Skriptsprache]]
[[Kategorie:Web-Entwicklung]]

Server Side Includes - Versionsgeschichte

imported>Summerbrize: Referenz aktualisiert