Comandi SSI (Server Side Include)

I comandi SSI vengono eseguiti dal server man mano che un documento HTML viene "letto", e vengono utilizzati per includere nel documento particolari variabili ambientali del server, come ad esempio la data e l'ora.

I documenti HTML contenenti comandi SSI devono avere estensione .shtml
 
L' inclusione di comandi SSI in un documento HTML e' semplice, a patto che si rispetti correttamente questa sintassi:

<!--#comando argomento="valore" -->

Assicurarsi di lasciare uno spazio immediatamente dopo l'ultimo doppio apice (") che racchiude il valore.

COMANDO ECHO

Il comando echo permette di visualizzare il contenuto delle seguenti 5 variabili ambientali del server:

• Date_Local
  Data ed ora locale (dipende dalla posizione geografica del server)
• Date_GMT
  Data ed ora al meridiano di Greenwich
• Document_Name
  Nome del file del documento
• Document_URL
  Percorso e nome del file del documento
• Last_Modified
  Data ed ora in dell'ultima modifica apportata al documento.

Esempio:
Visualizzare data ed ora locale del server:

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

output:
Monday, 14-Jul-97 11:33:04 EDT

 

COMANDO CONFIG

IL comando config puo' essere usato per configurare l'output standard delle diverse variabili ambiente. Nell'esempio che segue, vengono utilizzati due comandi SSI per produrre un formato alternativo di data ed ora:

<!--#config timefmt="%A, %B %d, %Y %I:%M%p" -- >
<!--#echo var="date_local" -- >

output:
Monday, July 14, 1997 11:33AM

Codici utilizzati nell'esempio:

%A - Nome del giorno della settimana
%B - Nome del mese
%d - Giorno del mese
%Y - Anno
%I - Ore
%M - Minuti
%p - p.m. (in opposizione a %a, a.m.)

 

ALTRI COMANDI SSI

fsize
Il comando fsize restituisce le dimensioni di un dato file:

<!--#fsize file="image.gif" -->

output:
10k

include
Il comando include puo' essere utilizzato per inserire un file o una immagine in un documento HTML. Il file o l'immagine aggiunti appariranno come parte del documento originale:

<!--#include file="nomefile" -->

Se il file da includere e' in una directory differente da quella del documento SHTML, utilizzare il comando virtual. Nell'esempio che segue, il documento SHTML risiede in una subdirectory, mentre il file da in cludere risiede nella root:

<!--#include virtual="/nomefile" -->

exec
Il comando exec permette di eseguire uno script CGI al momento del caricamento della pagina. Nell'esempio viene eseguito lo script date.pl, il cui percorso e' /cgi-local

<!--#exec cgi="/cgi-local/date.pl" -->

Per ulteriori informazioni, consultare questi siti.