SSI 在 Apache 服务器的使用方法

Back to Documentation Index

SSI 简介

SSI 是英文 Server Side Includes 的缩写,翻译成中文就是服务器端包含的意思。从技术角度上说,SSI 就是在 HTML 文件中,可以通过注释行调用的命令或指针。SSI 具有强大的功能,只要使用一条简单的SSI 命令就可以实现整个网站的内容更新,时间和日期的动态显示,以及执行 shell 和 CGI 脚本程序等复杂的功能。SSI 可以称得上是那些资金短缺、时间紧张、工作量大的网站开发人员的最佳帮手。本文将主要结合 Apache 服务器介绍 SSI 的使用方法。

如何启动 SSI

在 Apache 服务器下,可以通过直接编辑服务器配置文件或者在需要使用 SSI 的目录中创建 .htaccess 文件来启动 SSI。具体过程如下:

  1. 服务器配置文件

    如果用户具有对服务器配置文件的访问权限,可以通过编辑文件 access.conf 和 srm.conf 启动 SSI。

    首先登录到服务器,找到配置文件的存放目录,使用任何一种文字编辑器打开文件 srm.conf,找到以下几行:

    # If you want to use server side includes, or CGI outside
    # ScriptAliased directories, uncomment the following lines.
    #AddType text/x-server-parsed-html .shtml
    #AddType application/x-httpd-CGI .CGI

    注意,高版本的 Apache 可能是这几行:

    #
    # To use server-parsed HTML files
    #
    #AddType text/html .shtml
    #AddHandler server-parsed .shtml

    用户的配置文件中可能没有上述的注释指令行,但是只要找到以 AddType 开头的两行并且去掉每一行最前面的"#"符号即可。

    保存所做的修改,然后再打开文件 access.conf。用户需要在文件中找到设置 DocumentRoot(根文件)的部分。一般来说该段文本如下:

    # This should be changed to whatever you set DocumentRoot to.
    <Directory /usr/local/etc/httpd/htdocs>
    # This may also be "None", "All", or any combination of "Indexes",
    # "Includes", or "FollowSymLinks"
    Options Indexes FollowSymLinks
    </Directory>

    将其中的 Options Indexes FollowSymLinks 改为 Options Indexes FollowSymLinks Includes

    如果用户不希望执行脚本或 shell 命令,可以在 options 选项行中加入关键字 IncludesNOEXEC,这样可以允许 SSI,但是不能执行 CGI 或脚本命令(注:高版本的 Apache 服务器中,以上所提到的内容都已经被包含在配置文件 httpd.conf 中)。

  2. 创建文件 .htaccess

    如果用户不能直接访问服务器配置文件,可以使用文件编辑器创建一个名为 .htaccess 的文件。注意,文件名前一定要有符号".",这样服务器才能知道该文件是隐藏文件,从而提高文件的安全性,以避免错误操作。在 .htaccess 文件中需要加入以下三行文字:

    Options Indexes FollowSymLinks Includes
    AddType application/x-httpd-CGI .CGI
    AddType text/x-server-parsed-html .shtml

    完成之后,可以把 .htaccess 文件上传到服务端的相应目录,该文件对所有子目录有效。如果用户希望在目录级上禁止 CGI 或 shell 命令,可以在 .htaccess 文件中的 Options 选项行加入关键字 IncludesNOEXEC。

  3. 使用 .shtml 还是 .html

    任何包含 SSI 的文件在下传到客户端之前,都必须经过服务器的解析过程。这样会增加服务器的负载,如果用户只希望在几个特殊页面中使用 SSI,可以将文件的后缀名改为 .shtml,这样服务器就可以只解析包含 SSI 的 .shtml 文件。另一方面,如果有多个页面使用了 SSI,但是用户不希望使用 .shtml 的后缀名时,可以在 .htaccess 文件中使用以下命令行:

    AddType text/x-server-parsed-html .html