SSI son las siglas de Server Side Includes. Los SSI son una serie de comandos que podemos insertar en nuestros documentos web (*.shtm, *.shtml), pero que no se envían al navegador, sino que son procesados en el mismo servidor, siendo la respuesta del servidor la que se envía al navegador.
Todos los comandos SSI se insertan en una página web del mismo modo, para que funcionen la pagina debe tener la extension .shtm, .shtml. Deben ir dentro de una marca de comentario, y comienzan con el signo #:
<!--#comando SSI -->
Hay muchos comandos SSI, pero probablemente, INCLUDE sea el comando SSI más usado.
Permite introducir el contenido de un fichero en el lugar donde insertas el comando. Su estructura es la siguiente:
<!--#INCLUDE MODO="archivo" -->
Donde MODO puede ser VIRTUAL o FILE, y "archivo" es el nombre y la ruta al archivo cuyo contenido desea insertar.
El parámetro file solo debe ser usado cuando el archivo que va a incluir se encuentra en el mismo directorio de la página web. Por ejemplo :
<!--#include file="archivo.html"
En caso de que usted desee incluir un archivo que se encuentre en un directorio distinto dentro del servidor debe hacer uso del parámetro virtual.
Mediante este parámetro usted puede incluir cualquier archivo que se encuentre dentro del servidor que contiene sus páginas web. El uso de virtual es ligeramente distinto al uso de file, usted ahora debe escribir dentro de las comillas dobles la ruta completa del archivo desde el directorio raíz de sus documentos. Tenga cuidado: esto no significa escribir la ruta completa del archivo dentro del servidor, sino que se refiere al fragmento de la URL del archivo que sigue al nombre del dominio.
Por ejemplo, si sus páginas web están en el servidor web midominio.com y el URL del archivo que usted quiere incluir es:
http://www.midominio.com/micarpeta/archivo.txt
Entonces la ruta que usted debe usar junto con el parámetro virtual es:
/micarpeta/archivo.txt
De esta forma:
<!--#include virtual=”/micarpeta/archivo.txt” -->
Sea muy cuidadoso a la hora de elegir el parámetro que va a utilizar junto con el comando include. Siempre recuerde que por un lado el parámetro file se utiliza para archivos que se encuentran en el mismo directorio y nunca utilizan un slash (/) antes del nombre del archivo. Por otra parte el parámetro virtual se utiliza para archivos que pueden encontrarse en una carpeta diferente dentro del servidor y siempre deben llevar un slash (/) previo seguido de la ruta donde se encuentra el archivo.
