guide/cgi/cgi.htm - 21/5/98

Common Gateway Interface

Introduzione

Per poter preparare scripts CGI, è sufficiente saper leggere da STDIN e scrivere su STDOUT.
CGI non è un linguaggio, è un protocollo di comunicazione fra pagine HTML e script su server.
Uno script CGI può essere scritto in qualsiasi linguaggio riesca a leggere da STDIN, scrivere su STDOUT e accedere alle variabili di ambiente.
Se lo script è in un linguaggio compilato tipo C, l'eseguibile va in cgi-bin
Se lo script è in un linguaggio di Script tipo Perl, Unix Shell, Applescript ecc., va direttamente in cgi-bin
In cgi-src ci sono alcuni script di esempio

Normalmente uno script CGI agisce in tre fasi:
1. Lettura dell'input proveniente dalla pagina HTML
2. Elaborazione dei dati contenuti
3. Scrittura della risposta su STDOUT

Utilizzo

Le informazioni sottomesse dall'utente arrivano allo script in una stringa con il seguente formato:

name1=value1&name2=value2&name3=value3

dove ciascuna coppia "name/value" rappresenta il nome e il valore di un campo della Form, oppure tutta la stringa proviene da QUERY_STRING (v.dopo). L'estrazione dei dati dalla stringa può essere fatta con una routine come 'getcgivars.c'.
Oltre a ignorare gli '=' e le '&', la routine sostituisce eventuali '+' con blank,
e le sequenze di escape '%xx' nel carattere il cui codice esadecimale è xx.
P.e. converte '%3d' in '='.
1. Url del tipo HTTP://...../cgi-bin/nome-pgm
  Lo script viene attivato senza parametri
2. Url del tipo HTTP://...../cgi-bin/nome-pgm/dir1/dir2
  Lo script viene attivato con la variabile PATH_INFO contenente '/dir1/dir2'
3. Url del tipo HTTP://...../cgi-bin/nome-pgm?stringa
  Lo script viene attivato con la variabile QUERY_STRING contenente 'stringa'
4. Url del tipo HTTP://...../cgi-bin/nome-pgm/dir?stringa
  Lo script viene attivato con la variabile PATH_INFO contenente '/dir' e la variabile QUERY_STRING contenente 'stringa'
5. Attraverso il Submit di una FORM:
  - Per i submit di tipo GET, le coppie 'name=value' (v.sopra) vanno nella variabile QUERY_STRING
  - Per i submit di tipo POST, vanno nello STDIN per il numero di caratteri riportato nella variabile CONTENT_LENGTH.

Se si vuole costruire una pagina HTML da inviare al client, per prima cosa bisogna scrivere su STDOUT una linea contenente il 'mime-type':

Content-Type: text/html

seguita da una linea bianca.
Seguiranno tutte le righe della pagina HTML da inviare all'utente.
Per inviare invece una pagina preesistente, lo scripts CGI deve inviare su STDOUT una riga del tipo:

Location: response.html

seguita da una linea bianca. (in questo caso non bisogna inserire la riga Content-type:)
(La location: può anche essere una Url completa http, ftp, gopher ecc.)
Al posto delle header 'content-type' e 'location', si può inviare su STDOUT una riga del tipo:

Status: nnn xxxxxxxx

seguita da una linea bianca, per segnalare un errore, p.e. 404 Not Found
Se lo script vuole dialogare direttamente con il client, evitando l'intervento del server Web, allora il suo nome deve iniziare per nph; In questo caso lo script dovrà preoccuparsi di inviare una risposta valida HTTP/1.0 (o HTTP/0.9):

HTTP/1.0 200 OK
Server: NCSA/1.0a6
Content-type: text/plain

seguite da una linea bianca e dal testo in chiaro.

Esempi

Il primo programma ("redm_s.cgi") viene chiamato senza parametri con:

HTTP://10.136.1.4:8016/cgi-bin/redm_s.cgi

e restituisce una semplice pagina HTML.
Il secondo programma ("redm.cgi") viene chiamato con:

HTTP://10.136.1.4:8016/cgi-bin/redm.cgi?home=Chieti&favorite=Montenero

e restituisce una pagina HTML dove vengono ripresentati i parametri passati.

COOKIES

Introduzione

Il Cookie è un pezzetto di testo che il server web invia al browser chiedendogli di memorizzarlo sul disco client, da dove poterlo poi reperire;
Una parte del testo può contenere il DNS del server, in modo che soltanto lui potrà rileggerlo;
Per poter inviare un Cookie, il server web deve inserire in testa alla pagina HTML una header "Set-Cookie", che contiene i dati da memorizzare, c.s.:
Set-Cookie: NAME=VALUE; expires=DATE; path=PATH; domain=DOMAIN_NAME; secure

NAME=VALUE: eventualmente URL-encoded, è l'unico obbligatorio
expires=DATE nella forma: Wednesday, DD-Mon-YYYY HH:MM:SS GMT
L'invio di una data già trascorsa provoca la cancellazione di quel Cookie su client
domain=DOMAIN_NAME: deve esserci 'tail-match', p.e. www.chieti.abol.it coincide con il DOMAIN_NAME=abol.it
path=PATH: il Cookie partirà dal client se il path indicato nella URL è compreso nel path specificato nel Set-Cookie (v.esempio)
secure: funziona solo sui server sicuri (HTTPS = HTTP+SSL)
Quando il browser deve inviare una URL al server, confronta la stessa URL con tutti i Cookies disponibili, e accoda quelli coincidenti in una stringa del tipo:
Cookie: NAME1=STRINGA1; NAME=STRINGA2 ...
impostata poi dal server nella variabile di ambiente HTTP_COOKIE
...

Esempio

Sequenza di scambio Cookie
Il cliente invia una URL di richiesta, e riceve, ad esempio, in testa alla pagina HTML di risposta:
Set-Cookie: USERID=REDMIMMO; path=/; expires=Monday, 15-Jun-1998 23:12:40 GMT
Quando il cliente invierà un'altra URL con riferimento al path /, invierà al server:
Cookie: USERID=REDMIMMO
Poniamo che in testa alla pagina di HTML risposta, il cliente riceva:
Set-Cookie: PREFERITO=MONTENERO; path=/
Quando il cliente invierà di nuovo URL sul path /, invierà al server:
Cookie: USERID=REDMIMMO; PREFERITO=MONTENERO
Se poi il server invia una pagina con
Set-Cookie: ABITATO=CHIETI; path=/abruzzo
e il cliente fa poi una richiesta sul path /, invierà di nuovo
Cookie: USERID=REDMIMMO; PREFERITO=MONTENERO
perchè / non comprende le sub-dir
Se invece richiede una pagina sul path /abruzzo, allora invierà
Cookie: USERID=REDMIMMO; PREFERITO=MONTENERO; ABITATO=CHIETI
perchè /abruzzo eredita anche /

PER APPROFONDIRE

www.jmarshall.com/easy/cgi/

hoohoo.ncsa.uiuc.edu/

www.netscape.com/newsref/std/Cookie_spec.html/

	www.jmarshall.com/easy/cgi/
	hoohoo.ncsa.uiuc.edu/
	www.netscape.com/newsref/std/Cookie_spec.html/

Introduzione

Utilizzo

Esempi

Introduzione

Esempio

PER APPROFONDIRE