编辑“CMSwareSHTML 教程”（章节）

==SSI指令使用详解==
*'''echo 示范'''
:作用：将环境变量插入到页面中。

:语法：
<pre>
<!--#echo var="变量名称"-->
</pre>
示例：
<pre>
<!--#echo var="DOCUMENT_NAME"--> 本文档名称
<!--#echo var="DATE_LOCAL"--> 现在时间
<!--#echo var="REMOTE_ADDR"--> 你的IP地址
</pre>

*'''include 示范'''
作用：将文本文件的内容直接插入到文档页面中。

语法：
<pre>
<!--#include file="文件名称"-->
<!--#include virtual="文件名称"-->
</pre>
file 文件名是一个相对路径，该路径相对于使用 <nowiki>#include </nowiki>指令的文档所在的目录。被包含文件可以在同一级目录或其子目录中，但不能在上一级目录中。如表示当前目录下的的nav_head.htm文档，则为 file="nav_head.htm"。

virtual 文件名是 Web 站点上的虚拟目录的完整路径。如表示相对于服务器文档根目录下hoyi目录下的nav_head.htm文件；则为file="/hoyi /nav_head.htm"

参数：
:file 指定包含文件相对于本文档的位置
:virtual 指定相对于服务器文档根目录的位置

注意：

:文件名称必须带有扩展名。
:被包含的文件可以具有任何文件扩展名，我觉得直接使用htm扩展名最方便，微软公司推荐使用 .inc 扩展名（这就看你的爱好了）。

示例：
<pre>
<!--#include file="nav_head.htm"--> 将头文件插入到当前页面
<!--#include file="nav_foot.htm"--> 将尾文件插入到当前页面
</pre>

*'''flastmod 和 #fsize 示范'''

作用：
:<nowiki>#flastmod </nowiki>文件最近更新日期
:<nowiki>#fsize </nowiki>文件的长度

语法：
<pre>
<!--#flastmod file="文件名称"-->
<!--#fsize file="文件名称"-->
</pre>

参数：
:file 指定包含文件相对于本文档的位置 如 info.txt 表示当前目录下的的info.txt文档
:virtual 指定相对于服务器文档根目录的位置 如 /hoyi/info.txt 表示

注意：文件名称必须带有扩展名。

示例：
<pre>
<!--#flastmod file="news.htm"--> 将当前目录下news.htm文件的最近更新日期插插入到当前页面
<!--#fsize file="news.htm"--> 将当前目录下news.htm的文件大小入到当前页面
</pre>

*'''exec 示范'''

作用：将某一外部程序的输出插入到页面中。可插入CGI程序或者是常规应用程序的输入，这取决于使用的参数是cmd还是cgi。

语法：
<pre>
<!--#exec cmd="文件名称"-->
<!--#exec cgi="文件名称"-->
</pre>

参数：
:cmd 常规应用程序
:cgi [[CGI]]脚本程序

示例：
<pre>
<!--#exec cmd="cat /etc/passwd"--> 将会显示密码文件
<!--#exec cmd="dir /b"--> 将会显示当前目录下文件列表
<!--#exec cgi="/cgi-bin/gb.cgi"--> 将会执行CGI程序gb.cgi。
<!--#exec cgi="/cgi-bin/access_log.cgi"--> 将会执行CGI程序access_log.cgi。
</pre>
注意：从上面的示例可以看出，这个指令相当方便，但是也存在安全问题。

禁止方法：
:Apache，将access.conf中的"Options Includes ExecCGI"这行代码删除；
:在IIS中，要禁用 #exec 命令，可修改 SSIExecDisable 元[[数据库]]；

*'''config'''

作用： 指定返回给客户端浏览器的错误信息、日期和文件大小的格式。

语法：
<pre>
<!--#config errmsg="自定义错误信息"-->
<!--#config sizefmt="显示单位"-->
<!--#config timefmt="显示格式"-->
</pre>

参数：
:errmsg 自定义SSI执行错误信息，可以为任何你喜欢的方式。
:sizefmt 文件大小显示方式，默认为字节方式("bytes")可以改为千字节方式("abbrev")
:timefmt 时间显示方式，最灵活的配置属性。

示例：显示一个不存在文件的大小
<pre>
<!--#config errmsg="服务器执行错误，请联系管理员 yiho@126.com，谢谢！"-->
<!--#fsize file="不存在的文件.htm"-->
</pre>
以千字节方式显示文件大小

语法：
<pre>
<!--#config sizefmt="abbrev"-->
<!--#fsizefile="news.htm"-->
</pre>
以特定的时间格式显示时间
<pre>
<!--#config timefmt="%Y年/%m月%d日 星期%W 北京时间%H:%M:%s，%Y年已过去了%j天 今天是%Y年的第%U个星期"-->
<!--#echo var="DATE_LOCAL"--> 显示今天是星期几，几月，时区
<!--#config timefmt="今天%A， %B ，服务器时区是 %z，是"-->
<!--#echo var="DATE_LOCAL"-->
</pre>
说明	输入内容	输出结果
斜体	''斜体文字''	斜体文字
粗体	'''粗体文字'''	粗体文字
粗斜体	'''''粗斜体文字'''''	*粗斜体文字*