從 這 一 講 開 始，我 們 將 進 入 CGI 程 序 設 計 的 學 習 過 程。通 過 前 面 幾 講 的 學 習，您 已 經 掌 握 了 CGI 程 序 設 計 的 基 礎 知 識。現 在，您 可 以 坐 下 來 編 寫 CGI 程 序 了！
三、CGI 程 序 設 計
1、服 務 器 端 附 件 (SSI) 及 網 關
2、網 關：通 過 WEB 連 接 其 他 協 議
在 編 寫 CGI 程 序 的 過 程 中，最 好 遵 循 以 下 幾 個 應 用 程 序 設 計 的 要 點：
（1）提 出 問 題 -- 您 要 解 決 的 問 題
（2）設 計 階 段 -- 構 想 出 CGI 程 序 的 基 本 框 架 和 功 能
（3）編 碼 階 段 -- 用 行 動 實 現 思 想
（4）程 序 移 植 -- 編 寫 可 移 植 的 代 碼
（5）精 益 求 精 -- 使 程 序 更 上 一 層 樓
1、服 務 器 端 附 件 (SSI) 及 網 關
在 本 節 將 介 紹 服 務 器 端 附 件 SSI(Server Side Include) 和 網 關。嚴 格 的 說，SSI 並 不 是 CGI 程 序 設 計 的 內 容，但 SSI 可 以 完 成 一 些 簡 單 CGI 程 序 所 能 完 成 的 工 作，有 時 SSI 甚 至 是 最 好 的 選 擇。因 此，在 這 裡 作 簡 單 介 紹。
SSI 定 義 了 一 組 嵌 入 HTML 文 本 的 命 令，在 HTML 文 本 送 往 HTTP 客 戶 端 前，WEB 服 務 器 對 這 些 SSI 命 令 先 作 預 處 理，將 處 理 後 的 Html 文 本 輸 出 到 HTTP 客 戶 端 的 浏 覽 器。
SSI 的 命 令 格 式 是：
< !--# 命 令 參 數 =" 值 " -->
SSI 命 令 同 Java 或 JavaScript 不 同，它 是 在 服 務 器 端 處 理 的，而 不 是 在 客 戶 端 處 理 的，這 一 點 同 CGI 程 序 是 相 似 的。當 然，在 SSI 的 功 能 范 圍 內，其 優 點 同 CGI 程 序 相 同，可 以 提 高 服 務 器 的 資 源 利 用 率，而 且 在 客 戶 端 用 任 何 WEB 浏 覽 器 都 可 以 浏 覽 含 有 SSI 的 Html 文 本。
下 面 是 常 用 的 六 個 SSI 命 令：
（1）Include命令
（2）echo 命 令
（3）exec 命 令
（4）config 命 令
（5）fsize 命 令
（6）flastmod 命 令
include 命 令
唯 一 支 持 的 參 數 是 file，這 是 在 當 前 HTML 文 本 中 插 入 file 參 數 指 定 的 文 件 的 內 容。如 果 您 了 解 C 語 言，可 以 看 出 它 和 C 語 言 中 的“#include”命 令 的 功 能 是 一 樣 的。例 如，有 兩 個 HTML 文 本：main.html 和 header.html，在 main.html 中 使 用 include 命 令： main.Html:
< Html>
< tilte> Test Include SSI Command < /title>
< !--#include file="header.Html" -->
< body>
The above header comes from header.Html!
< /body>
< /Html>
header.Html:
< H1> This is a title in header.Html! < /H1>
( 不 過，好 象 OmniHTTPD 不 支 持 include 命 令，:< !)
echo 命 令
唯 一 支 持 的 參 數 是 var，它 用 於 顯 示 服 務 器 提 供 的 變 量，例 如：
DOCUMENT_NAME：當 前 文 件 名
DOCUMENT_URL：SSI 文 本 的 相 對 路 徑
DATE_LOCAL：當 地 日 期
DATE_GMT：GMT(Creenwich 標 准 時 間 ) 日 期
LAST_MODIFIED：包 含 此 SSI 命 令 的 文 件 的 最 近 修 改 日 期
HTTP_USER_AGENT：浏 覽 器 名。
例 如：main.shtml < Html>
This document was last updated on < !--#echo var="LAST_MODIFIED"-->
< /Html>
當 您 用 浏 覽 器 打 開 main.shtml 時 可 以 看 到 最 後 修 改 時 間。( 要 注 意 的 是，必 須 將 main.shtml 存 儲 在 OmniHTTPD 的 HtDocs 目 錄 下，在 浏 覽 器 中 用 地 址 http://localhost/main.sHtml 訪 問。)
exec 命 令
兩 個 參 數 是 cgi 和 cmd。前 者 調 用 一 個 可 執 行 文 件，如 cgi="/cgi-bin/finger.CGI"；後 者 調 用 一 個 系 統 命 令，如 cmd="ls"。遺 憾 的 是，OmniHTTPD 不 支 持 此 SSI 命 令 ( 也 許 現 在 的 最 新 版 支 持 )。
config 命 令
此 命 令 設 置 服 務 器 處 理 文 件 和 顯 示 日 期 的 方 法。它 有 兩 個 參 數：
（1）timefmt，決 定 顯 示 日 期 的 格 式。在 UNIX 中 用 man strftime 查 詢 可 用 的 值。
（2）sizefmt，決 定 顯 示 文 件 長 度 的 格 式。值 為 bytes 或 addrev。這 個 命 令 在 OmniHTTPD 中 也 不 支 持。
fsize 命 令
此 命 令 顯 示 給 定 文 件 的 大 小。參 數 是 file，指 定 文 件 的 路 徑 及 文 件 名。
flastmod 命 令
此 命 令 顯 示 指 定 文 件 的 最 近 修 改 日 期。參 數 是 file，指 定 文 件 的 路 徑 及 文 件 名。
2、網 關：通 過 WEB 連 接 其 他 協 議
HTTP 協 議 無 法 訪 問 Internet 的 所 有 資 源，要 訪 問 HTTP 協 議 以 外 的 資 源 時 ( 例 如 POP3 和 SMTP 收 發 電 子 郵 件 )，就 需 要 網 關。CGI 程 序 是 實 現 網 關 的 好 方 法。
在 許 多 UNIX 的 HTTP 服 務 器 中 提 供 一 些 常 用 的 網 關，例 如 finger、wais、archIE 等。但 在 OmniHTTPD 中，沒 有 提 供 這 些 網 關。但 我 們 可 以 通 過 編 寫 CGI 程 序 向 OmniHTTPD 中 增 加 網 關 功 能。
表 單 及 其 處 理
HTML 表 單 是 WEB 文 檔 的 一 部 分 ， 用 於 將 用 戶 填 寫 的 信 息 提 交 給 服 務 器 。 通 常 ， 這 些 信 息 傳 遞 給 CGI 程 序 ， CGI 程 序 依 據 輸 入 信 息 進 行 一 系 列 操 作 或 數 據 加 工 ， 再 生 成 表 示 處 理 結 果 的 Html 文 檔 發 回 給 客 戶 浏 覽 器 。
由 此 可 見 ， CGI 程 序 的 關 鍵 部 分 是 得 到 輸 入 數 據 和 生 成 Html 文 檔 ， 而 操 作 和 數 據 處 理 部 分 同 大 多 數 應 用 程 序 相 同 。 在 這 一 講 ， 我 將 介 紹 如 何 在 Perl 和 Delphi 中 得 到 數 據 及 輸 出 Html 文 檔 。
首 先 ， 我 們 建 立 一 個 名 為 greeting.html 的 Html 文 檔 ：
greeting.Html 文 件 ( 存 儲 在 OmniHTTPD 的 HtDocs 目 錄 下 )
< Html>
< head>
< title> This is a greeting page! < /title>
< h1> Greeting < /h1>
< body>
< hr>
< form action="/CGI-bin/greeting.pl" method=POST>
< p> Your First Name: < input type=text name="firstname" size=60 maxlength=80> < /p>
< p> Your Last Name: < input type=text name="lastname" size=60 maxlength=80> < /p>
< hr>
< p> < input type=submit value="All OK!"> < input type=reset value="Clear All"> < /p>
< /form>
< /body>
< /Html>
下 面 是 Perl 的 CGI 程 序 greeting.pl ：
greeting.pl 文 件 ( 存 儲 在 OmniHTTPD 的 CGI-bin 目 錄 下 ) # Greeting You!
require "CGI-lib.pl";
# ===================================
# get input values
&ReadParse(*input);
$mFirstName = $input{'firstname'};
$mLastName = $input{'lastname'};
# ===================================
# do some Operations here
$mFullName = "$mFirstName $mLastName";
# ===================================
# create Html document to output
print &PrintHeader;
print "< Html>< head>< title> Greeting You! < /title>< /head> ";
print "< body> Hello, < i>$mFullName< /i> ! ";
print "< hr> by Greeting.pl < /body>< /Html>";
# ===================================
# All done!
通 過 浏 覽 http://localhost/greeting.Html 測 試 CGI 程 序 。
在 上 面 的 Perl 程 序 中 ， 作 為 CGI 程 序 ， 必 須 用 require "cgi-lib.pl" 來 引 用 cgi-lib.pl 文 件 ， 此 文 件 有 許 多 用 於 CGI 編 程 的 函 數 和 過 程 。 require 相 當 於 C 中 的 #include ， 但 要 注 意 的 是 ， require 語 句 後 必 須 有 分 號 。
ReadParse 過 程 讀 取 Html 表 單 提 交 的 數 據 ， 參 數 是 一 個 數 組 指 針 。 要 注 意 的 是 ， 在 Perl 中 ， 函 數 和 過 程 的 調 用 要 在 前 面 加 上 & 符 號 。
mFirstName 、 mLastName 和 mFullName 是 變 量 。 在 Perl 中 ， 變 量 名 前 要 有 $ 符 號 。
PrintHeader 函 數 實 際 上 返 回 值 是 "Content-type: text/html " ， 它 告 訴 浏 覽 器 下 面 的 數 據 是 Html 文 檔 。
生 成 HTML 文 檔 部 分 很 簡 單 ， 就 是 用 print 語 句 將 Html 文 檔 的 內 容 輸 出 就 可 以 了 。 怎 麼 樣 ， 會 用 Perl 編 寫 CGI 程 序 了 吧 ？
下 面 ， 我 們 來 編 寫 一 段 Delphi 程 序 來 完 成 相 同 的 功 能 ：
先 關 閉 Delphi 中 的 所 有 項 目 ， 選 擇 菜 單 File/New ， 在 對 話 框 中 選 擇 Web Server Application 類 型 ， 使 用 CGI Stand-alone excutable 選 項 ， 則 出 現 一 個 新 項 目 ， 其 主 窗 口 名 為 WebModule1 。
在 WebModule1 的 Actions 屬 性 上 雙 擊 鼠 標 ， 出 現 Actions 屬 性 編 輯 窗 口 。 在 窗 口 中 新 建 一 Action ， 名 為 WebActionItem1 ， 將 其 Default 屬 性 設 為 True ； 並 在 它 的 Events 中 雙 擊 OnAction 事 件 ， 添 入 下 面 的 代 碼 ：
procedure TWebModule1.WebModule1WebActionItem1Action(Sender: TObject;Request: TWebRequest; Response: TWebResponse; var Handled: Boolean);
var
mFirstName, mLastName, mFullName: string;
HtmlDoc: string;
begin
// Get Input Values:
mFirstName := Request.ContentFIElds.Values['firstname'];
mLastName := Request.ContentFIElds.Values['lastname'];
// Do some Operations here
mFullName := mFirstName + ' ' + mLastName;
// Create Html document to output
HtmlDoc := '< Html>< head>< title> Greeting You! < /title>< /head>';
HtmlDoc := HtmlDoc + '< body> Hello, < i>' + mFullName + '< /i> !';
HtmlDoc := HtmlDoc + '< hr> by Greeting.CGI < /body>< /Html>';
Response.Content := HtmlDoc;
end;
將 此 工 程 的 單 元 存 為 cgimain.pas ， 將 工 程 存 為 greeting.dpr 。 編 譯 ( 用 Ctrl+F9) 後 ， 將 greeting.exe 復 制 到 OmniHTTPD 的 cgi-bin 目 錄 下 ， 並 改 名 為 greeting.CGI 。 同 時 ， 將 前 面 我 們 寫 的 greeting.Html 做 如 下 修 改 ：
將 < form action="/CGI-bin/greeting.pl" method=POST> 改 成
< form action="/cgi-bin/greeting.CGI" method=POST>
這 樣 ， 通 過 浏 覽 http://localhost/greeting.Html 就 可 以 測 試 用 Delphi 編 寫 的 CGI 程 序 了 。
從 這 個 程 序 可 以 看 出 ， 在 Delphi 中 CGI 程 序 一 得 到 一 個 請 求 就 發 生 WebActionItem 的 OnAction 事 件 。 在 這 個 事 件 中 ， 數 據 輸 入 和 Html 文 檔 生 成 是 這 樣 做 的 ：
通 過 Request.ContentFIElds.Values[Html 表 單 元 素 名 ] 得 到 表 單 元 素 的 值 。
通 過 對 Response.Content 賦 值 生 成 Html 文 檔 。
下 面 是 Delphi 程 序 的 三 個 文 件 內 容 ： -----------------------------------------------------------
greeting.dpr :
program greeting;
{$APPTYPE CONSOLE}
uses
HTTPApp,
CGIApp,
cgimain in 'CGImain.pas' {WebModule1: TWebModule};
{$E CGI}
{$R *.RES}
begin
Application.Initialize;
Application.CreateForm(TWebModule1, WebModule1);
Application.Run;
end.
-----------------------------------------------------------
CGImain.pas :
unit CGImain;
interface
uses Windows, Messages, SysUtils, Classes, HTTPApp;
type
TWebModule1 = class(TWebModule)
procedure WebModule1WebActionItem1Action(Sender: TObject;Request: TWebRequest; Response: TWebResponse; var Handled: Boolean);
private
{ Private declarations }
public
{ Public declarations }
end;
var
WebModule1: TWebModule1;
implementation
{$R *.DFM}
procedure TWebModule1.WebModule1WebActionItem1Action(Sender: TObject; Request: TWebRequest; Response: TWebResponse; var Handled: Boolean);
var
mFirstName, mLastName, mFullName: string;
HtmlDoc: string;
begin
// Get Input Values:
mFirstName := Request.ContentFIElds.Values['firstname'];
mLastName := Request.ContentFIElds.Values['lastname'];
// Do some Operations here
mFullName := mFirstName + ' ' + mLastName;
// Create Html document to output
HtmlDoc := '< Html>< head>< title> Greeting You! < /title>< /head>';
HtmlDoc := HtmlDoc + '< body> Hello, < i>' + mFullName + '< /i> !';
HtmlDoc := HtmlDoc + '< hr> by Greeting.CGI < /body>< /Html>';
Response.Content := HtmlDoc;
end;
end.
-----------------------------------------------------------
CGImain.dfm ：
object WebModule1: TWebModule1
OldCreateOrder = False
Actions = <
item
Default = True
Name = 'WebActionItem1'
OnAction = WebModule1WebActionItem1Action
end>
Left = 192
Top = 107
Height = 150
Width = 215
end
