SSI : Server Side Include. il s'agit d'un standard permettant de demander au server WEB a/ d'analyser le contenu des pages Html qu'il va servir b/ de remplacer certains ordres SSI spécifiques par - une valeur ou - un fichier copié Pour des problèmes évidents de temps de réponses, seules certaines pages seront analysées, suivant leur extension ( serveur d'origine ): la norme est .shtml et/ou .htmls vous devez commencer par indiquer ces deux nouveaux types MIME par Addtype .shtml text/x-ssi-html 8bit 1.0 Addtype .htmls text/x-ssi-html 8bit 1.0 Pour Apache, vous devez autoriser par Option +indexes |
Vous pouvez maintenant inclure des ordres SSI dans vos pages HTML portant l'extension .shtml (ou .htmls) les ordres se présentent sous la forme de commentaires particuliers : <!--#directive tag=valeur --> l'ordre le plus utilisé est #include qui permet d'inclure automatiquement des bandeaux ou des pieds de page à chaque page html. <!--#include file="/repertoire/fichier.html"--> file, fait référence à un chemin réel sur le serveur <!--#include virtual"/repertoire/fichier.html"--> virtual, fait référence à une url (subit donc les "pass" et autres transformations) |
Autres directives #fsize file="x/y" affiche la taille d'un fichier virtual="x/y" idem (voir include) #flastmode file="x/y" affiche date/heure de dernière modif virtual="x/y" idem (voir include) #exec cgi=nom-de-pgm appel un pgm CGI #global var=nom value=valeur renseigne une variable d'environement #set var=nom value=valeur renseigne une variable locale à SSI. (déclaration implicite) #echo var=nom affiche le contenu d'une variable d'env. ou d'une variable fixée par #set. |
variables d'environement particulières : DATE_GMT, DATE_LOCAL DOCUMENT_NAME, DOCUMENT_URL LAST_MODIFIED SSI_DIR (répertoire du fichier inclus) SSI_FILE (nom du fichier inclus) SSI_PARENT(nom du fichier parent) SSI_ROOT (répertoire du fichier de premier niveau) les caractères spéciaux suivants sont admis par la cde echo : +------------------------------------------------------------------------+ ¦ \a ¦ Sonnerie (bell) ¦ +----+-------------------------------------------------------------------¦ ¦ \b ¦ anti slash ¦ +----+-------------------------------------------------------------------¦ ¦ \f ¦ Form feed (nouvelle page) ¦ +----+-------------------------------------------------------------------¦ ¦ \n ¦ Nouvelle ligne ¦ +----+-------------------------------------------------------------------¦ |
+----+-------------------------------------------------------------------¦ ¦ \r ¦ retour charriot ¦ +----+-------------------------------------------------------------------¦ ¦ \t ¦ tabulation horizontale ¦ +----+-------------------------------------------------------------------¦ ¦ \v ¦ tabulation verticale ¦ +----+-------------------------------------------------------------------¦ ¦ \' ¦ quote (apostrophe) ¦ +----+-------------------------------------------------------------------¦ ¦ \" ¦ guillemet ¦ +----+-------------------------------------------------------------------¦ ¦ \? ¦ point d'interrogation ¦ +----+-------------------------------------------------------------------¦ ¦ \\ ¦ anti slash ¦ +----+-------------------------------------------------------------------¦ ¦ \- ¦ tiret haut ¦ +----+-------------------------------------------------------------------¦ ¦ \. ¦ le point ¦ +----+-------------------------------------------------------------------¦ ¦ \& ¦ et commercial ¦ +------------------------------------------------------------------------+ |