> Apache2.2 中文手册 > 服务器端包含(SSI)入门

服务器端包含入门

服务器端包含提供了一种对现有HTML文档增加动态内容的方法。

服务器端包含(SSI)入门

mod_include
  • mod_cgi
  • mod_expires
  • 本文针对服务器端包含(SSI)讨论如何配置服务器以允许SSI ,并介绍一些对现有HTML页面增加动态内容的基本SSI技术。

    本文后部将讨论用SSI做一些稍微高级的事情,比如SSI指令中的条件语句。

    服务器端包含(SSI)入门

    什么是SSI ?

    SSI是嵌入HTML页面中的指令,在页面被提供时由服务器进行运算,以对现有HTML页面增加动态生成的内容,而无须通过CGI程序提供其整个页面,或者使用其他动态技术。

    至于什么时候应当用SSI ,而什么时候应当用某些程序生成整个页面,取决于页面中有多少内容是静态的,又有多少内容需要在每次页面被提供时重新计算。SSI是一种增加小段动态信息的好方法,比如当前时间。如果你的页面大部分内容是在被提供时动态生成的,那就要另找方案了。

    服务器端包含(SSI)入门

    配置服务器以允许SSI

    要使服务器允许SSI ,必须在httpd.conf.htaccess文件中有如下配置:

    Options +Includes

    这样就告诉服务器允许解析文件中的SSI指令。注意,在多数配置中,多个Options指令会互相覆盖,所以可能需要对使用SSI的目录专门使用一个Options指令,以确保其有效。

    并非所有文件中的SSI指令都会被解析,必须告诉Apache应该解析哪些文件。有两种方法使Apache解析带有特定后缀名的文件,比如:.shtml ,配置如下:

    AddType text/html .shtml
    AddOutputFilter INCLUDES .shtml

    该方法的缺点之一是,为了使文件具有.shtml后缀从而执行其中的指令,需要加入SSI指令的现有文件的名字,以及所有指向此页面的连接。

    另一种方法是,使用XBitHack指令:

    XBitHack on

    XBitHack告诉Apache解析所有设置了执行位的文件中的SSI指令。这样,无需修改文件名,只要用chmod使文件变成可执行的,就可以对现有页面增加SSI指令。

    chmod +x pagename.html

    这里简要说明一点:偶然会有人向你推荐,无须用带.shtml的文件名,只要使Apache解析所有.html文件的SSI就可以了。那些人可能没听说过XBitHack 。要知道,这样做会使Apache在发送文件到客户端之前通读此文件,即使其中并没有任何SSI指令,从而对速度有很不利的影响,所以这并不是好办法。

    当然,在Windows上,没有对应的执行位可以设置,所以对你的配置方法就有一些限制。

    在默认配置的情况下,Apache不会为SSI页面发送最后修改日期或者内容长度的HTTP头,因为这些值对动态页面来说难以确定。这样会阻止页面被缓冲,导致客户端性能有明显的下降。有两种解决方法:

    1. 设置 XBitHack Full ,告诉Apache在判断最后修改日期时,只查看被请求文件本身的日期,而忽略其中包含的其它文件的修改日期。
    2. 使用mod_expires提供的指令为文件设置一个明确的过期时间,并告诉浏览器和代理这个文件可以被缓冲。
    服务器端包含(SSI)入门

    基本SSI指令

    SSI指令有如下语法:

    <!--#element attribute=value attribute=value ... -->

    类似于HTML注释,即使没有正确配置SSI ,它也不会被浏览器显示,但在HTML代码中可见。而若正确配置了SSI ,则指令会被其结果所取代。

    其中的元素可以有许多,我们会在下一个版本的文档中讨论其中的大多数,而在这里,仅举几个SSI的例子。

    今天的日期

    <!--#echo var="DATE_LOCAL" -->

    echo元素用于显示一个变量的值。标准变量有很多,其中包含对CGI程序有效的所有环境变量。并且还可以用set元素定义你自己的专用变量。

    如果你不喜欢这种日期格式,可以用config元素的timefmt属性,改变其格式。

    <!--#config timefmt="%A %B %d, %Y" -->
    Today is <!--#echo var="DATE_LOCAL" -->

    文件的修改日期

    This document last modified <!--#flastmod file="index.html" -->

    这个元素使用timefmt的格式配置。

    包含一个CGI程序的输出结果

    这也是SSI很常见的一个用途:包含一个CGI程序的输出,比如人人喜欢的"点击计数器"。

    <!--#include virtual="/cgi-bin/counter.pl" -->

    服务器端包含(SSI)入门

    google查找strftime ,其语法是相同的。

    包含一个标准页脚

    当你管理一个拥有许多页面的站点,你会发现对所有页面同时做改动是很痛苦的,尤其是在试图对所有页面维持某种标准视觉效果的时候。

    使用包含一个页眉/页脚的方法,可以减轻修改的负担。你只要制作一个页脚文件,并用include命令包含到每个页面即可。include元素能按file属性或virtual属性判断应该包含的文件。file属性是一个相对于当前目录的文件路径,即不能是一个绝对路径(以"/"开头)或包含"../"的路径。virtual属性可能更有用,它是一个相对于被提供的文档的URL ,可以以"/"开头,但必须与被提供的文档位于同一服务器上。

    <!--#include virtual="/footer.html" -->

    SSI指令和页脚文件相结合使用是很有用的,比如在页脚文件中使用LAST_MODIFIED指令。SSI指令可以出现在包含文件中,而include可以嵌套,即一个包含文件还可以再包含另外一个。

    服务器端包含(SSI)入门

    我还能设置其它什么?

    config除了能设置时间格式,还有两种用途。

    当SSI指令发生错误时,会产生如下消息:

    [an error occurred while processing this directive]

    为了改变消息的形式,可以使用config元素的errmsg属性:

    <!--#config errmsg="[It appears that you don't know how to use SSI]" -->

    希望最终用户永远也不会看到这个消息,因为在网站投入运行之前你已经把这些问题都解决了。是吗?

    还可以使用configsizefmt属性设置返回的文件大小的格式,或者是以bytes为单位,或者是以Kb或Mb为单位的简写(abbrev)

    服务器端包含(SSI)入门

    执行命令

    我期望未来几个月内能再写一篇小型的CGI程序使用SSI的文章,而这里仅介绍exec的使用。SSI确实可以利用shell(/bin/sh ,精确地说,还可以是Win32中的DOS shell)来执行命令。下例产生一个目录列表:

    <pre>
    <!--#exec cmd="ls" -->
    </pre>

    或者在Windows中:

    <pre>
    <!--#exec cmd="dir" -->
    </pre>

    你可能会发现,在Windows中这个指令的结果有些奇怪,dir的输出中包含有字符串"<dir>",它会使浏览器产生混淆。

    注意,这个功能是极度危险的,因为它会执行任何包含在exec标记中的命令。如果用户有可能修改你的网页内容,比如"留言本",那么你一定要关闭这个功能。可以在Options指令中加上IncludesNOEXEC参数,以关闭exec功能,同时又保留SSI。

    服务器端包含(SSI)入门

    环境变量和此前提到过的一些变量(如LAST_MODIFIED),作为你的专用变量。在变量名前面缀以"$",表示它是一个变量,而不是一个字面字符串。

    <!--#set var="modified" value="$LAST_MODIFIED" -->

    若要在字面字符串中使用"$",必须使用转义符号"\$":

    <!--#set var="cost" value="\$100" -->

    最后,如果要在较长的字符串中使用变量,可以用花括号把变量名括起来,以免变量名与其他字符混淆(要对这种情况举例说明有点难度,但还是希望你能领会)。

    <!--#set var="date" value="${DATE_LOCAL}_${DATE_GMT}" -->

    mod_include提供了if, elif, else, endif等结构以构造条件语句,从同一个页面高效地产生多个逻辑页面。

    条件结构如下:

    <!--#if expr="test_condition" -->
    <!--#elif expr="test_condition" -->
    <!--#else -->
    <!--#endif -->

    test_condition可以是任何逻辑比较:可以是一个值和另一个值比较,也可以是测试一个特定的值是否为"真"(一个给定的字符串如果非空则为真)。完整的比较操作符列表,参见mod_include 。以下是可能会用到的一些例子。

    在配置文件中,可以这样设置:

    BrowserMatchNoCase macintosh Mac
    BrowserMatchNoCase MSIE InternetExplorer

    如果客户端在Macintosh上运行Internet Explorer,则上例设置环境变量"Mac"和"InternetExplorer"都为真。

    然后,在允许SSI的文档中,可以这样设置:

    <!--#if expr="${Mac} && ${InternetExplorer}" -->
    Apologetic text goes here
    <!--#else -->
    Cool JavaScript code goes here
    <!--#endif -->

    我一点也不反对在Mac上运行IE,只是上个星期我花了好几个小时试图在Mac上的IE中使用JavaScript,而它在其他地方都能正常运作,以上只是一个临时的妥协方案。

    任何其他变量(或者是你定义的,或者是标准的环境变量)都可以用于条件语句。利用Apache的SetEnvIf以及其他相关指令设置环境变量,此功能可以很好地实现动态页面而无须借助于CGI。

    服务器端包含(SSI)入门

    总结

    SSI固然不能替代CGI或者其他动态页面技术,但它是在页面中插入众多小型的动态片段的优秀方法,而无须大量额外的操作。

    上一篇:
    下一篇: