1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
|
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Apache Rivet</title><link rel="stylesheet" href="rivet.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.66.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="it"><div class="titlepage"><div><div><h1 class="title"><a name="id4744907"></a>Apache Rivet</h1></div><div><div class="author"><h3 class="author"><span class="firstname">The Rivet Team</span></h3><div class="affiliation"><span class="orgname">The Apache Software Foundation<br></span><div class="address"><p><br>
<tt class="email"><<a href="mailto:rivet-dev@tcl.apache.org">rivet-dev@tcl.apache.org</a>></tt><br>
</p></div></div></div></div><div><p class="othercredit"><span class="contrib">Italian Translation</span>: <span class="firstname">Fabio</span> <span class="surname">Zanotti</span></p><div class="affiliation"><span class="orgname">Italian Linux Documentation Project<br></span><div class="address"><p><tt class="email"><<a href="mailto:zendune@virgilio.it">zendune@virgilio.it</a>></tt></p></div></div></div><div><p class="copyright">Copyright 2002, 2003 Apache Software Foundation</p></div></div><hr></div><div class="toc"><p><b>Sommario</b></p><dl><dt><span class="section"><a href="#id4695642">Introduzione ad Apache Rivet</a></span></dt><dt><span class="section"><a href="#installation">Installazione di Apache Rivet</a></span></dt><dt><span class="section"><a href="#directives">Direttive di Apache</a></span></dt><dt><span class="section"><a href="#commands">Comandi e variabili Tcl di Rivet</a></span></dt><dt><span class="section"><a href="#examples">Esempi ed uso</a></span></dt><dt><span class="section"><a href="#tcl_packages">Pacchetti Tcl per Rivet</a></span></dt><dt><span class="section"><a href="#help">Risorse - Come ottenere aiuto</a></span></dt><dd><dl><dt><span class="section"><a href="#id4747014">Mailing Lists</a></span></dt><dt><span class="section"><a href="#id4747056">Newsgroup</a></span></dt><dt><span class="section"><a href="#websites">Siti Web</a></span></dt><dt><span class="section"><a href="#id4747153">Bug Tracking System</a></span></dt></dl></dd><dt><span class="section"><a href="#internals">Rivet Internals</a></span></dt><dd><dl><dt><span class="section"><a href="#id4747200">Inizializzazione</a></span></dt><dt><span class="section"><a href="#id4747241">RivetChan</a></span></dt><dt><span class="section"><a href="#id4747274">Parsing delle pagine, Esecuzione e Cacheing</a></span></dt></dl></dd><dt><span class="section"><a href="#upgrading">Aggiornamenti da mod_dtcl o NeoWebScript</a></span></dt><dd><dl><dt><span class="section"><a href="#id4747372">mod_dtcl</a></span></dt><dt><span class="section"><a href="#id4747644">NeoWebScript</a></span></dt></dl></dd></dl></div><p style="width:90%">
Questo documento anche disponibile nelle seguenti lingue: <a href="index.en.html" target="_top">Inglese</a>, <a href="index.ru.html" target="_top">Russo</a>
</p><p style="width:90%">Questo documento basato sulla versione 1.27 dell'originale
in inglese.</p><div class="section" lang="it"><div class="titlepage"><div><div><hr><h2 class="title" style="clear: both"><a name="id4695642"></a>Introduzione ad Apache Rivet</h2></div></div></div><p style="width:90%">
Apache Rivet un sistema per la creazione di contenuti web
dinamici mediante un linguaggio di programmazione integrato con
il Web Server Apache . progettato per essere veloce,
potente ed estensibile, utilizza poche risorse, facile da
imparare e fornisce all'utente una piattaforma che pu pure
essere utilizzata con altri programmi per lavori da eseguire
fuori dal web (GUI, compiti di amministrazione di sistema,
elaboratori di testo, gestori di database, XML e cos via).
Per ottenere questi risultati, stato scelto il linguaggio
di programmazione Tcl da utilizzare unitamente al
Web Server Apache.
</p><p style="width:90%">
Con questo manuale aspiriamo ad aiutarvi ad iniziare ed a
farvi scrivere codice di produzione il pi velocemente
possibile, dandovi un'idea di come ottenere grandi vantaggi
dall'architettura Rivet, finalizzati alla realizzazione di
diverse tipologie di siti web.
</p><p style="width:90%">
Questa documentazione un lavoro in corso e, come ogni cosa
riguardante Apache Rivet, Software Libero. Se vedete qualche
sezione che necessita di miglioramenti ed avete idee o
suggerimenti al riguardo, non esitate a farcelo sapere. Se
volete contribuire direttamente, meglio ancora!
</p></div><div class="section" lang="it"><div class="titlepage"><div><div><hr><h2 class="title" style="clear: both"><a name="installation"></a>Installazione di Apache Rivet</h2></div></div></div><div class="procedure"><ol type="1"><li><p class="title"><b>Verifica delle dipendenze</b></p><p style="width:90%">
Per installare Rivet, avete bisogno di Tcl 8.2 o superiore e
Apache 1.3.xx. Pu essere eseguito su Linux, FreeBSD,
OpenBSD, Solaris e HPUX. possibile utilizzarlo anche in
Windows NT (per cortesia verificate le indicazioni nella
distribuzione).
</p></li><li><p class="title"><b>Procurarsi Rivet</b></p><p style="width:90%">
Si possono scaricare i sorgenti di Rivet da
<a href="http://tcl.apache.org/rivet/download" target="_top">http://tcl.apache.org/rivet/download</a>.
Attualmente il solo modo per ottenere Rivet. In futuro,
contiamo di distribuirlo anche direttamente nei formati
utilizzati da FreeBSD, Debian, Red Hat e windows.
</p></li><li><p class="title"><b>Procurarsi ed installare i sorgenti Apache</b></p><p style="width:90%">
Rivet necessita di alcuni file include (.h) per essere
costruito. Il modo pi facile per ottenerli, scaricare il
codice sorgente dal server web di Apache, sebbene alcuni
sistemi (Debian GNU/Linux per esempio) rendano disponibili per
per l'installazione i file header ed altri file di
sviluppo. Se intendete costruire Rivet staticamente
(compilandolo nel server web Apache, invece di caricarlo
dinamicamente), chiaramente necessitate dei sorgenti.
Raccomandiamo di costruire Rivet con una libreria caricabile
condivisa, per avere la massima flessibilit.</p><p style="width:90%">
Il codice sorgente del server web Apache pu essere reperito
al seguente link: <a href="http://httpd.apache.org/" target="_top">http://httpd.apache.org/</a>.
</p></li><li><p class="title"><b>Decomprimere i sorgenti</b></p><p style="width:90%">
Assumiamo, a questo punto, che abbiate installato Apache.
Dovrete decomprimere i sorgenti di Rivet nella directory dove
vorrete compilarli.
</p><pre style="background:#bbffbb ; width:90ex ; margin: 2ex ; padding: 1ex; border: solid black 1px ; white-space: pre; font-family:monospace ; " class="programlisting">gunzip tcl-rivet-X.X.X.tar.gz
tar -xvf tcl-rivet-X.X.X.tar.gz</pre><p style="width:90%">
</p></li><li><p class="title"><b>Compilare Rivet</b></p><p style="width:90%">
Rivet usa un unico sistema di compilazione che abbiamo
creato espressamente per questo progetto. Utilizza le
informazioni incluse in Apache e Tcl, considerando le loro
configurazioni, al fine di compilarlo tramite una serie di
script Tcl, che sono ubicati nella directory
<tt class="filename">buildscripts/</tt>.
</p><ol type="a"><li><p class="title"><b>Modificare src/make.tcl</b></p><p style="width:90%">
Potrebbe essere necessario modificare a mano
<tt class="filename">src/make.tcl</tt>, al fine di impostare
alcune opzioni. Per prima cosa provate la prossima
istruzione e vedete se ha successo.
</p></li><li><p style="width:90%">A questo punto, siete pronti ad eseguire la compilazione
del sistema:</p><pre style="background:#bbffbb ; width:90ex ; margin: 2ex ; padding: 1ex; border: solid black 1px ; white-space: pre; font-family:monospace ; " class="programlisting">cd src/
./make.tcl <i class="replaceable"><tt>option</tt></i></pre><p style="width:90%">dove <i class="replaceable"><tt>option</tt></i> pu essere
shared (condivisa) o
static (statica).
</p></li><li><p class="title"><b>Installazione</b></p><p style="width:90%">
Adesso siamo pronti ad eseguire il comando
<span style="font-family:monospace"><span><b class="command">./make.tcl install</b></span></span> per installare i
file risultanti. Questo
dovrebbe copiare gli oggetti condivisi (come
<tt class="filename">mod_rivet.so</tt>, se stato creato con
successo) nella directory di Apache
<tt class="filename">libexec</tt>, come pure installare alcuni
script di supporto e codice vario.
</p></li></ol></li><li><p class="title"><b>File di configurazione di Apache</b></p><p style="width:90%">
Rivet relativamente facile da configurare, cominceremo
aggiungendogli il modulo:
</p><pre style="background:#bbffbb ; width:90ex ; margin: 2ex ; padding: 1ex; border: solid black 1px ; white-space: pre; font-family:monospace ; " class="programlisting">LoadModule rivet_module <i class="replaceable"><tt>/usr/lib/apache/1.3/
mod_rivet.so</tt></i></pre><p style="width:90%">
Questo informa Apache che deve caricare l'oggetto condiviso
Rivet, in qualsiasi parte esso risieda sul vostro file system.
Ora abbiamo informato Apache su quali file sono del tipo
"Rivet" e come elaborarli:
</p><pre style="background:#bbffbb ; width:90ex ; margin: 2ex ; padding: 1ex; border: solid black 1px ; white-space: pre; font-family:monospace ; " class="programlisting">AddType application/x-httpd-rivet .rvt
AddType application/x-rivet-tcl .tcl</pre><p style="width:90%">
Questo informa Apache di elaborare i file con le estensioni
<tt class="filename">.rvt</tt> e <tt class="filename">.tcl</tt>
come file Rivet.
</p><p style="width:90%">
Per altre direttive che Rivet fornisce per la configurazione di
Apache, per cortesia, vedete <a href="#directives" title="Direttive di Apache">la sezione chiamata “Direttive di Apache”</a>.
</p></li></ol></div></div><div class="section" lang="it"><div class="titlepage"><div><div><hr><h2 class="title" style="clear: both"><a name="directives"></a>Direttive di Apache</h2></div></div></div><p style="width:90%">
Queste direttive sono utilizzate con i file di configurazione del
server httpd di Apache per modificare il comportamento di Apache
Rivet. Vi sono delle precedenze, come segue:
<span style="font-family:monospace"><span><b class="command">RivetDirConf</b></span></span>, <span style="font-family:monospace"><span><b class="command">RivetUserConf</b></span></span>,
<span style="font-family:monospace"><span><b class="command">RivetServerConf</b></span></span>, questo significa che DirConf
non terr conto di UserConf, il quale a sua volta non terr
conto di ServerConf.
</p><div class="variablelist"><dl><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">RivetServerConf</span> (<span style="font-family:monospace; font-weight: bold;">CacheSize</span> | <span style="font-family:monospace; font-weight: bold;">GlobalInitScript</span> | <span style="font-family:monospace; font-weight: bold;">ChildInitScript</span> | <span style="font-family:monospace; font-weight: bold;">ChildExitScript</span> | <span style="font-family:monospace; font-weight: bold;">BeforeScript</span> | <span style="font-family:monospace; font-weight: bold;">AfterScript</span> | <span style="font-family:monospace; font-weight: bold;">ErrorScript</span> | <span style="font-family:monospace; font-weight: bold;">UploadDirectory</span> | <span style="font-family:monospace; font-weight: bold;">UploadMaxSize</span> | <span style="font-family:monospace; font-weight: bold;">UploadFilesToVar</span> | <span style="font-family:monospace; font-weight: bold;">SeperateVirtualInterps</span>)</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex"><span style="font-family:monospace"><span><b class="command">RivetServerConf</b></span></span> specifica un opzione
globale che valida per l'intero server.
</div><div class="variablelist"><dl><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">CacheSize</span>? ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>size</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Seleziona la dimensione della cache della pagina
interna, dove
<i class="replaceable"><tt>size</tt></i> il
numero di pagine byte-compilate da essere
memorizzate per un uso futuro. Il valore predefinito
<span style="font-family:monospace"><span><b class="command">MaxRequestsPerChild</b></span></span> / 5, o 50,
se <span style="font-family:monospace"><span><b class="command">MaxRequestsPerChild</b></span></span> 0.
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">GlobalInitScript</span>? ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>script</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Script Tcl che eseguito quando ogni interprete viene
inizializzato.
<i class="replaceable"><tt>script</tt></i>
uno script Tcl effettivo; cos per eseguire un file,
voi eseguireste:
<pre style="background:#bbffbb ; width:90ex ; margin: 2ex ; padding: 1ex; border: solid black 1px ; white-space: pre; font-family:monospace ; " class="programlisting">RivetServerConf GlobalInitScript "source /var/www/
foobar.tcl"</pre>
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">ChildInitScript</span>? ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>script</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Lo script viene valutato quando ogni processo figlio
di Apache inizializzato. Questo il posto
raccomandato per caricare i moduli, creare le
variabili globali, aprire le connessioni ad altre
applicazioni (quali database) e cos via.
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">ChildExitScript</span>? ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>script</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Lo script viene valutato quando ogni processo figlio
di Apache termina. Questo il posto pi naturale dove
ripulire le risorse create con
ChildInitScript.
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">BeforeScript</span>? ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>script</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Lo script viene valutato prima che ogni server abbia
fatto l'analisi della pagina (.rvt). Questo pu essere
utilizzato per creare un'intestazione standard, per
ogni istanza.
anche possibile utilizzarlo per caricare codice di
cui avete bisogno in ogni pagina, se non volete
metterlo in un GlobalInitScript
ChildInitScript quando siete al
vostro primo sviluppo di un sito web.
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Nota]" src="images/note.png"></td><th align="left">Nota</th></tr><tr><td colspan="2" align="left" valign="top">
Questo codice valutato globalmente e non
all'interno del namespace di dove le pagine sono
elaborate.
</td></tr></table></div>
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">AfterScript</span>? ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>script</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Lo script viene chiamato dopo che ogni server ha
analizzato la pagina (.rvt).
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">ErrorScript</span>? ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>script</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Quando Rivet incontra un errore in uno script,
costruisce una pagina HTML con alcune informazioni
circa l'errore e lo script che stato valutato. Se
stato specificato un ErrorScript,
possibile creare pagine personalizzate di errore.
Questo pu essere vantaggioso se cercate di
assicurarvi che nessun utente possa mai vedere il
vostro codice sorgente.
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">UploadDirectory</span>? ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>directory</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">Directory ove posizionare i file caricati.</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">UploadMaxSize</span>? ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>size</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">Dimensione massima per i file caricati.</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">UploadFilesToVar</span>? (<span style="font-family:monospace; font-weight: bold;">yes</span> | <span style="font-family:monospace; font-weight: bold;">no</span>)</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Questa opzione controlla se possibile caricare i file
in una variabile Tcl. Se avete un limite alla dimensione
e non potete usare file di grosse dimensioni, questa
soluzione potrebbe essere pi conveniente che inviare
dati ad un file su disco.
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">SeperateVirtualInterps</span>? (<span style="font-family:monospace; font-weight: bold;">yes</span> | <span style="font-family:monospace; font-weight: bold;">no</span>)</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Se attivo, Rivet creer un interprete Tcl separato per
ogni host virtuale di Apache. Questo utile in una
situazione tipo ISP dove desiderabile avere un
interprete dedicato per ciascun client, cosicch, anche
accidentalmente, non possano interferire tra loro.
</div></div></dd></dl></div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">RivetDirConf</span> (<span style="font-family:monospace; font-weight: bold;">BeforeScript</span> | <span style="font-family:monospace; font-weight: bold;">AfterScript</span> | <span style="font-family:monospace; font-weight: bold;">ErrorScript</span> | <span style="font-family:monospace; font-weight: bold;">UploadDirectory</span>)</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Queste opzioni sono le stesse di
<span style="font-family:monospace"><span><b class="command">RivetServerConf</b></span></span>, ad eccezione che sono
valide solo per la directory dove sono state specificate e
relative sotto directory. Potranno essere dichiarate
nelle sezioni <span style="font-family:monospace"><span><b class="command">Directory</b></span></span>.
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">RivetUserConf</span> (<span style="font-family:monospace; font-weight: bold;">BeforeScript</span> | <span style="font-family:monospace; font-weight: bold;">AfterScript</span> | <span style="font-family:monospace; font-weight: bold;">ErrorScript</span> | <span style="font-family:monospace; font-weight: bold;">UploadDirectory</span>)</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Queste opzioni sono le stesse di
<span style="font-family:monospace"><span><b class="command">RivetServerConf</b></span></span>, ad eccezione che sono
valide solo per la directory dove sono state specificate e
relative sotto directory.
</div></div></dd></dl></div></div><div class="section" lang="it"><div class="titlepage"><div><div><hr><h2 class="title" style="clear: both"><a name="commands"></a>Comandi e variabili Tcl di Rivet</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">var</span> (<span style="font-family:monospace; font-weight: bold;">get</span> | <span style="font-family:monospace; font-weight: bold;">list</span> | <span style="font-family:monospace; font-weight: bold;">exists</span> | <span style="font-family:monospace; font-weight: bold;">number</span> | <span style="font-family:monospace; font-weight: bold;">all</span>)</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Il comando <span style="font-family:monospace"><span><b class="command">var</b></span></span> 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
<span style="font-family:monospace"><span><b class="command">var</b></span></span>: <span style="font-family:monospace"><span><b class="command">var_qs</b></span></span> e
<span style="font-family:monospace"><span><b class="command">var_post</b></span></span>.
Queste due forme restringono le informazioni sui parametri
ottenendo rispettivamente la querystring
(?foo=bar&bee=bop) o la POSTing.
</div><div class="variablelist"><dl><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">get</span>? ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>varname</tt></i></span>? ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>?<span class="optional">default</span>?</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Ritorna il valore della variabile
<i class="replaceable"><tt>varname</tt></i>
come una stringa (anche se vi sono valori multipli). Se
non esiste come variabile GET o POST, viene restituito
il valore
<i class="replaceable"><tt>?<span class="optional">default</span>?</tt></i>,
altrimenti viene ritornato "" (una stringa vuota).
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">list</span>? ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>varname</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Restituisce il valore della variabile
<i class="replaceable"><tt>varname</tt></i> come
una lista, se vi sono valori multipli.
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">exists</span>? ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>varname</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Restituisce 1 se
<i class="replaceable"><tt>varname</tt></i>
esiste, 0 se non lo .
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">number</span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Restituisce il numero di variabili.
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">all</span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Restituisce una lista di nomi di variabili e valori.
</div></div></dd></dl></div><div style="margin-bottom:1.5ex ; padding .5ex">
Vedete <a href="#variable_access" title="Esempio3.Accesso alle variabili">Esempio3, “Accesso alle variabili”</a>.
</div></div></dd></dl></div><div class="variablelist"><dl><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">upload</span> (<span style="font-family:monospace; font-weight: bold;">channel</span> | <span style="font-family:monospace; font-weight: bold;">save</span> | <span style="font-family:monospace; font-weight: bold;">data</span> | <span style="font-family:monospace; font-weight: bold;">exists</span> | <span style="font-family:monospace; font-weight: bold;">size</span> | <span style="font-family:monospace; font-weight: bold;">type</span> | <span style="font-family:monospace; font-weight: bold;">filename</span>)</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">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. </div><div class="variablelist"><dl><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">channel</span>? ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>uploadname</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Quando date il nome ad un file caricato,
<i class="replaceable"><tt>uploadname</tt></i>
restituisce un canale Tcl che pu essere usato per
accedere allo stesso file.
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">save</span>? ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>uploadname</tt></i></span>? ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>filename</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Salva
<i class="replaceable"><tt>uploadname</tt></i> nel
file
<i class="replaceable"><tt>filename</tt></i>.
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">data</span>? ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>uploadname</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
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.
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">size</span>? ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>uploadname</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Restituisce la dimensione del file caricato.
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">type</span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Se il <tt class="varname">Content-type</tt> impostato, viene
restituito il valore, altrimenti una stringa vuota.
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">filename</span>? ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>uploadname</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Viene restituito il nome del file dell'host remoto
che ha caricato il file.
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">names</span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Restituisce i nomi delle variabili, in una lista, di
tutti i file caricati.
</div></div></dd></dl></div><div style="margin-bottom:1.5ex ; padding .5ex">
See <a href="#upload" title="Esempio4.Caricare file">Esempio4, “Caricare file”</a>.
</div></div></dd></dl></div><div class="variablelist"><dl><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">load_env</span> ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>array_name</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Carica l'array delle variabili d'ambiente all'interno dello
specificato nome di array. Utilizza l'array
::request::env come valore predefinito.
</div><div style="margin-bottom:1.5ex ; padding .5ex">
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.
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">load_headers</span> ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>array_name</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
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.
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">load_cookies</span> ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>array_name</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Carica l'array delle variabili cookie all'interno del nome
dell'array indicato. Utilizza l'array
cookies come valore predefinito.
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">include</span> ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>filename_name</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Include un file senza analizzarlo per processare i tag <?
e ?>. Questo il metodo migliore per includere un file
HTML o qualsiasi altro contenuto statico.
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">parse</span> ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>filename</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Come il comando Tcl <span style="font-family:monospace"><span><b class="command">source</b></span></span>, ma analizza
pure i tag di elaborazione per Rivet <? e ?>.
Utilizzando questo comando, potete utilizzare diversi file
.rvt.
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">headers</span> (<span style="font-family:monospace; font-weight: bold;">set</span> | <span style="font-family:monospace; font-weight: bold;">redirect</span> | <span style="font-family:monospace; font-weight: bold;">add</span> | <span style="font-family:monospace; font-weight: bold;">type</span> | <span style="font-family:monospace; font-weight: bold;">numeric</span>)</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Il comando <span style="font-family:monospace"><span><b class="command">headers</b></span></span> per l'assegnazione e
l'elaborazione di header HTTP.
</div><div style="margin-bottom:1.5ex ; padding .5ex">
<div class="variablelist"><dl><dt><span class="term"><div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">set</span>? ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>headername</tt></i></span>? ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>value</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Assegna in modo discrezionale i valori ed i nomi
agli header.
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">redirect</span>? ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>uri</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Redirige dalla pagina corrente ad un nuovo URI.
<span class="emphasis"><em>Questo</em></span> viene fatto nel primo
blocco di codice Tcl.
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">add</span>? ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>headername</tt></i></span>? ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>value</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">Aggiunge testo all'header
<tt class="varname">headername</tt>.</div></div></dd><dt><span class="term"><div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">type</span>? ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>content-type</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Questo comando assegna l'header
<tt class="constant">Content-type</tt> ritornato dallo
script, utile se desiderate inviare, con Rivet,
altri contenuti oltre all'HTML (PNG o immagini
jpeg, per esempio).
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex ">?<span style="font-family:monospace; font-weight: bold;">numeric</span>? ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>response code</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">Assegna un codice di risposta numerico, come per
esempio 200, 404 o 500.
</div></div></dd></dl></div>
</div></div></dd><dt><span class="term">
<div class="cmdsynopsis" style="width:80%"><div style="background:#bbbbff ; margin:1ex ; padding:.4ex ; word-spacing:1ex "><span style="font-weight:bold ; font-family:monospace">makeurl</span> ?<span style="font-family:monospace; font-weight: bold;"><i class="replaceable"><tt>filename</tt></i></span>?</div></div>
</span></dt><dd><div style="padding:4 ; margin-top:3 ; margin-bottom:3 ; width:75%"><div style="margin-bottom:1.5ex ; padding .5ex">
Crea una URL di riferimento a se stesso dal nome di un file.
Per esempio:
<pre style="background:#bbffbb ; width:90ex ; margin: 2ex ; padding: 1ex; border: solid black 1px ; white-space: pre; font-family:monospace ; " class="programlisting">makeurl /tclp.gif</pre>
restituisce
<tt class="constant">http://[hostname]:[port]/tclp.gif</tt>.
Dove hostname e port sono il nome dell'host e la porta del
server in questione.
</div></div></dd></dl></div></div><div class="section" lang="it"><div class="titlepage"><div><div><hr><h2 class="title" style="clear: both"><a name="examples"></a>Esempi ed uso</h2></div></div></div><p style="width:90%">
Seguono alcuni esempi sull'uso di Rivet. Si presuppone che
conosciate, anche parzialmente, il linguaggio di programmazione
Tcl. Se non conoscete molto Tcl, non c' da preoccuparsi:
semplice e vi sono alcune buone risorse disponibili
sul web che vi permetteranno di padroneggiarlo velocemente.
A questo proposito, vedete la sezione
<a href="#websites" title="Siti Web">web sites</a>.
</p><div class="example"><a name="hello world"></a><p class="title"><b>Esempio1.Hello World</b></p><p style="width:90%">
Come qualsiasi altro tool, piacevole vedere qualcosa al
lavoro, cos andremo a creare una piccola pagina
"Hello World".</p><p style="width:90%">
Assumendo che sia stato configurato correttamente Apache,
create un file chiamato <tt class="filename">hello.rvt</tt> in una
directory dove Apache lo possa trovare, con il seguente
contenuto:
</p><pre style="background:#bbffbb ; width:90ex ; margin: 2ex ; padding: 1ex; border: solid black 1px ; white-space: pre; font-family:monospace ; " class="programlisting"><?
puts "Hello World"
?>
</pre><p style="width:90%">
Se poi vi accederete con vostro browser, sar possibile vedere
una pagina nera con il testo "Hello World" (senza apici).
</p></div><div class="example"><a name="table"></a><p class="title"><b>Esempio2.Generare una tabella</b></p><p style="width:90%">
In un'altro semplice esempio, genereremo dinamicamente una
tabella:
</p><pre style="background:#bbffbb ; width:90ex ; margin: 2ex ; padding: 1ex; border: solid black 1px ; white-space: pre; font-family:monospace ; " class="programlisting"><? puts "<table>\n"
for {set i 1} { $i <= 8 } {incr i} {
puts "<tr>\n"
for {set j 1} {$j <= 8} {incr j} {
set num [ expr $i * $j * 4 - 1]
puts [ format "<td bgcolor=\"%02x%02x%02x\" > $num $num $num </td>\n" \
$num $num $num ]
}
puts "</tr>\n"
}
puts "</table>\n" ?>
</pre><p style="width:90%">
Se leggete il codice, possibile vedere che puro Tcl.
possibile mantenere lo stesso codice, eseguirlo fuori da Rivet
e generare la stessa pagina HTML!
</p><p style="width:90%">
Il risultato sar qualcosa di simile a questo:
</p><div><img src="table.png"></div></div><div class="example"><a name="variable_access"></a><p class="title"><b>Esempio3.Accesso alle variabili</b></p><p style="width:90%">
In questa sezione mostreremo come accedere alle variabili
utilizzando gli operatori GET o POST.
</p><p style="width:90%">
Data una form HTML come la seguente:
</p><pre style="background:#bbffbb ; width:90ex ; margin: 2ex ; padding: 1ex; border: solid black 1px ; white-space: pre; font-family:monospace ; " class="programlisting"> <form action="vars.rvt">
<table>
<tbody>
<tr>
<td><b>Title:</b></td>
<td><input name="title"></td>
</tr>
<tr>
<td><b>Salary:</b></td>
<td><input name="salary"></td>
</tr>
<tr>
<td><b>Boss:</b></td>
<td><input name="boss"></td></tr>
<tr>
<td><b>Skills:</b></td>
<td>
<select name="skills" multiple="multiple">
<option>c</option>
<option>java</option>
<option>Tcl</option>
<option>Perl</option>
</select>
</td>
</tr>
<tr>
<td><input type="submit"></td>
</tr>
</tbody>
</table>
</form>
</pre><p style="width:90%">
Potete utilizzare questo script di Rivet per ottenere i valori
delle variabili:
</p><pre style="background:#bbffbb ; width:90ex ; margin: 2ex ; padding: 1ex; border: solid black 1px ; white-space: pre; font-family:monospace ; " class="programlisting"><?
set errlist {}
if { [var exists title] } {
set title [var get title]
} else {
set errlist "You need to enter a title"
}
if { [var exists salary] } {
set salary [var get salary]
if { ! [string is digit $salary] } {
lappend errlist "Salary must be a number"
}
} else {
lappend errlist "You need to enter a salary"
}
if { [var exists boss] } {
set boss [var get boss]
} else {
set boss "Mr. Burns"
}
if { [var exists skills] } {
set skills [var list skills]
} else {
lappend errlist "You need to enter some skills"
}
if { [llength $errlist] != 0 } {
foreach err $errlist {
puts "<b> $err </b>"
}
} else {
puts "Thanks for the information!"
?>
<table>
<tbody>
<tr>
<td><b>Title:</b></td>
<td><? puts $title ?></td>
</tr>
<tr>
<td><b>Boss:</b></td>
<td><? puts $boss ?></td>
</tr>
<tr>
<td><b>Salary:</b></td>
<td><? puts $salary ?></td>
</tr>
<tr>
<td><b>Skills:</b></td>
<td><? puts $skills ?></td>
</tr>
</tbody>
</table>
<?
}
?>
</pre><p style="width:90%">
La prima istruzione si assicura che la variabile
<tt class="varname">boss</tt> sia passata allo script e poi fa
qualcosa con quella informazione.
Se non presente, un errore viene aggiunto alla lista degli
errori.
</p><p style="width:90%">
Nel secondo blocco del codice, la variabile
<tt class="varname">salary</tt> riportata con un'altro errore di
controllo, poich un numero, necessario che sia composto
da cifre.
</p><p style="width:90%">
Alla variabile <tt class="varname">boss</tt> non richiesto di essere
inviata, la setteremo a "Mr. Burns" se non tra le informazioni
ricevute.
</p><p style="width:90%">
L'ultimo pezzo del codice di gestione delle variabili un pezzo
ingannatore perch <tt class="varname">skills</tt> una listbox e pu
avere, potenzialmente, valori multipli. Opteremo di riceverla
come una lista, in modo da poterla riutilizzare.
</p><p style="width:90%">
Lo script si assicura che la variabile
<tt class="varname">errlist</tt> sia vuota e restituisce un messaggio
di ringraziamento. Se <tt class="varname">errlist</tt> non vuota,
viene stampata la lista degli errori riscontrati.
</p></div><div class="example"><a name="upload"></a><p class="title"><b>Esempio4.Caricare file</b></p><p style="width:90%">
Il seguente HTML in un file, detto,
<tt class="filename">upload.html</tt>
</p><pre style="background:#bbffbb ; width:90ex ; margin: 2ex ; padding: 1ex; border: solid black 1px ; white-space: pre; font-family:monospace ; " class="programlisting"><form action="foo.rvt" enctype="multipart/form-data" method="post">
<input type="file" name="MyUpload"></input>
<input type="submit" value="Send File"></input>
</form>
</pre><p style="width:90%">
Pu essere usato con il seguente codice Tcl in un secondo file
(<tt class="filename">upload.rvt</tt> per esempio) per creare una
form che carica un file.
</p><pre style="background:#bbffbb ; width:90ex ; margin: 2ex ; padding: 1ex; border: solid black 1px ; white-space: pre; font-family:monospace ; " class="programlisting"><?
upload save MyUpload /tmp/uploadfiles/file1
puts "Saved file [upload filename MyUpload] \
([upload size MyUpload] bytes) to server"
?></pre></div></div><div class="section" lang="it"><div class="titlepage"><div><div><hr><h2 class="title" style="clear: both"><a name="tcl_packages"></a>Pacchetti Tcl per Rivet</h2></div></div></div><p style="width:90%">
In aggiunta al nucleo del modulo Apache, Rivet fornisce un
numero di pacchetti Tcl che includono codice potenzialmente
utile.
</p><div class="itemizedlist"><ul type="disc"><li><div style="margin-bottom:1.5ex ; padding .5ex">commserver un package providing a .</div></li><li><div style="margin-bottom:1.5ex ; padding .5ex">dio un database abstraction layer.</div></li><li><div style="margin-bottom:1.5ex ; padding .5ex">dtcl un pacchetto di compatibilit per applicazioni
mod_dtcl.
</div></li><li><div style="margin-bottom:1.5ex ; padding .5ex">form - per creare form.</div></li><li><div style="margin-bottom:1.5ex ; padding .5ex">rivet - alcune aggiunte, routine utili.</div></li><li><div style="margin-bottom:1.5ex ; padding .5ex">tclrivet</div></li></ul></div></div><div class="section" lang="it"><div class="titlepage"><div><div><hr><h2 class="title" style="clear: both"><a name="help"></a>Risorse - Come ottenere aiuto</h2></div></div></div><div class="toc"><dl><dt><span class="section"><a href="#id4747014">Mailing Lists</a></span></dt><dt><span class="section"><a href="#id4747056">Newsgroup</a></span></dt><dt><span class="section"><a href="#websites">Siti Web</a></span></dt><dt><span class="section"><a href="#id4747153">Bug Tracking System</a></span></dt></dl></div><div class="section" lang="it"><div class="titlepage"><div><div><h3 class="title"><a name="id4747014"></a>Mailing Lists</h3></div></div></div><p style="width:90%">
Se non avete trovato la soluzione al problema nella
documentazione, la mailing list di Rivet il primo posto da
visitare per ottenere aiuto; spedite un'email a
<tt class="email"><<a href="mailto:rivet-user@tcl.apache.org">rivet-user@tcl.apache.org</a>></tt>. Se avete una domanda,
un'idea, o un commento circa il codice di Rivet, per cortesia
mandate un'email a <tt class="email"><<a href="mailto:rivet-dev@tcl.apache.org">rivet-dev@tcl.apache.org</a>></tt>. Per
iscriversi ad entrambe le liste, mandate un'email a
<tt class="email"><<a href="mailto:rivet-list-subscribe@tcl.apache.org">rivet-<i class="replaceable"><tt>list</tt></i>-subscribe@tcl.apache.org</a>></tt>.
</p><p style="width:90%">
Gli archivi delle mailing list sono disponibili a questo
indirizzo:
<a href="http://nagoya.apache.org/eyebrowse/SummarizeList?listId=118" target="_top">http://nagoya.apache.org/eyebrowse/SummarizeList?listId=118</a>
</p></div><div class="section" lang="it"><div class="titlepage"><div><div><h3 class="title"><a name="id4747056"></a>Newsgroup</h3></div></div></div><p style="width:90%">
Il newsgroup <a href="news:comp.lang.tcl" target="_top">news:comp.lang.tcl</a> un buon posto
per porre domande circa Tcl in generale. Gli sviluppatori di
Rivet seguono anche il newsgroup, ma meglio porre domande
specifiche su Rivet presso la sua mailing list.
</p></div><div class="section" lang="it"><div class="titlepage"><div><div><h3 class="title"><a name="websites"></a>Siti Web</h3></div></div></div><p style="width:90%">
Ci sono diversi siti web che estensivamente trattano di Apache e
Tcl.
</p><div class="itemizedlist"><ul type="disc"><li><div style="margin-bottom:1.5ex ; padding .5ex">
<a href="http://tcl.apache.org" target="_top">http://tcl.apache.org</a> la casa del progetto
Apache Tcl. Andateci per ottenere l'ultima versione del
nostro software (se non state leggendo queste pagine fuori
dal sito!).
</div></li><li><div style="margin-bottom:1.5ex ; padding .5ex">
<a href="http://httpd.apache.org/docs/" target="_top">http://httpd.apache.org/docs/</a> il primo
posto da visitare per domande inerenti il web server Apache.
</div></li><li><div style="margin-bottom:1.5ex ; padding .5ex">
<a href="http://www.tcl.tk" target="_top">http://www.tcl.tk</a> il sito canonico per
informazioni su Tcl.
</div></li><li><div style="margin-bottom:1.5ex ; padding .5ex">
<a href="http://wiki.tcl.tk" target="_top">http://wiki.tcl.tk</a> il Tcl'er Wiki, un
posto dove poter ricercare domande e risposte di aiuto.
</div></li></ul></div></div><div class="section" lang="it"><div class="titlepage"><div><div><h3 class="title"><a name="id4747153"></a>Bug Tracking System</h3></div></div></div><p style="width:90%">
Apache Rivet usa il sistema Apache Bug Tracking presso <a href="http://nagoya.apache.org/bugzilla/" target="_top">http://nagoya.apache.org/bugzilla/</a>. Qui
possibile segnalare problemi o verificare se sono gi
conosciuti e quindi rintracciare pubblicazioni che lo
descrivono.
</p></div></div><div class="section" lang="it"><div class="titlepage"><div><div><hr><h2 class="title" style="clear: both"><a name="internals"></a>Rivet Internals</h2></div></div></div><div class="toc"><dl><dt><span class="section"><a href="#id4747200">Inizializzazione</a></span></dt><dt><span class="section"><a href="#id4747241">RivetChan</a></span></dt><dt><span class="section"><a href="#id4747274">Parsing delle pagine, Esecuzione e Cacheing</a></span></dt></dl></div><p style="width:90%">
Questa sezione facilmente pare sorpassata, come nuovo codice
viene aggiunto, vecchio codice viene rimosso e di conseguenza
vengono apportati i relativi cambiamenti. Il miglior posto
dove poter verificare se sono state inserite nuove funzionalit
il suo codice sorgente. Se siete interessati ai cambiamenti
osservate il FIXME.
</p><div class="section" lang="it"><div class="titlepage"><div><div><h3 class="title"><a name="id4747200"></a>Inizializzazione</h3></div></div></div><p style="width:90%">
Quando Apache attivo, (o quando i processi figli di Apache
sono attivi se un processo Tcl in uso),
<tt class="function">Rivet_InitTclStuff</tt> viene chiamata,
creando un nuovo interprete, o un interprete per host virtuale,
dipendentemente dalla configurazione. Inoltre inizializza varie
cose, come il canale di sistema
<span class="structname">RivetChan</span>, crea i comandi Tcl specifici
di Rivet ed esegue <tt class="filename">init.tcl</tt>.
Il sistema di caching anch'esso impostato e se c' un
<span style="font-family:monospace"><span><b class="command">GlobalInitScript</b></span></span>, viene eseguito.
</p></div><div class="section" lang="it"><div class="titlepage"><div><div><h3 class="title"><a name="id4747241"></a>RivetChan</h3></div></div></div><p style="width:90%">
Il sistema <span class="structname">RivetChan</span> fu creato al fine
di avere un canale Tcl reale che potesse redirigere lo standard
output. Questo permette di usare, per esempio, il comando
normale <span style="font-family:monospace"><span><b class="command">puts</b></span></span> nelle pagine .rvt. Lavora
creando un canale che bufferizza l'output e, a tempi
predeterminati, lo passa al sistema IO di Apache. Il normale
standard output di Tcl rimpiazzato con un'istanza di questo
tipo di canale, in modo che, predefinitamente, l'output venga
inviato alla pagina web.
</p></div><div class="section" lang="it"><div class="titlepage"><div><div><h3 class="title"><a name="id4747274"></a>Parsing delle pagine, Esecuzione e Cacheing</h3></div></div></div><p style="width:90%">
Quando una pagina Rivet viene richiesta, trasformata in un
normale script Tcl tramite l'analisi nel file delle etichette di
elaborazione delle istruzioni <? ?>. Ogni cosa fuori da
queste etichette diviene un'istruzione estesa
<span style="font-family:monospace"><span><b class="command">puts</b></span></span> ed ogni cosa dentro rimane codice Tcl.
</p><p style="width:90%">
Ogni file .rvt valutato nel proprio
<tt class="constant">::request</tt> namespace, in modo che non sia
necessario creare e distruggere gli interpreti dopo ogni
pagina. Tuttavia, operando nel proprio namespace, ogni pagina
non verr eseguita sporcando le variabili locali create da altri
scripts, perch verranno cancellate automaticamente quando il
namespace termina, dopo che Apache ha finito di gestire le
richieste.
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Nota]" src="images/note.png"></td><th align="left">Nota</th></tr><tr><td colspan="2" align="left" valign="top">Un problema corrente con questo sistema che, mentre le
variabili usano la garbage collection, e quindi vengono distrutte
automaticamente quando non sono pi usate, i gestori dei file non
lo sono: molto importante quindi che gli autori di script Rivet
si assicurino di chiudere tutti i file che hanno aperto.
</td></tr></table></div><p style="width:90%">
</p><p style="width:90%">
Dopo che uno script stato caricato ed analizzato dentro
una form di "puro Tcl", viene pure immagazzinato, affinch possa
essere utilizzato in futuro senza ricaricarlo (e rianalizzarlo)
da disco. Il numero degli script immagazzinati in memoria
configurabile. Questa caratteristica pu significativamente
migliorare l'esecuzione.
</p></div></div><div class="section" lang="it"><div class="titlepage"><div><div><hr><h2 class="title" style="clear: both"><a name="upgrading"></a>Aggiornamenti da mod_dtcl o NeoWebScript</h2></div></div></div><div class="toc"><dl><dt><span class="section"><a href="#id4747372">mod_dtcl</a></span></dt><dt><span class="section"><a href="#id4747644">NeoWebScript</a></span></dt></dl></div><p style="width:90%">
Rivet ha rotto con il passato, in quanto noi, gli autori, ci
siamo dedicati ad acquisire ci che preferivamo dalle nostre
passate fatiche e tolto o cambiato ci che non abbiamo pi
curato. La compatibilit all'indietro non fu un obiettivo
primario quando creammo Rivet, ma abbiamo fornito questa
informazione che potrebbere essere utilizzata da chi desideri
effettuare l'aggiornamento da installazioni mod_dtcl o NWS.
</p><div class="section" lang="it"><div class="titlepage"><div><div><h3 class="title"><a name="id4747372"></a>mod_dtcl</h3></div></div></div><p style="width:90%">
Rivet era originalmente basato su codice dtcl, ma ne stata
cambiata (migliorata !) una parte. I concetti rimangono gli
stessi, ma alcuni dei comandi sono cambiati.
</p></div><div class="section" lang="it"><div class="titlepage"><div><div><h3 class="title"><a name="id4747644"></a>NeoWebScript</h3></div></div></div><p style="width:90%">TODO</p></div></div></div></body></html>
|
