ALL HTML - SSI avancés

retour

SSI avancés

Article publié le lundi 29 mars 2004 par ALL HTML.
Cet article est classé dans les catégories « PERL »

Note : Il n'existe pas de listes de commandes applicables à tous les serveurs (même si certaines commandes comme "echo" ou "include" sont quasiment toujours présentes). Demandez à votre administrateur la documentation des SSI supportés par votre serveur.

include : permet d'inclure un autre fichier dans le fichier shtml. Cette commande ne peut pas inclure le résultat d'un script CGI. Elle offre deux arguments possibles: virtual et file.

"Virtual" est utilisé quand le chemin vers le document est en rapport avec la racine de votre site (en principe votre répertoire /docs/).

"File" est utilisé quand le chemin vers le document est en rapport avec le fichier shtml lui-même. Cependant, vous ne pouvez utiliser "file" pour monter d'un répertoire (par exemple : "../index.html" ne marchera pas).

Exemples : si vous souhaitez inclure le fichier nommé "fichier.html" qui est situé dans le même sous répertoire /ssi que ce fichier shtml:

Pour l'inclure en utilisant "virtual", vous utiliserez :


<!--#include virtual="/ssi/fichier.html" -->

Pour l'inclure en utilisant "file", vous utiliserez :


<!--#include file="fichier.html" -->

echo : affiche le contenu des variables environnement.

Exemples :

Affiche le nom du document :


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

Date d'accès au document (précisez date_gmt pour obtenir l'horaire GMT) :


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

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


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

Affiche la date de la dernière modification :


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

Affiche le lien utilisé pour arrivé vers votre site :


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

Affiche le navigateur utilisé pour accéder à ce document :


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

Autres arguments de la commande echo :

- server_software : Logiciel utilisé par le serveur
- server_name : Nom du serveur
- server_protocol : Protocole
- server_port : Port TCP
- request_method http : Méthode HTTP du client
- remote_host : Nom de domaine du client
- remote_addr : Adresse IP du client
- auth_type : Type d'autorisation utilisé
- remote_user : Nom d'utilisateur
- content_type mime : Type de contenu envoyé
- content_length : Taille des informations envoyées
- document_name : Nom du document demandé
- document_url : URL du document demandé
- date_local : Date locale, format défini par la commande config
- date_gmt : Date GMT, format défini par la commande config
- last_modified : Date de modification du document, format défini par la commande config
- page_count : Nombre de hits sur ce fichier
- total_hits : Nombre de documents envoyés par le serveur
- referrer : URL du document précédent

exec : exécute une commande Unix ou un script CGI.

Note : Attention ! La commande exec peut être désactivée (tout en laissant les autres fonctions SSI actives) sur certains serveurs, pour des raisons de sécurité.

Exemples :

Ceci exécute la commande Unix date :


<!--#exec cmd="/usr/bin/perl/date" -->

Ceci exécute le script CGI : pub.cgi :


<!--#exec cgi="cgi/pub.cgi" -->

Le script CGI peut être de la forme :


#!/usr/bin/perl
echo "ALL HTML, Portail dédié aux Webmasters"

fsize : retourne la taille du fichier spécifié en octet.

Exemples :

Taille de l'image logo.gif située dans le répertoire gif de votre site :


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

flastmod : renvoie la date de la dernière modification d'un fichier.

Exemples :

Date de dernière modification du fichier aide.txt situé dans le répertoire texte de votre site :


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

config : cette commande est utilisée pour personnaliser l'affichage des résultats d'autres SSI.

Trois arguments sont possibles :

- timefmt : pour le format de la date.
- sizefmt : pour le format de la taille des fichiers.
- errmesg : pour définir les messages d'erreur retournés quand une balise SSI est incorrecte.

Exemples

Format d'affichage de la date sous la forme : jj/mm/aa :