ssi服务器端指令详解(shtml)

你是否曾经或正在为如何可以在最短的时间内完成对一个包含上千个页面的网站的修改而苦恼？那么能够看一下本文的介绍，或许可以对你有所帮助。
什么是SSI？
SSI是英文Server Side Includes的缩写，翻译成中文就是服务器端包含的意思。从技术角度上说，SSI就是HTML文件中，能够经过注释行调用的命令或指针。SSI 具备强大的功能，只要使用一条简单的SSI 命令就能够实现整个网站的内容更新，动态显示时间和日期，以及执行shell和CGI脚本程序等复杂的功能。SSI 能够称得上是那些资金短缺、时间紧张、工做量大的网站开发人员的最佳帮手。
SSI最初在NCSA服务器平台上推出，在Apache服务器中获得扩展和增强，目前已经能够在几乎全部的服务器上运行。本文将主要结合Apache服务器介绍SSI的使用方法。
如何启动SSI？
在Apache服务器下，能够经过直接编辑服务器配置文件或者在须要使用SSI的目录中建立.htaccess文件启动SSI。具体来讲，过程以下：
1.服务器配置文件
若是用户具备对服务器配置文件的访问权限，能够经过编辑文件access.conf和srm.conf启动SSI。
首先使用Telnet远程登陆服务器，找到配置文件的存放目录。通常来讲，Apache服务器的配置文件都被保存在“/usr/local/etc/httpd/conf”目录下。使用任何一种文字编辑器打开文件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
用户的配置文件中可能没有上述的注释指令行，可是只要找到以AddType开头的两行而且去掉每一行最前面的“#”符号便可。
保存所作的修改，而后再打开文件access.conf。用户须要在文件中找到设置DocumentRoot（根文件）的部分。通常来讲该段文本以下，可是不排除<Directory>和</Directory>标签之间还包含其它设置内容。
# 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 Includes 
</Directory>
若是用户不但愿执行脚本或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的话，确实没有必要让服务器解析每个页面。若是用户只但愿在几个特殊页面中使用SSI，能够将文件的后缀名改成.shtml，这样服务器就能够只解析包含SSI的.shtml文件。另外一方面，若是有多个页面使用了SSI，可是用户不但愿使用.shtml的后缀名时，能够在.htaccess文件中使用如下命令行：
AddType text/x-server-parsed-html .html
SSI语法
SSI在使用时遵循如下格式：
<!--#directive parameter="value"-->
其中，directive是向服务器发送的指令名称，parameter是指令的操做对象，而value则是用户但愿获得的指令处理结果。 
全部的SSI命令都是以“<!--#”开始，其中“<!—”和“#”之间不能有任何空格，不然服务器会把SSI命令当称普通的文件注释处理，不会显示出任何结果，也不会产生错误提示。此外，SSI命令中的“=”两边不能有空格，右边的值必须包含在双引号内，后面能够跟空格，最后是结束标签“-->”。
SSI命令包含六大类指令以及各自的参数，具体以下:
directives parameters
Config errmsg, timefmt, sizefmt
include virtual, file
echo var
fsize file
flastmod file
exec cmd, cgi
下面咱们将逐一进行介绍。
1.Config命令
Config命令主要用于修改SSI的默认设置。其中：
Errmsg：设置默认错误信息。为了可以正常的返回用户设定的错误信息，在HTML文件中Errmsg参数必须被放置在其它SSI命令的前面，不然客户端只能显示默认的错误信息，而不是由用户设定的自定义信息.
<!--#config errmsg="Error! Please email webmaster@mydomain.com -->
Timefmt：定义日期和时间的使用格式。Timefmt参数必须在echo命令以前使用。
<!--#config timefmt="%A, %B %d, %Y"-->
<!--#echo var="LAST_MODIFIED" -->
显示结果为：
Wednesday, April 12, 2000
也许用户对上例中所使用的%A %B %d感到很陌生，下面咱们就以表格的形式总结一下SSI中较为经常使用的一些日期和时间格式。
格式 说明 实例
%% % 
%a 一周七天的缩写形式 Thu 
%A 一周七天 Thursday 
%b 月的缩写形式 Apr 
%B 月 April 
%d 一个月内的第几天 13 
%D mm/dd/yy日期格式 04/13/00 
%H 小时（24小时制，从00到23） 01 
%I 小时（12小时制，从00到11） 01 
%j 一年内的第几天，从01到365 104 
%m 一年内的第几个月，从01到12 04 
%M 一小时内的第几分钟，从00到59 10 
%p AM或PM AM 
%r 12小时制的当地时间，格式为 01:10:18 AM 
%I:%M:%S AM | PM 
%S 一分钟内的第几秒，从00到59 18 
%T 24小时制的%H:%M:%S时间格式 01:10:18 
%U 一年内的第几个星期，从00到 15 
52，以星期天做为每一个星期的 
第一天
%w 一星期内的第一天，从0到6 4 
%W 一年内的第几个星期，从00 15 
到53，以星期一做为每一个星期 
的第一天 
%y 年的缩写形式，从00到99 00 
%Y 用四位数字表示一年 2000 
%Z 时区名称 MDT
Sizefmt：决定文件大小是以字节、千字节仍是兆字节为单位表示。若是以字节为单位，参数值为“bytes”；对于千字节和兆字节可使用缩写形式。一样，sizefmt参数必须放在fsize命令的前面才能使用.
<!--#config sizefmt="bytes" -->
<!--#fsize file="index.html" -->

2.Include命令
Include命令能够把其它文档中的文字或图片插入到当前被解析的文档中，是整个SSI的关键所在。经过Include命令只须要改动一个文件就能够瞬间更新整个站点！
Include命令具备两个不一样的参数，若是使用错误的参数更新站点的话，不只达不到初衷，反而会获得一大堆的错误信息。
Virtual：给出到服务器端某个文档的虚拟路径。例如：
<!--#include virtual="/includes/header.html" -->
为了更加合理的组织站点的内容，用户能够在根目录下建立includes子目录来存放全部的包含文件。Virtual参数能够通知服务器所要包含的是一个虚拟文件，即文件和当前被解析的文档不是位于同一个目录，而是存放在其它目录中。服务器会根据该参数的值找到根目录下的includes子目录。使用这种方法，用户能够把全部HTML文档包含的文件放在一个目录中，而根据相互之间的关系把不一样的页面保存在不一样的目录或子目录中。不管服务器解析哪个文档均可以找到所包含的文件，不会产生任何错误。
不过这里有一个小问题须要解决。通常咱们都会在页面中加入一些TITLE和META标签，若是咱们规定全部的页面都调用相同的页眉文件的话，就显得很不灵活。用户碰到这样的问题时，可使用两个包含文件，一个设置TITLE标签前的内容，另外一个设置META标签后的部分，而在两个包含文件之间则能够添加任何定制内容。例如：
<!--#include virtual="/includes/header1.html" --> 
<TITLE>Your Page Title</TITLE> 
<LINK rel = STYLESHEET href = "http://domain.com/styles/my.css" Type = "text/css" > 
<META NAME = "Description" CONTENT = " Description of page"> 
<META NAME = "Keywords" CONTENT = "keywords for page" > 
<!--#include virtual="/includes/header2.html" -->
这里放置页面内容
<!--#include virtual="/includes/footer.html" -->
从上咱们能够看出经过在页面中包含页眉和页脚能够大大减小站点更新的工做量。可是若是咱们但愿动态显示一些内容，例如页面的最后更新时间等该怎么办呢？没问题，咱们能够把包含文件使用.html后缀保存，这样就能够在包含文件中调用其它的包含文件。
File：给出到当前目录的相对路径，其中不能使用“../”，也不能使用绝对路径。例如：
<!--#include file="header.html" -->
这就要求每个目录中都包含一个header.html文件。固然，采用这样的方法并不比更新每个页面简单多少，可是若是用户只更新1、两个文件的话仍是很方便的。例如，若是咱们不但愿让一个对HTML不熟悉的人直接改动网站中的新闻页面的话，能够只让他更新一个单独的文本文件，而后再把该文件包含到HMTL文档中，这样即不会破坏原页面，同时又更新了内容，一箭双鵰
3.Echo:
Echo命令能够显示如下各环境变量：
DOCUMENT_NAME：显示当前文档的名称。
<!--#echo var="DOCUMENT_NAME" -->
显示结果为：
index.html
DOCUMENT_URI：显示当前文档的虚拟路径。例如：
<!--#echo var="DOCUMENT_URI" -->
显示结果为：
/YourDirectory/YourFilename.html
随着网站的不断发展，那些愈来愈长的URL地址确定会让人头疼。若是使用SSI，一切就会迎刃而解。由于咱们能够把网站的域名和SSI命令结合在一块儿显示完整的URL，即：
http://YourDomain<!--#echo var="DOCUMENT_URI" -->
QUERY_STRING_UNESCAPED：显示未经转义处理的由客户端发送的查询字串，其中全部的特殊字符前面都有转义符“\”。例如：
<!--#echo var="QUERY_STRING_UNESCAPED" -->
DATE_LOCAL：显示服务器设定时区的日期和时间。用户能够结合config命令的timefmt参数，定制输出信息。例如：
<!--#config timefmt="%A, the %d of %B, in the year %Y" --> 
<!--#echo var="DATE_LOCAL" -->
显示结果为：
Saturday, the 15 of April, in the year 2000
DATE_GMT：功能与DATE_LOCAL同样，只不过返回的是以格林尼治标准时间为基准的日期。例如：
<!--#echo var="DATE_GMT" -->
LAST_MODIFIED：显示当前文档的最后更新时间。一样，这是SSI中很是实用的一个功能，只要在HTML文档中加入如下这行简单的文字，就能够在页面上动态的显示更新时间。
<!--#echo var="LAST_MODIFIED" -->
CGI环境变量
除了SSI环境变量以外，echo命令还能够显示如下CGI环境变量：
SERVER_SOFTWARE：显示服务器软件的名称和版本。例如：
<!--#echo var="SERVER_SOFTWARE" -->
SERVER_NAME： 显示服务器的主机名称，DNS别名或IP地址。例如：
<!--#echo var="SERVER_NAME" -->
SERVER_PROTOCOL：显示客户端请求所使用的协议名称和版本，如HTTP/1.0。例如：
<!--#echo var="SERVER_PROTOCOL" -->
SERVER_PORT：显示服务器的响应端口。例如：
<!--#echo var="SERVER_PORT" -->
REQUEST_METHOD：显示客户端的文档请求方法，包括GET, HEAD, 和POST。例如：
<!--#echo var="REQUEST_METHOD" -->
REMOTE_HOST：显示发出请求信息的客户端主机名称。
<!--#echo var="REMOTE_HOST" -->
REMOTE_ADDR：显示发出请求信息的客户端IP地址。
<!--#echo var="REMOTE_ADDR" -->
AUTH_TYPE：显示用户身份的验证方法。
<!--#echo var="AUTH_TYPE" -->
REMOTE_USER：显示访问受保护页面的用户所使用的账号名称。
<!--#echo var="REMOTE_USER" -->
4.Fsize：显示指定文件的大小，能够结合config命令的sizefmt参数定制输出格式。
<!--#fsize file="index_working.html" -->
5.Flastmod：显示指定文件的最后修改日期，能够结合config 命令的timefmt参数控制输出格式。
<!--#config timefmt="%A, the %d of %B, in the year %Y" --> 
<!--#flastmod file="file.html" -->
这里，咱们能够利用flastmod参数显示出一个页面上全部连接页面的更新日期。方法以下：
<!--#config timefmt=" %B %d, %Y" --> 
<A HREF="/directory/file.html">File</A> 
<!--#flastmod virtual="/directory/file.html" --> 
<A HREF="/another_directory/another_file.html">Another File</A> 
<!--#flastmod virtual="/another_directory/another_file.html" -->
显示结果为：
File April 19, 2000 
Another File January 08, 2000
也许有的读者会认为两个连接就这么复杂，一点也不方便。其实，若是页面上有20个或者更多的连接，并且每一个连接都按期更新的话，就能够看出使用flastmod显示修改日期的做用。
6.Exec
Exec命令能够执行CGI脚本或者shell命令。使用方法以下：
Cmd：使用/bin/sh执行指定的字串。若是SSI使用了IncludesNOEXEC选项，则该命令将被屏蔽。
Cgi：能够用来执行CGI脚本。例如，下面这个例子中使用服务端cgi-bin目录下的counter.pl脚本程序在每一个页面放置一个计数器：
<!--#exec cgi="/cgi-bin/counter.pl"-->