4.2.3 服務(wù)器端包含指令的例子
       本節(jié)提供了一些示例頁面，可以用來對各種服務(wù)器端包含語句進(jìn)行實(shí)驗(yàn)。打開示例網(wǎng)頁的子目錄Chapter04，顯示“SSI Directives and the ASP Server Object”主頁（即子目錄Chapter04中的Default.asp），如圖4-3所示：

圖4-3  示例網(wǎng)頁
       本書的所有示例都可以從我們的Web網(wǎng)站下載。讀者將在示例的子目錄Chapter04中發(fā)現(xiàn)本章其余部分的所有示例頁面。
1．  使用SSI/CGI處理指令
單擊鏈接進(jìn)入“Server-Side Include and CGI Statements”頁面，這將打開ssi_cgi.stm頁面。需要注意的是該頁面的文件擴(kuò)展名為.stm，表明這不是一個(gè)ASP網(wǎng)頁。該頁面使用了前面已經(jīng)討論過的除#exec指令（稍后將看到）以外的所有SSI指令，且顯示指令的使用方法和結(jié)果，如圖4-4所示：

圖4-4  示例網(wǎng)頁顯示的SSI/CGI處理指令情況
(1)#include指令
該頁的開始部分“Include Files with SSI”，顯示名為intro.inc的另一個(gè)單獨(dú)文件的內(nèi)容。下面是該文件的全部內(nèi)容：
注意我們必須使用HTML條目“<”和“>”來顯示網(wǎng)頁中的尖括號。如果不這樣做，它們就不能被當(dāng)作注解元素部分看待，并引起其中的指令被執(zhí)行。
在主ssi_cgi.stm頁面中，把這個(gè)文件插入到該頁中的代碼是很簡單的：
<!-- #include file=”intro.inc” -->
(2)#config、#fsize和#flastmod指令
網(wǎng)頁下一部分顯示了與該頁面在相同的目錄中的文件Default.asp的大小和最后被修改的時(shí)間。這里三次使用了#config指令：
· 一次是設(shè)置SSI錯(cuò)誤信息。
· 一次是設(shè)置日期和時(shí)間的格式。
· 一次是設(shè)置文件大小計(jì)算的格式。
使用#fsize和#fiastmod指令把值插入到該網(wǎng)頁中：
<P><DIV CLASS="subhead">SSI Statements</DIV>
<!-- #config ERRMSG="SSI Processing Error" --> &nbsp;
(sets error message in case of SSI error)<BR>
<!-- #config ERRMSG="SSI Processing Error" --><P>

Details of file 'Default.asp':<BR>
<!-- #config SIZEFMT="BYTES" --> &nbsp;
(sets fsize to return size in bytes)<BR>
<!-- #config SIZEFMT="BYTES" -->

<!-- #fsize FILE="Default.asp" -->
returns: &nbsp; <B><!-- #fsize FILE="Default.asp" --> bytes</B><BR>

<!-- #config TIMEFMT="%A, %B %d %Y %H:%M:%S" --> &nbsp;
(sets format for date/time results)<BR>
<!-- #config TIMEFMT="%A, %B %d %Y %H:%M:%S" -->

<!-- #flastmod FILE="Default.asp" -->
returns: &nbsp; <B><!-- #flastmod file="Default.asp" --></B><P>
(3)#echo 指令
該頁的最后部分（在屏幕上只能看到一部分）顯示可以使用#echo指令訪問的所有HTTP報(bào)頭的內(nèi)容。每一行的代碼都是相同的，僅僅是VAR屬性值有變化。附錄G中給出了VAR屬性的所有容許值的一個(gè)完整列表。
<DIV CLASS="subhead">HTTP Variables</DIV>
<!-- #echo VAR="AUTH_TYPE" -->
returns: &nbsp;<B><!-- #echo var="AUTH_TYPE" --></B><BR>
<!-- #echo VAR="AUTH_PASSWORD" -->
returns: &nbsp;<B><!-- #echo var="AUTH_PASSWORD" --></B><BR>
… etc …
2．  使用#exec指令
#exec指令與其他的SSI指令相比使用起來困難一些，正因?yàn)槿绱耍瑢⑵洫?dú)立地放到了另一個(gè)頁面上。可以從“ASP Server Object and SSI Directives”主菜單上訪問啟動(dòng)頁面。
在該頁面上，選擇“Using the #echo Server-Side Include Directive”鏈接。這個(gè)操作打開“The SSI #exec Directive”頁面，如圖4-5所示：

圖4-5  “The SSI #exec Directive”網(wǎng)頁
這是一個(gè)ASP網(wǎng)頁ssi_exec.asp。兩個(gè)按鈕用來打開.stm頁面，該頁面執(zhí)行其中使用#exec指令所描述的動(dòng)作。
(1)    在服務(wù)器上運(yùn)行這個(gè)示例
在SSI #exec指令示例能夠在服務(wù)器上工作之前，必須對一些配置進(jìn)行修改。首先，需要在Web服務(wù)器的注冊表中創(chuàng)建SSIEnableCmdDirective項(xiàng)（類型DWORD），位置在下面的鍵名下：
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\W3SVC\Parameters
然后設(shè)置該值為1，如圖4-6所示：

圖4-6  注冊表中的設(shè)置
這樣就允許#exec指令與CMD屬性一起使用。
其次，必須對包含使用#exec指令的.stm文件的目錄禁止匿名訪問，客戶端將被強(qiáng)制提供帳號的詳細(xì)情況，該帳號應(yīng)是一個(gè)具有管理員級權(quán)限帳號。這也是net命令正常工作的要求。
激活I(lǐng)nternet Services Manager應(yīng)用程序，并選擇包含使用#exec指令的.stm文件的目錄（在示例中，這些文件是exec目錄下的start_cisvc.stm和stop_cisvc.stm）。然后打開該目錄的Properties對話框。在Directory Security選項(xiàng)卡中單擊Anonymous access and authentication control區(qū)域中的Edit按鈕，打開 Authentication Methods對話框，如圖4-7所示：

圖4-7  設(shè)置驗(yàn)證方法的對話框
這個(gè)對話框不選中Anonymous access復(fù)選框。如果不使用Internet Explorer訪問該頁面，打開Basic authentication選項(xiàng)以允許非IE瀏覽器通過提交用戶名/口令訪問該頁面。設(shè)置時(shí)，會(huì)出現(xiàn)一個(gè)有關(guān)安全的警告，單擊Yes。現(xiàn)在瀏覽器將被強(qiáng)制出示合適的帳號和身份證明，因?yàn)椴荒苣涿�訪問該網(wǎng)頁。
為了能看到啟動(dòng)和終止服務(wù)的結(jié)果，打開“Services MMC插件”，終止Indexing Service，如圖4-8所示：

圖4-8  啟動(dòng)和終止服務(wù)的屏幕
(2)    啟動(dòng)和終止Indexing Service
單擊示例Web網(wǎng)頁上的按鈕，啟動(dòng)Microsoft Indexing Service。
這個(gè)服務(wù)的短名稱為cisvc，它通常稱為Microsoft Index Server，名稱中的“ci”字符，實(shí)際上代表“content indexer”。
出現(xiàn)提示時(shí)，輸入在Web服務(wù)器上的具有管理員權(quán)限的一個(gè)帳號的用戶名和口令。當(dāng)該頁面（start_cisvc.stm）打開時(shí)，你將感覺到一定的延遲，這是因?yàn)?exec指令載入一個(gè)窗口命令解釋器（cmd.exe）的實(shí)例，然后執(zhí)行net start命令。一旦服務(wù)啟動(dòng)（或者如果已經(jīng)在運(yùn)行），將顯示該頁面的其余部分，如圖4-9所示：

圖4-9  輸入用戶名和口令后顯示的界面
這個(gè)頁面的代碼十分簡單。可以看到#exec指令帶有CMD屬性，它設(shè)置為“cmd.exe /c net start cisvc”。窗體包含有重新回到前一頁面的SUBMIT按鈕：
<P>Processing the SSI directive:</P>
<P><B><!-- #exec CMD="cmd.exe /c net stop cisvc" --></B></P>
<!-- #exec CMD="cmd.exe /c net stop cisvc" -->

<FORM ACTION="../ssi_exec.asp">
<INPUT TYPE="SUBMIT" NAME="cmdOK" VALUE="&nbsp;&nbsp;&nbsp;">
&nbsp; Return to the previous page<P>
</FORM>
從前一頁面可以打開其他的.stm網(wǎng)頁，如stop_cisvc.stm用來再次終止該服務(wù)，不同之處僅在于使用了net stop命令而不是net start命令。
…
<!-- #exec CMD=”cmd.exe /c net stop cisvc” -->
…