SSI (pour Server Side Include) est une norme très simple permettant de modifier des pages (ayant le suffixe shtml) avant de les envoyer au client. Elle consiste en une liste de directives qui apparaissent toutes dans le texte de la page sous la forme :
<!--#command tag1="value1" tag2="value2" -->
Ainsi, la directive #include charge le serveur Web d'insérer le contenu d'un fichier dans une page HTML. Le fichier inclus peut contenir tous les contenus valides au sein d'un document HTML.
<!--#include
file="fic"-->
La syntaxe des commentaires ( <!-- commentaire --!> ) est utilisée pour insérer les directives SSI.
Afin d'éviter que le serveur ait à analyser le contenu de toutes les pages, les fichiers contenant des directives devront avoir un nom avec un extension spécifique (.shtml, shtm, stm...).
Autres exemples de directives:
<!--#echo
var="SERVER_NAME"-->
<!--#exec
cmd="netstat -a"-->
Voici un exemple d'utilisation de quelques directives SSI:
<html>
<head>
<title>directives_SSI.stm</title>
</head>
<body>
<p>Nom de la machine : <!--#echo var="SERVER_NAME"--></p>
<p>Date de la machine : <!--#echo var="DATE_LOCAL"--></p>
<p>Nom du document : <!--#echo var="DOCUMENT"--></p>
<p>Document modifié le : <!--#echo var="LAST_MODIFIED"--></p>
<p>Nom du script en cours : <!--#echo var="SCRIPT_NAME"--></p>
<p>Résultat de l'exécution de netstat : <!--#exec cmd="netstat"--></p>
<p>Contenu du fichier netstat-i.txt : <!--#include file="netstat-i.txt"--></p>
<p>Taille du fichier netstat-i.txt : <!--#fsize file="netstat-i.txt"-->Ko</p>
<p>Dernière modification du fichier netstat-i.txt: <!--#flastmod file="netstat-i.txt"--></p>
</body>
</html>