Page suivante Page précédente Table des matières

2. Les SSI

2.1 La syntaxe de base

L'appel à une commande SSI se fait ainsi :

<!――#COMMANDE PARAM="VALEUR" ――>

Par exemple :

<!――#echo var="DATE_LOCAL" ――>

Donne l'heure locale du serveur HTTP :

Fri Sep 10 01:21:01 1999

De plus, il faut que le document en question ait une extension .shtml, .shtm ou .sht.

2.2 Les variables standards

Les variables sont des références sur un certain nombre d'information auxquel on peut accéder via les SSI. Le contenu d'une variable est toujours une chaîne de caractères.

Voici une liste des variables les plus courantes :

2.3 Les commandes

break

La commande break permet de terminer le document HTML à un point quelconque. On l'utilise le plus souvent en la combinant avec un if.

Exemple :

<!――#break ――>

config

La commande config permet de positionner un certain nombre d'options de sortie HTML.

Exemple :

<!――#config errmsg="error.txt" onerr="break" ――>

echo

La commande echo permet d'insérer dynamiquement du texte dans les documents HTML. Le paramètre associé à echo est var.

Outre des chaînes de caractères classiques, echo dispose d'un certain nombre de variables prédéfinies (celles-ci varient d'un serveur à l'autre). Mais rien n'empêche d'utiliser des variables que l'on a fixées nous même.

Exemple :

<!――#echo var="LAST_MODIFIED" ――>

email

La commande email permet d'envoyer un courrier électronique dès qu'une page est accédée ou qu'un formulaire est soumis. Les paramètres fromhost, tohost, fromaddress et toaddress doivent être renseignés, les autres étant facultatifs.

Voici la liste des paramètres :

exec

La commande exec permet d'exécuter une commande quelconque sur le système d'exploitation du serveur Web.

Voici la liste des paramètres :

Exemple :

<!――#exec cmd="ls -l" ――>

Donne :


total 56
-rw-r--r--   1 root     root        26796 Oct 14  1998 main.c
-rw-r--r--   1 root     root        26447 Jul 13  1998 main.c.pre14
-rw-r--r--   1 root     root          723 Nov 19  1995 version.c

flastmod

Cette commande permet d'insérer la date de la dernière modification d'un fichier dans une page HTML. Il possède deux paramètres :

Exemple :

<!――#flastmod file="exemple.html" ――>

fsize

Cette commande permet d'insérer la taille d'un fichier dans une page HTML. Comme pour flastmod, elle possède deux paramètres :

Exemple :

<!――#fsize virtual|file="exemple.html" ――>

Le | permet de faire un ou logique (soit virtual, soit file).

goto

La commande goto permet de sauter vers une étiquette #label sans tenir compte du code entre l'instruction courante et l'étiquette. Cette commande ne comporte pas de paramètres.

Exemple :


<!――#goto ="etiquette" ――>
  <P> n'est pas imprimé...
<!――#label ="etiquette" ――>
  <P> est imprimé!

if

Cette commande permet d'effectuer une exécution sous certaines conditions. Pas de paramètres. La syntaxe est la suivante :

<!――#if "opérande1" comparaison "opérande2" commande ――>

Exemple :


<!――#if "REMOTE_ADDR" != "197.200.17.2" goto="hide"――>
<A href="secret-link.html">Lien secret</A>
<!――#label ="hide"――>

include

La commande include permet d'inclure le contenu d'un fichier à l'endroit de la commande. Comme pour flastmod, elle possède deux paramètres :

Exemple :

<!――#include file="exemple.html" ――>

label

Cette commande permet de positionner une étiquette pour un goto (voir goto).

obdc

La commande odbc permet de soumettre des requêtes à une base de données et de la mettre à jour. Les fonctionnalités disponibles sont vraiment minimales, mais permettent de passer des commandes SQL à un serveur de base de données (ce qui est déjà pas mal).

L'inconvénient est que l'on est vite limité par la langage. Pour faire quelque chose de plus gros, l faudra se tourner vers les CGI ou le langage PHP.

Quatre paramètres sont possibles :

Exemple :


<!――#odbc connect="mabase,gilles,toto" ――> 
<!――#odbc statement="SELECT NOM, AGE" ――>
<!――#obdc format="%s a %s ans<P>" ――>

Résultat :

Gilles a 34 ans


Page suivante Page précédente Table des matières