SSI

Dieser Artikel wurde für die folgenden Ubuntu-Versionen getestet:

Ubuntu 16.04 Xenial Xerus
Ubuntu 12.04 Precise Pangolin

Zum Verständnis dieses Artikels sind folgende Seiten hilfreich:

Inhaltsverzeichnis

Vorbereitung
Seitenspezifische Einstellungen
Test
Sicherheit
Links

SSI {de} (Server Side Includes) ist ein Modul für Apache, um serverseitig Daten einzubinden. Dieses Modul bietet die Möglichkeit, Daten einzubinden (engl. include, so kann man Frames ersetzen) und kleine Funktionen auszuführen, wie zum Beispiel das Ausgeben des aktuellen Datums. Oft wird es auf Servern angeboten, denen kein PHP oder Ähnliches zur Verfügung gestellt wird. Dieser Artikel behandelt die SSI-Technik mit Apache 2.2.

Vorbereitung¶

Als erstes muss das Modul include (umgangssprachlich mod_include) geladen werden:

sudo a2enmod include

Hinweis:

Nach dem Laden des Moduls muss der Apache Webserver neu gestartet werden (force-reload)^[4].

Seitenspezifische Einstellungen¶

Das Modul mod_include ist standardmäßig richtig vorkonfiguriert. Dateien mit der Endung .shtml werden von mod_include verarbeitet. Dies geschieht aber nur, wenn die Options-Direktive die Option +Includes aktiviert hat. Hierzu genügt Folgendes in dem entsprechenden Directory-Eintrag der Virtual-Host-Konfiguration:

<Directory /nur/ein/beispiel>
...
Options Indexes FollowSymLinks MultiViews +Includes
...
</Directory>

Hinweis:

Nach dieser Änderung muss der Apache Webserver neu gestartet werden (force-reload)^[4].

Test¶

Um das Modul zu testen wird eine neue Seite, z.B. /var/www/ssi-test.shtml (ab Ubuntu 13.10 /var/www/html/ssi-test.shtml), in einem beliebigen Editor ^[2] mit Root-Rechten ^[3] angelegt; zusätzlich muss die /etc/apache2/sites-available/default wie oben beschrieben angepasst werden. Diese sollte so aussehen:

<html>
  <head>
    <title>SSI Test Page</title>
  </head>
  <body>
    <!--#echo var="DATE_LOCAL" -->
  </body>
</html>

Nachdem die Seite gespeichert wurde, sollte beim Aufruf von http://localhost/ssi-test.shtml das aktuelle Datum mit Zeit sichtbar sein.

Sicherheit¶

Um den eigenen Server durch SSI nicht unnötigen Sicherheitsrisiken auszusetzen, sei an dieser Stelle noch auf die Original-Dokumentation von Apache verwiesen: