SSI: Comanda include

La comanda include és una de les múltiples comandes que permet SSI, però per la seva gran utilitat i simplicitat d’ús és la primera que s’ha de conèixer.

SSI (Server Side Includes) són comandes ubicades al HTML i avaluades pel servidor cada cop que es sol·licita el document, permeten l’ús d’alguns elements dinàmics a les nostres pàgines sense necessitat d’un llenguatge de programació.

El SSI està suportat pels servidors web més estesos, però els exemples que aquí veurem són per l’Apache.

El primer que cal fer és habilitar el SSI a l’Apache. Per fer-ho hi ha dues maneres possibles, de les que només en veurem una: Afegir les següents línies al httpd.conf (si teniu accés a la configuració global del servidor) o en un fitxer .htaccess ubicat al directori on vulgueu habilitar el SSI (que serà en la majoria dels casos).

Options +IncludesNoExec
AddType text/html .shtml
AddHandler server-parsed .shtml

Amb aquestes línies li estem dient a l’Apache que ha d’interpretar els documents amb extensió shtml. Ara anem a veure la sintaxis de la comanda include:

  • <!--#include virtual="fitxer.ext"--> o bé
  • <!--#include file="fitxer.ext"-->

Veiem-ne un exemple en funcionament. Tenim tres fitxers anomenats index.shtml, titol.txt i peu.txt ubicats al mateix directori:

  • index.shtml

    <!--#include file="titol.txt"-->
    <p>Contingut de la pàgina</p>
    <!–#include file=”peu.txt”–>

  • titol.txt

    <html>
    <head>
    <title>Títol de la pàgina</title>
    </head>
    <body>

  • peu.txt

    <p>Peu de pàgina</p>
    </body>
    </html>

El resultat final seria aquest:

<html>
<head>
<title>Títol de la pàgina</title>
</head>
<body>
<p>Contingut de la pàgina</p>
<p>Peu de pàgina</p>
</body>
</html>

Ã?til oi? Ideal per facilitar el manteniment d’un lloc sencer o prescindir de les molestes plantilles de Dreamweaver sense necessitat d’utilitzar un llenguatge de programació com ara PHP.

Fonts d’informació:

Tags:

2 Responses to “SSI: Comanda include”

  1. mesmarge Says:

    Però l’efecte quin seria? que canviant el fitxer peu.txt et canvia tot le paragraf “<p>Peu de pàgina</p>” no? i no es podria fer unaltre contingut.txt pel paragraf “<p>Contingut de pàgina</p>”, disculpa pel meu total desconeixement.

  2. Monitotxi Says:

    La gràcia d’utilitzar la comanda include és que si per exemple utilitzes un peu de pàgina igual a tots els documents d’un lloc, canviant el fitxer que conté el peu el canvies a tots (sense necessitat d’anar un per un fent els canvis).

    Com molt bé dius també es podria crear un fitxer per al contingut, però la utilitat més habitual dels includes és per a trossos de codi HTML que són iguals al llarg de tot el lloc (per exemple un titol, un menú o un peu de pàgina.