Sun Java System Web Server 7.0 Update 3 管理员指南

附录 D Windows CGI 程序

安装 Windows CGI 程序

本节介绍如何安装 Windows CGI 程序。本节中包含以下主题：

Windows Shell CGI 程序概述

Shell CGI 是一种服务器配置，通过该配置，您可以使用在 Windows 中设置的文件类型关联来运行 CGI 应用程序。

例如，如果服务器收到对一个名为 hello.pl 的 shell CGI 文件的请求，服务器将通过与 .pl 扩展名关联的程序，使用 Windows 文件类型关联来运行该文件。如果 .pl 扩展名与程序 C:\bin\perl.exe 相关联，服务器将尝试执行 hello.pl 文件，如下所示：

c:\bin\perl.exe hello.pl

配置 shell CGI 的最简便方式是在服务器的文档根目录中创建一个仅包含 shell CGI 文件的目录。但是，也可以通过从 Sun Java System Web Server 中编辑 MIME 类型来配置服务器，以使特定的文件扩展名与 shell CGI 相关联。有关使用 CGI 的更多信息，请参见《Sun Java System Web Server 7.0 Update 3 Developer’s Guide》中的第 3 章 “Using Common Gateway Interface”。

指定 Shell CGI 目录 (Windows)

要为 shell CGI 文件创建目录，请执行以下步骤。

为 Shell CGI 文件创建目录

在计算机上创建 shell 目录。此目录不必是文档根目录的子目录。

从主页中选择虚拟服务器，然后选择“编辑虚拟服务器”>“内容处理”> "CGI"（子选项卡）。

在“CGI 目录”表中单击“新建”按钮。

将显示一个新窗口。

在“URL 前缀”字段中，输入要与 shell CGI 目录关联的 URL 前缀。

例如，假定将所有 shell CGI 文件存储在名为 C:\docs\programs\cgi\shell-cgi 的目录中，但希望用户看到的是 http://www.yourserver.com/shell/。在这种情况下，应键入 shell 作为 URL 前缀。

在“目录”字段中，输入所创建的目录的绝对路径。

注 –
服务器必须具有此目录的读取和执行权限。对于 Windows，用于运行服务器的用户帐户（如 LocalSystem）必须具有在 shell CGI 目录中读取和执行程序的权限。

选择 "CGI" 或 "Shell CGI" 选项。

确保 shell CGI 目录中的所有文件也在 Windows 中设置了文件关联。如果服务器尝试运行没有文件扩展名关联的文件，则会返回错误。

单击“确定”。

指定 Windows CGI 作为文件类型

可以使用 Sun Java System Web Server 的“MIME 类型”窗口，将文件扩展名与 shell CGI 功能相关联。这与在 Windows 中创建关联有所不同。将文件扩展名与 shell CGI 功能相关联是在服务器中完成的。例如，可以为具有 .pl 扩展名的文件创建关联。当服务器收到具有该扩展名的文件的请求时，它通过在 Windows 中调用与该文件扩展名关联的可执行文件，将该文件作为 shell CGI 文件进行处理。

要为 Windows CGI 文件指定文件扩展名，请执行以下步骤。

为 Windows CGI 文件指定文件扩展名

在计算机上创建 shell 目录。此目录不必是文档根目录的子目录。

导航至“日常任务”>“配置（选择配置）”>“常规”>“MIME 类型”（子选项卡）。

单击“新建”按钮以创建 MIME 类型。

将显示一个新窗口。

使用以下设置添加新的 MIME 类型：
- MIME 标头：从以下内容中选择 MIME 标头：Content-type、Content-encoding 和 Content-language。
- MIME 值：magnus-internal/wincgi。
- 文件后缀：输入希望服务器创建 shell CGI 关联的文件后缀。如果激活了 CGI、WinCGI 和 shell CGI 文件类型，则必须为每种类型的 CGI 指定不同的后缀。例如，CGI 程序和 shell CGI 程序不能同时使用 .exe 后缀。如果需要该后缀，则可以编辑页面上的其他 MIME 类型字段，以使后缀保持唯一。

单击“确定”按钮。