apache2 -v | head -1

Server version: Apache/2.4.52 (Ubuntu)

grep -rnE '"Rivet[A-Za-z]+"' /usr/local/apache2/lib/rivet3.3.1/ 2>/dev/null | head -2
strings /usr/lib/apache2/modules/mod_rivet.so | grep -E '^Rivet[A-Z]' | sort -u

RivetDirConf
RivetServerConf
RivetUserConf

apachectl -M | grep rivet

 rivet_module (shared)

mkdir -p /var/www/html
cat > /var/www/html/hello.rvt <<'EOF'
<? set title "Hello Rivet" ?><h1><?= $title ?></h1>
EOF
curl -s -o /dev/null -w '%{http_code}\n' http://localhost/hello.rvt

200

cat > /etc/apache2/conf-available/rivet-user-test.conf <<'EOF'
RivetUserConf site_name "Rivet Demo Site"
EOF
a2enconf rivet-user-test
apachectl -k restart

AH00526: Syntax error on line 1 of /etc/apache2/conf-enabled/rivet-user-test.conf:
Rivet configuration error: 'site_name' not valid for RivetUserConf
Action '-k restart' failed.

a2disconf rivet-user-test && apachectl -k restart
curl -s -o /dev/null -w '%{http_code}\n' http://localhost/hello.rvt

200

RivetServerConf ChildInitScript "package require Itcl; package require DIO; package require Session; ::DIO::handle Sqlite DIO -db /var/lib/rivet/sessions.db; Session SESSION -dioObject DIO -entropyFile /dev/urandom -entropyLength 10 -debugMode 0"

（重启后每个 apache2 子进程持有 SESSION 对象，请求页可见 session id 输出）

RivetServerConf BeforeScript "puts -nonewline <!--B>"
RivetUserConf BeforeScript "puts -nonewline <!--B>"
<Directory "/var/www/html">
    RivetDirConf AfterEveryScript "puts -nonewline <!--D>"
</Directory>

curl -s http://localhost/abort.rvt

<!--B><!--D>

RivetServerConf ErrorScript "source /var/www/html/errhandler.tcl"

cat > /var/www/html/errhandler.tcl <<'EOF'
puts -nonewline "<h1>站点自定义错误页</h1>"
puts -nonewline "<p>错误信息：</p><pre>$::errorInfo</pre>"
EOF
cat > /var/www/html/divzero.rvt <<'EOF'
<? set x [expr {1/0}] ?>
never reached
EOF
apachectl -k restart
curl -s http://localhost/divzero.rvt

<h1>站点自定义错误页</h1><p>错误信息：</p><pre>divide by zero
    invoked from within
"expr {1/0}"
    ("::try" body line 5)
    (in namespace eval "::request" script line 4)
    invoked from within
"namespace eval ::request $script"
    ("::try" body line 15)
</pre>

RivetServerConf UploadDirectory /var/lib/rivet/uploads
RivetServerConf UploadMaxSize 2000000

cat /var/lib/rivet/uploads/ufile.txt

hello rivet upload test

RivetServerConf CacheSize 200

curl -s http://localhost/inspect.rvt | grep CacheSize

CacheSize = 200

ExportRivetNS 1 ImportRivetNS 0

RivetServerConf ImportRivetNS true

curl -s -I http://localhost/hello.rvt | head -4

HTTP/1.1 200 OK
Date: Thu, 16 Oct 2026 04:15:22 GMT
Server: Apache/2.4.52 (Ubuntu)
Last-Modified: ...

cat > /var/www/html/inspect.rvt <<'EOF'
<? set d [::rivet::inspect] ?>
<? foreach k [lsort [dict keys $d]] { puts "$k = [dict get $d $k]<br>" } ?>
EOF
curl -s http://localhost/inspect.rvt

dir = AfterEveryScript {puts -nonewline <!--D>} BeforeScript {SESSION activate}<br>
server = ErrorScript {source /var/www/html/errhandler.tcl} CacheSize 200 UploadDirectory /var/lib/rivet/uploads UploadMaxSize 2000000 HonorHeadRequests on ChildInitScript {package require Itcl; package require DIO; package require Session; ::DIO::handle Sqlite DIO -db /var/lib/rivet/sessions.db; Session SESSION -dioObject DIO -entropyFile /dev/urandom -entropyLength 10 -debugMode 0}<br>
user = BeforeScript {puts -nonewline <!--B>}<br>

<VirtualHost *:80>
    ServerName site1.example.com
    DocumentRoot /var/www/site1

    <Directory /var/www/site1>
        AddType application/x-httpd-rivet .rvt
        AddType application/x-rivet-tcl .tcl
        RivetDirConf BeforeScript "puts -nonewline <!--site1-->"
    </Directory>

    RivetServerConf ImportRivetNS true
    RivetServerConf UploadDirectory /var/lib/rivet/uploads-site1
    RivetServerConf CacheSize 100
</VirtualHost>

echo '<? puts "<p>site1 ok</p>" ?>' > /var/www/site1/index.rvt
apachectl -k restart
curl -s -H 'Host: site1.example.com' http://localhost/index.rvt

<!--site1--><p>site1 ok</p>

<pre>no such variable
    (read trace on "env(SERVER_NAME)")
    invoked from within
"puts -nonewline  $env(SERVER_NAME) "
    (in namespace eval "::request" script line 4)
    invoked from within
"namespace eval ::request $script"
    ("::try" body line 15)<hr/><p>OUTPUT BUFFER:</p>puts -nonewline "<html><body>
..."
</pre>

<? ::rivet::apache_log_error err "board app: user submitted" ?>

tail -1 /var/log/apache2/error.log

[Fri Oct 16 04:38:28.197035 2026] [:error] [pid 12334:tid 127052681983552] board app: user submitted

<IfModule rivet_module>
    AddType application/x-httpd-rivet .rvt
    AddType application/x-rivet-tcl .tcl

    # —— 生命周期（集成指南第六章实测） ——
    RivetServerConf ChildInitScript "package require Itcl; package require DIO; package require Session; ::DIO::handle Sqlite DIO -db /var/lib/rivet/sessions.db; Session SESSION -dioObject DIO -entropyFile /dev/urandom -entropyLength 10 -debugMode 0"
    RivetServerConf ChildExitScript ""

    # —— 错误页（本文 4.3 实测：值是 Tcl 代码，双引号，引用 .tcl 纯脚本） ——
    RivetServerConf ErrorScript "source /var/www/html/errhandler.tcl"

    # —— 上传（本文 5.1 实测） ——
    RivetServerConf UploadDirectory /var/lib/rivet/uploads
    RivetServerConf UploadMaxSize 2000000

    # —— 缓存与隔离（本文 5.2/5.3 实测） ——
    RivetServerConf CacheSize 200
    RivetServerConf SeparateVirtualInterps 1
    RivetServerConf SeparateChannels 1

    # —— 兼容与调试（本文 5.4/5.5 实测默认值） ——
    RivetServerConf ImportRivetNS false
    RivetServerConf HonorHeadRequests on
</IfModule>