Comandi e variabili Tcl di Rivet

var (get | list | exists | number | all)

Il comando var recupera le informazioni circa le variabili GET o POST, inviando lo script tramite una richiesta del client. Il trattamento di entrambe le variabili GET e POST è identico, in considerazione delle loro origini. Notate che vi sono due forme aggiuntive di var: var_qs e var_post. Queste due forme restringono le informazioni sui parametri ottenendo rispettivamente la querystring (?foo=bar&bee=bop) o la POSTing.

get varname ?default?: Ritorna il valore della variabile varname come una stringa (anche se vi sono valori multipli). Se non esiste come variabile GET o POST, viene restituito il valore ?default?, altrimenti viene ritornato "" (una stringa vuota).
list varname: Restituisce il valore della variabile varname come una lista, se vi sono valori multipli.
exists varname: Restituisce 1 se varname esiste, 0 se non lo è.
number: Restituisce il numero di variabili.
all: Restituisce una lista di nomi di variabili e valori.

Vedete Esempio 3.

Il comando upload è usato per la manipolazione del caricamento dei file. Vedete le principali direttive di Apache per altri tipi di configurazioni del funzionamento di questa caratteristica di Rivet.

channel uploadname: Quando date il nome ad un file caricato, uploadname restituisce un canale Tcl che può essere usato per accedere allo stesso file.
save uploadname filename: Salva uploadname nel file filename.
data uploadname: Restituisce i dati caricati dal server. Questo è il binario pulito. In altre parole, potrà lavorare anche con file come immagini, eseguibili, compressi e così via.
size uploadname: Restituisce la dimensione del file caricato.
type: Se il Content-type è impostato, viene restituito il valore, altrimenti una stringa vuota.
filename uploadname: Viene restituito il nome del file dell'host remoto che ha caricato il file.
names: Restituisce i nomi delle variabili, in una lista, di tutti i file caricati.

See Esempio 4.

load_env ?array_name?

Carica l'array delle variabili d'ambiente all'interno dello specificato nome di array. Utilizza l'array ::request::env come valore predefinito.

Le pagine di Rivet sono eseguite nel namespace ::request, quindi non è necessario precisare il nome dell'array per più utenti, va bene accedervi tramite env.

load_headers array_name

Carica gli header che provengono dalla richiesta di un client all'interno del nome dell'array indicato, o usa headers se non è stato indicato alcun nome.

load_cookies ?array_name?

Carica l'array delle variabili cookie all'interno del nome dell'array indicato. Utilizza l'array cookies come valore predefinito.

include filename_name

Include un file senza analizzarlo per processare i tag <? e ?>. Questo è il metodo migliore per includere un file HTML o qualsiasi altro contenuto statico.

parse filename

Come il comando Tcl source, ma analizza pure i tag di elaborazione per Rivet <? e ?>. Utilizzando questo comando, potete utilizzare diversi file .rvt.

headers (set | redirect | add | type | numeric)

Il comando headers è per l'assegnazione e l'elaborazione di header HTTP.

set headername value: Assegna in modo discrezionale i valori ed i nomi agli header.
redirect uri: Redirige dalla pagina corrente ad un nuovo URI. Questo viene fatto nel primo blocco di codice Tcl.
add headername value: Aggiunge testo all'header headername.
type content-type: Questo comando assegna l'header Content-type ritornato dallo script, è utile se desiderate inviare, con Rivet, altri contenuti oltre all'HTML (PNG o immagini jpeg, per esempio).
numeric response code: Assegna un codice di risposta numerico, come per esempio 200, 404 o 500.

makeurl filename

Crea una URL di riferimento a se stesso dal nome di un file. Per esempio:

makeurl /tclp.gif

restituisce http://[hostname]:[port]/tclp.gif. Dove hostname e port sono il nome dell'host e la porta del server in questione.


Direttive di Apache		Esempi ed uso