Server Side Includes

SSI är korta kommandon som skrivs in i dokumentet. Dessa kommandon tillåter skapandet av dokument med dynamisk genererad information. Dynamisk genererad information är information som inte finns i dokumentet men infogas av servern först då dokument har begärts. Det kan vara nuvarande tid, information från vilken server dokumentet har begärts eller infogandet av någon annan information t ex ett annat dokument.

SSI fungerar oberoende av plattform dvs hård- och mjukvara. Tyvärr, inte alla leverantörer tillåter sina kunder att ha tillgång till SSI p.g.a. en viss säkerhetsrisk. Om din leverantör inte tillåter SSI använd ett skript istället. Ett skriptexempel finns nedan.

De flesta dokument visas på det sätt de är strukturerade. För att ett dokument ska visas med ett annat innehåll, t ex även innehålla information som inte finns i det måste man tala om för servern att dokumentet dels behöver bearbetas/analyseras innan det skickas vidare dels vad som ska göras. (En sådan analys kallas för parsing.) Man talar om för servern att ett vist dokument ska bearbetas genom att lägga (för det mesta) .shtm (server parsed html) till dokumentets namn. M.a.o. ett dokument heter t ex index.shtml och inte index.html.

Genom att inkludera SSI-kommandon i dokumentet talar man om för servern vad den ska göra. SSI-kommandon skrivs in i dokumentet som HTML-kommentarer.

<!-- Detta är en HTML-kommentar -->

Normalt ignoreras alla kommentarer - de visas inte på skärmen. För att servern skulle förstå att just denna kommentar inte ska ignoreras därför att den innehåller ett SSI-kommando börjar man kommentaren med tecknet # (stege) som följs direkt av ett nyckelord. Nyckelordet talar om för servern vad den ska göra. T ex nyckelordet include säger att en annan fil ska inkluderas.

SSI:er skrivs som osynliga kommentarer dvs mellan .

<!--#kommando tag1="värde1" tag2="värde2" -->

OBS! Kommandon kan skiljas beroende på serverinställningar. De flesta av följande kommandon får stöd hos Algonet som deras Apache server. Exempel på "levande" SSI finns på http://vonpepel.com/ref/exempel/test.shtml

#exec

Exekverar ett cgi-program men sällan tillåts p.g.a. säkerhetsskäl

<!--#exec cgi="cgi_fil_namn" -->

Börja från dokumentets rot om du vill uppge hela sökvägen, t ex "/användarnamn/sökväg/cgi_fil_namn".

Med #exec kan du även skapa OS-kommandon. Kommandon skapas med hjälp av argument cmd

<!--#exec cmd="system_kommandon" -->

Om du är t ex på UNIX och vill lista alla filer i det auktuella biblioteket, skriver du:

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

Om du vill exekvera fler än ett kommando, lista dem ett efter ett och separera med ett semikolon.

#include

Du kan även inkludera en HTML-fil, dvs fil med tillägget .html. Men var noga med att inte ha i denna fil element som bara får förekomma en gång per dokument, såsom elementet HTML, hela huvuddelen och elementet BODY. Finns det (t ex) två BODY i ett dokument kommer dokumentet att vara ogiltigt.

virtual

Anger en virtuell sökväg till ett dokument som finns på servern

<!--#include virtual="/~server/virtual_dokument.txt"-->

file

Anger en sökväg till det aktuella biblioteket

<!--#include file="dokument.txt"-->

#fsize

Skriver ut storleken av den angivna filen

<!--#fsize file="dokument.txt"-->

flastmod

Skriver ut datum av senaste redigeringen av det angivna dokumentet

<!--#flastmod file="dokument.txt"-->

#config

filanalys - har två taggar

errmsg

kontrollerar vilka meddelanden som skickas vid eventuella fel. Felen registreras i en log fil

<!--#config errmsg="[Något meddelande!]"-->

sizefmt

bestämmer formateringen

<!--#config sizefmt="bytes"-->

#echo

Skriver ut värde av den angivna variabeln. Har bara en tag - var

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

Variabler - #echo

(inte alla får support - vilka får och vilka inte beror på serverns konfiguration)

• <!--#echo var="DATE_LOCAL"-->
  datum och lokal tid
  (t ex: 04/14/96 2:43 PM)
• <!--#echo var="DATE_GMT"-->
  Greenwich Mean datum och tid
  (t ex: Friday, 12-Apr-96 21:14:30 GMT)
• <!--#echo var="DOCUMENT_NAME"-->
  namn på det aktuella dokumentet
  (t ex: ssi.htm)
• <!--#echo var="DOCUMENT_URI"-->
  visar den lokala sökvägen av det aktuella dokumentet
• <!--#echo var="REMOTE_ADDR"-->
  fjärrserverns IP adress
  (t ex: 193.12.207.1)
• <!--#echo var="REMOTE_HOST"-->
  fjärrserverns namn
  (t ex: aristotle.algonet.se)
• <!--#echo var="REMOTE_USER"-->
  fjärr-användarnamn
• <!--#echo var="REMOTE_IDENT"-->
  visar om support ges åt RFC931-identifikationen
• <!--#echo var="SERVER_NAME"-->
  serverns lokala datornamn
  (t ex: www.algonet.se)
• <!--#echo var="SERVER_PROTOCOL"-->
  HTTP:s namn/version av den aktuella servern
  (t ex: HTTP/1.0)
• <!--#echo var="SERVER_SOFTWARE"-->
  HTTP-serverns programvara
  (t ex: Apache/1.0.3)
• <!--#echo var="SERVER_PORT"-->
  HTTP:s IP port
  (t ex: 80)
• <!--#echo var="HTTP_ACCEPT"-->
  mime typer som får stöd av fjärrservern
  (t ex: image/gif, image/x-xbitmap, image/jpeg, */*)
• <!--#echo var="HTTP_USER_AGENT"-->
  namn på bläddrare som används av fjärrservern
  (t ex: Mozilla/1.22 (compatible; MSIE 2.0; Windows 95))
• <!--#echo var="HTTP_REFERER"-->
  URL av ett HTML-dokument som refererade till fjärrdokumentet
• <!--#echo var="HTTP_COOKIE"-->
  cookie som skickas från fjärrservern
  (t ex: s=aristotle18288829419709252)
• <!--#echo var="GATEWAY_INTERFACE"-->
  namn/version på Common Gateway Interface som är tillgänglig på den aktuella HTTP-servern
  (t ex: CGI/1.1)
• <!--#echo var="REQUEST_METHOD"-->
  metod som används när det aktuella dokumentet begärs
  (t ex: GET)
• <!--#echo var="SCRIPT_NAME"-->
  sökväg till ett skript
  (t ex: /htbin/cgiwrap )
• <!--#echo var="CONTENT_TYPE"-->
  content type av bifogade info som används med attributen POST eller PUT
• <!--#echo var="CONTENT_LENGTH"-->
  längd på bifogade info som används med attributen POST eller PUT
• <!--#echo var="PATH_INFO"-->
  extra info om sökvägen
• <!--#echo var="PATH_TRANSLATED"-->
  som PATH_INFO men med speciella shell-tecken som bytts ut av det lokala systemet
• <!--#echo var="LAST_MODIFIED"-->
  senaste andringsdatum och tid
• <!--#echo var="FROM"-->
  fjärranvändarens namn (oftast epost adress)
• <!--#echo var="FORWARDED"-->
  namn på proxy-servern som "behandlar" det aktuella dokumentet
• <!--#echo var="ACCEPT_LANGUGE"-->
  listar människospråk som accepteras av fjärrservern
• <!--#echo var="QUERY_STRING"-->
  query sträng från fjärrbrowsern
  (t ex: user=användarnamn&script=skriptnamn.sh)
• <!--#echo var="QUERY_STRING_UNESCAPED"-->
  som ovan men unescaped, dvs ASCII motsvarigheter
• <!--#echo var="AUTH_TYPE"-->
  fastställningstyp av fjärrautenticitet

#!/bin/sh
echo "Content-type: text/html"
echo ""
cat << _EOF_

<HTML>
<BODY inklusive alla eventuella attribut>
(här skriver man sitt html-dokument på "vanligt" sätt. När det är dax för SSI skriver man t ex:)

<PRE>
Du använder dig av browser: $HTTP_USER_AGENT
Din adress är: $REMOTE_ADDR
</PRE>
</BODY>
</HTML>

_EOF_

exit

Dokumentet namnges t ex dokument.sh, laddas upp till servern som ASCII, ges chmod 755-rättigheter och anropas (länkas) från ett annat dokument, t ex:

<A HREF="/htbin/cgiwrap&user =användarnamn&script=dokument.sh">Skriptet</A> (OBS! inga mellanslag)

Upp | HTML-referensbok | Referensböcker