style H1

Tutoriels - SSi

SSI : (Server Side Include).

Le langage Ssi peut être inséré à l'intérieur d'un fichier qui sera enregistré au format shtml, avec ce format c'est le serveur qui effectuera le travail. C'est donc lui qui interprètera les instructions, que vous aurez établies. Comme le navigateur n'est pas mis à contribution, la compatibilité est totale.

Ces commandes SSI étant directement interprétés par le serveur, elles n'apparaitront pas dans la source du fichier, mais sera remplacée par le code html que vous aurez établit.

Quelques exemples :

Fonction Description

#INCLUDE Fonction permettant d'inclure un fichier se trouvant dans le meme répertoire ou dans un répertoire supérieur.

#VIRTUAL Cette fonction permet d'inclure un fichier se trouvant dans un répertoire inférieur.

#FLASTMOD Affichera la date de dernière modification du fichier.

#FSIZE Affichera la taille du fichier.

#ECHO Insère la valeur de plusieurs variables d'environnement.

#CONFIG Configure l'affichage des variables et des commandes.

#EXEC Exécute les scripts CGI et l'insère dans un document HTML.

La fonction include virtual

Pour inclure un fichier se trouvant dans un répertoire inférieur vous placerez la commande

<!--#include virtual="/x9-500/ssi/fichier.htm" -->

(reste invisble en fabrication "locale"... si page perso hébergée chez un FAI)

Exemple : [an error occurred while processing this directive]

test -> ou :

<!--#include virtual="/x9-500/pic/petit-x9_transp.gif" -->

(semble ne pas fonctionner avec les fichiers images)

Exemple : [an error occurred while processing this directive]

La fonction include file

Pour inclure un fichier se trouvant dans le même répertoire vous placerez la commande

<!--#include file="fichier.htm" -->
Exemple :

L'argument file donne le chemin de fichier qui est appelé se trouvant dans le même répertoire que le fichier qui appelle (dans ce cas, c'est le fichier que vous lisez qui appelle). Donc le fichier "fichier.html" doit se trouver dans le même répertoire que le fichier qui contient la commande include.

L'argument virtual fait démarrer le nom du fichier depuis la racine du serveur.
Donc le fichier mon_fichier.html se trouve dans le répertoire test/; dans le sous-répertoire web/; et aussi dans le sous-sous-répertoire ssi/.

Ces deux arguments indiquent au serveur où se trouve le fichier, mais c'est le point de départ qui change.
On ne peut pas utiliser ../ pour désigner un nom de fichier, si le nom de fichier se trouve dans le répertoire parent ( du dessous ).

La fonction ECHO:

Pour afficher le nom d'un document

<!--#echo var="DOCUMENT_NAME" -->
Exemple : exemple_de_ssi.shtml

Pour afficher la date d'accès a un fichier

<!--#echo var="DATE_LOCAL" -->
Exemple : Thursday, 11-Mar-2010 21:08:24 CET

Affiche le chemin à partir de la raine de votre site :

<!--#echo var="DOCUMENT_URI" -->
Exemple : /scoot/ssi/exemple_de_ssi.shtml

Pour afficher la date de la dernière modification :

<!--#echo var="LAST_MODIFIED" -->
Exemple : Wednesday, 16-Nov-2005 17:37:59 CET

Pour afficher le lien utilisé pour arriver a la page :

<!--#echo var="HTTP_REFERER" -->

Exemple : (none)

Pour afficher le navigateur employé

<!--#echo var="HTTP_USER_AGENT" -->
Exemple : CCBot/1.0 (+http://www.commoncrawl.org/bot.html)

Pour afficher le logiciel employé par le serveur

<!--#echo var="SERVER_SOFTWARE" -->
Exemple : Apache

Pour afficher le nom du serveur :

<!--#echo var="SERVER_NAME" -->
Exemple : www.pirmil.info

Pour afficher le protocole:

<!--#echo var="SERVER_PROTOCOL" -->
Exemple : HTTP/1.1

Pour afficher le port TCP.

<!--#echo var="SERVER_PORT" -->
Exemple : 80

Pour afficher la méthode HTTP

<!--#echo var="REQUEST_METHOD HTTP" -->
Exemple : (none)

Pour afficher le système de connexion du visiteur

<!--#echo var="REMOTE_HOST" -->
Exemple : (none)

Pour afficher l'adresse IP du visiteur

<!--#echo var="REMOTE_ADDR" -->
Exemple : 38.107.191.101

Pour afficher le nom d'utilisateur

<!--#echo var="AUTH_TYPE" -->
Exemple : (none)

Pour afficher le type d'autorisation utilisée

<!--#echo var="REMOTE_USER" -->
Exemple : (none)

Pour afficher le type de contenu envoyé

<!--#echo var="CONTENT_TYPE MIME" -->
Exemple : (none)

Pour afficher la taille des informations envoyées

<!--#echo var="CONTENT_LENGTH" -->
Exemple : (none)

Pour afficher la date GMT

<!--#echo var="DATE_GMT" -->
Exemple : Thursday, 11-Mar-2010 20:08:24 GMT

Pour afficher le nombre de hits sur cette page

<!--#echo var="PAGE_COUNT" -->
Exemple : (none)

Pour afficher le nombre de documents envoyés par le serveur

<!--#echo var="TOTAL_HITS" -->
Exemple : (none)

Pour afficher l'URL du fichier précédent.

<!--#echo var="REFERRER" -->
Exemple : (none)

La fonction EXEC

Pour insérer la date dans un fichier

<!--#exec cmd="/usr/bin/perl/date" -->
Exemple : Status: 200 Location: /errorhandler?status=500

Pour exécuter un fichier cgi :

<!--#exec cgi="cgi-bin/fichier.cgi" -->

Exemple :

La fonction FSIZE

Pour afficher la taille d'une image située dans un répertoire:

<!--#fsize virtual="images/images.gif" -->

Exemple : 1k

La fonction FLASTMOD

Pour afficher la date de dernière modification du fichier index.htm :

<!--#flastmod virtual="/date.txt" -->

Exemple : [an error occurred while processing this directive]

La fonction CONFIG.

Pour afficher la date: jj/mm/aa :

<!--#config timefmt="%d/%m/%y" -->

Exemple :

Pour afficher la taille des fichiers:

<!--#config sizefmt="bytes" -->

Exemple :

Pour afficher le message d'erreur lorsq'une balise SSI n'est pas correcte

<!--#config errmsg="Erreur SSI" -->

Exemple :

FrontPage express 2.0 Fr

TEST TEST TEST TEST TEST.......................

<- autre idée forum en test

date de mise à jour de cette page : 16/11/05