cgi

简介

对 CGI 请求进行答复。

vb cgi PATH

说明

PATH 参数是指定的受控制文件的名称,该文件为 VisionByte 提供重要信息,例如其仓库的位置。在典型的 CGI 部署中,PATH 是 CGI 脚本的名称,通常如下所示:

/usr/bin/vb

仓库:/home/somebody/project.db

如果 GATEWAY_INTERFACE 环境变量已经设置 CGI,则可以省略命令名称 cgi ,包括由 Web 服务器运行的 CGI 脚本。VisionByte 默认忽略以 # 开头的任何行。

选项

repository: PATH

仓库的名称

directory:

PATH 包含许多 VisionByte 仓库的目录名称,这些仓库的名称均以 .vbyte 结尾。应该只有一个 repository:directory:

notfound: URL

处于 directory: 模式时,如果未找到合适的仓库,则重定向到指定 URL 路径。

repolist

处于 directory: 模式时,如果 URL 为 / ,则显示一个可用仓库列表的页面。

localauth

授予来自 127.0.0.1::1 的连接管理员权限。

nossl

表示没有可用的 SSL 连接。

nocompress

不要压缩 HTTP 回复。

skin: LABEL

设置内置皮肤,而不是默认皮肤。如果没有名为 LABEL 的皮肤,则此选项无用。

files: GLOBLIST

使指定文件逐字返回。此功能允许 VisionByte 充当返回静态内容的 Web 服务器。

setenv: NAME VALUE

设置指定环境变量。如果省略 VALUE,则取消该设置。

HOME: PATH

setenv: HOME PATH 的简写

cgi-debug: FILE

将调试信息写入文件。

errorlog: FILE

将警告、错误写入文件。

timeout: SECONDS

设置运行时间。默认超时时间为 VBYTE_DEFAULT_TIMEOUT (600) 秒。

extroot: DIR

设置 /ext 页面上的子 CGI 树的根目录。

redirect: REPO URL

提取指定查询参数并在指定仓库中搜索与该值匹配的签到或票证,然后重定向到 URL。可以有多个 redirect: 行,按顺序处理。如果 REPO 为 * ,则无条件重定向到 URL。

jsmode: VALUE

指定 JavaScript 文件的交付模式。请参阅 http 命令的 --jsmode 标志的帮助文本。

mainmenu: FILE

使用给定文件的内容覆盖主菜单配置设置。

备注

大多数 CGI 文件仅包含 repository: 行。很少使用其他选项。这些行按照读取的顺序进行处理,这对于 errorlog: 来说最为重要,它应该在 repository: 之前设置,以便打开仓库时来自数据库的任何警告都会转到该日志文件。

参见

http, server