4.8.1 SPML - 包含文件格式
这种文件被当作 HTML 文件剖析,并如同 SGML 的注解嵌入(embedded)
特殊的指令。指令一般的语法是:
这里的值常包括在双引号里;许多指令只允许单一个属性-值的配对。
允许使用的项目是:
config
这个指令控制各种剖析的方式。有效的属性是:
errmsg
此值是如果剖析文件发生错误时送回客户端的讯息。
sizefmt
此值是设定显示文件大小使用的格式。有效的值是使用
位元组计算的 bytes 或是以 Kb 或 Mb 中合适者显示
的 abbrev 。
timefmt
此值是列印日期时由 strftime(3) 程序库函式使用的
字串。
echo
这个指令列印内涵的参数其中之一,定义如下。如果该参数未被
设定则印出(none)。印出的任何日期都依从目前配置的 timefmt
。属性:
var
此值是要印出之参数的名称。
exec
此指令执行所给 shell 指令或 CGI 指令稿。InculdesNOEXEC
这个选项可以完全关闭这个指令。有效的属性是:
cgi
此值指定 (%-encode)URL 到 CGI 指令稿的相对路径
。如果该路径没有以(/) 作为开始,那麽它就是相对於
目前的文件。这个路径所参照的文件会被当作是个 CGI
指令稿起动,即使服务器并不认为它是个 CGI 指令稿
。然而,包含该指令稿的目录必须打开 CGI 指令稿的
支援(以 ScriptAlias 或 ExecCGI 选项打开)。
从客户端来的请求给予此指令稿 PATH_INFO 以及查询
字串(QUERY_STRING);但这无法在 URL 路径中指定。
所以在标准的 CGI 环境参数之外指令稿可以从内含的
参数取得这些资讯。
如果该指令稿回传 Location: 标头而不是一般的输出
,那麽这将会被转换成 HTML 的链结。
include virtual 这个项目应该用来参照 exec cgi 。
cmd
服务器将会以 /bin/sh 执行所给的字串。这个指令可
以取得内含的参数。
fsize
这个指令印出指定文件的大小,并依从 sizefmt 的格式指定。
属性:
file
此值是包含要剖析之文件的目录之相对路径。
virtual
此值是相对於要剖析之文件的 (%-encoded) URL 路径
。如果该路径没有以(/) 作为开始,那麽它就是相对於
目前的文件。
flastmod
这个指令印出指定文件最後修改的日期,依从 timefmt 的格式