block

定义一个可在 include 命令中用作存根的块。该块可以包含其他 SSI 命令。该命令有以下参数：

• name

  块名称

  示例：

  <!--# block name="one" -->
  stub
  <!--# endblock -->

config

设置SSI处理期间使用的一些参数，即：

• errmsg

  在 SSI 处理期间发生错误时输出的字符串。默认输出以下字符串：

    [an error occurred while processing the directive]

• timefmt

  传递给 strftime() 函数的格式化字符串，用于输出日期和时间。默认为以下格式：

    "%A, %d-%b-%Y %H:%M:%S %Z"

  ％s 格式适合以秒为单位输出时间。

echo

输出一个变量的值。该命令有以下参数：

• var

  变量名

• encoding

  编码方式。可能的值包括 none、url 和 entity。默认使用 entity。

• default

  一个非标准参数，如果变量未定义，则输出设置的默认字符串。默认情况下，输出 (none)。

    <!--# echo var="name" default="no" -->

  以上命令将替换成以下命令序列：

    <!--# if expr="$name" --><!--# echo var="name" --><!--#
    else -->no<!--# endif -->

if

执行条件包含。支持以下命令：

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

目前仅支持一级嵌套。该命令有以下参数：

• expr

  表达式。一个表达式可以是：

  • 变量存在检查：

      <!--# if expr="$name" -->

  • 变量与文本比较：

      <!--# if expr="$name = text" -->
      <!--# if expr="$name != text" -->

  • 变量与正则表达式比较：

      <!--# if expr="$name = /text/" -->
      <!--# if expr="$name != /text/" -->

    如果一个 text 包含变量，则替换它们的值。一个正则表达式可以包含位置和命名捕获，之后可通过变量引用使用，例如：

    <!--# if expr="$name = /(.+)@(?P<domain>.+)/" -->
      <!--# echo var="1" -->
      <!--# echo var="domain" -->
    <!--# endif -->