Apache 2.0手册中文版翻译项目 [本文译者: suncjs * ]

项目说明 | 项目进度 | 项目讨论区 | Apache手册中文版

 


mod_cgi - Apache HTTP服务器
<-
Apache主站 > HTTP服务器 > 文档 > 2.0版本 > 模块索引

Apache模块 mod_cgi

说明:CGI脚本的执行
状态:Base
模块名:cgi_module
源文件:mod_cgi.c

概要

任何具有mime类型application/x-httpd-cgi或者被 cgi-script处理器(Apache 1.1或以后版本)处理的文件将被作为CGI脚本对待并由服务器运行, 它的输出将被返回给客户端。通过两种途径使文件成为CGI脚本,或者文件具有已由 AddType指令定义的扩展名,或者文件位于 ScriptAlias目录中。

当服务器调用一个CGI脚本时会往运行环境中添加一个叫做 DOCUMENT_ROOT的变量。这个变量将包含 DocumentRoot配置指令的值。

要得到对Apache中使用CGI脚本的介绍,参看关于Dynamic Content With CGI的指南。

在UNIX下使用多道处理模块时,应该使用模块mod_cgid代替本模块。 在用户层面,这两个模块本质上是相同的。

指令索引

主题

参见

top

CGI环境变量

服务器将按照CGI规范所描述的设置环境变量, 有以下几个:

PATH_INFO
如果显式设置了AcceptPathInfo指令为off, 这个变量将不可用。如果AcceptPathInfo没有给出,缺省的行为是mod_cgi将会接受路径信息( 跟随在URI里的脚本文件名之后的/more/path/info),即使服务器核心对请求的附加路径信息返回 404 NOT FOUND错误。省略AcceptPathInfo指令与将它设置为on对mod_cgi请求具有相同的效果。
REMOTE_HOST
这个变量只有在HostnameLookups指令被设置为on( 缺省是off)并且对访问主机的DNS反查确实找到了主机名时才被设置。
REMOTE_IDENT
这个变量只有在IdentityCheck被设置为on 并且访问主机支持识别协议时才被设置。注意这个变量不能信赖,因为它很容易被假冒。 而且要是客户端与服务器之间存在代理的话,那通常这个变量完全没有用。
REMOTE_USER
这个变量只有当CGI脚本需要身份验证时被设置。
top

CGI脚本的调试

调试CGI脚本一直以来都很困难,主要是因为在脚本不能正确运行时不可能研究它的输出 (stdout和stderr)。这些包括在Apache 1.2和以后版本的指令为发生错误时提供了更详细的错误日志。

CGI日志文件格式

配置好以后,CGI错误日志会记录任何没有正确运行的CGI。每个运行失败的CGI脚本都有几行信息被记录。 头两行总是这样的格式:

%% [time] request-line
%% HTTP-status CGI-script-filename

如果错误是CGI脚本无法执行,日志文件会包含以下额外的两行:

%%error
error-message

或者,如果错误是脚本执行结果返回了不正确的头信息(经常是由于脚本内部的bug),会记录以下两行:

%request
All HTTP request headers received
POST or PUT entity (if any)
%response
All headers output by the CGI script
%stdout
CGI standard output
%stderr
CGI standard error

(如果脚本没有在stdout和stderr上输出可能会没有%stdout和%stderr部分)。

top

ScriptLog 指令

说明:定位CGI脚本错误日志文件的位置
语法:ScriptLog file-path
上下文:服务器配置, 虚拟主机
状态:Base
模块:mod_cgi, mod_cgid

ScriptLog指令对CGI脚本错误日志文件进行设置。 如果没有设置ScriptLog,就不会创建错误日志。如果设置了,所有CGI错误都会被记入作为指令参数的文件名中。 如果是一个相对路径则它是以ServerRoot为参照。

例子

ScriptLog logs/cgi_log

此日志会以运行子进程的用户身份打开,比如由主要的User指令指定的用户。这意味着,或者该用户对脚本日志所在目录具有写权限, 或者日志文件由此用户手工创建并设置为可写。如果你把脚本日志放在你的主日志目录中, 不要为了让运行子进程的用户可以写日志而改变目录的权限。

注意,脚本日志是为了给创建CGI脚本提供一个调试特性,而不是要在运行服务时持续保持活动状态。 它没有为速度或是效率作优化,而且与专门设计的那些特性不同,在某种程度上它会存在安全问题。

top

ScriptLogBuffer 指令

说明:会记录入日志文件的PUT或者POST请求头的最大数量
语法:ScriptLogBuffer bytes
默认值:ScriptLogBuffer 1024
上下文:服务器配置, 虚拟主机
状态:Base
模块:mod_cgi, mod_cgid

限制记入日志文件的PUT或者POST内容的大小,防止如果接收到很大内容时日志文件的尺寸增加得太快太大。 缺省地,最多纪录1024字节,但这个数字可以用此指令改变。

top

ScriptLogLength 指令

说明:CGI脚本日志文件的大小限制
语法:ScriptLogLength bytes
默认值:ScriptLogLength 10385760
上下文:服务器配置, 虚拟主机
状态:Base
模块:mod_cgi, mod_cgid

ScriptLogLength指令可以用于限制CGI脚本文件的大小。 由于日志文件对每个CGI错误纪录(所有请求头,所有脚本输出)许多信息, 它有可能会变成一个很大的文件。为了防止无限制的增长引起的问题,这个指令 可以用来给CGI日志文件的大小设置一个上限。如果文件大小达到了这个限制,就不会再有信息被写入日志。。

 


项目维护者: kajaa [本文译者: suncjs * ]

项目说明 | 项目进度 | 项目讨论区 | Apache手册中文版