+ + +SSI commands have the following generic format: + + + + + + +The following commands are supported: + + +block + +Defines a block that can be used as a stub +in the include command. +The block can contain other SSI commands. +The command has the following parameter: + + +name + +block name. + + + +Example: + + +stub + + + + + + +config + +Sets some parameters used during SSI processing, namely: + + +errmsg + +a string that is output if an error occurs during SSI processing. +By default, the following string is output: + +[an error occurred while processing the directive] + + + +timefmt + +a format string passed to the strftime function +used to output date and time. +By default, the following format is used: + +"%A, %d-%b-%Y %H:%M:%S %Z" + +The “%s” format is suitable to output time in seconds. + + + + + + +echo + +Outputs the value of a variable. +The command has the following parameters: + + +var + +variable name. + + +encoding + +encoding method. +Possible values include none, url, and +entity. +By default, entity is used. + + +default + +non-standard parameter that sets a string to be output +if a variable is undefined. +By default, “none” is output. +The command + + + +replaces the following sequence of commands: + +no + + + + + + + +if + +Performs a conditional inclusion. +The following commands are supported: + + +... + +... + +... + + +Only one level of nesting is currently supported. +The command has the following parameter: + + +expr + +expression. +An expression can be: + + + + +variable existence check: + + + + + + +comparison of a variable with a text: + + + + + + + +comparison of a variable with a regular expression: + + + + + + + +If a text contains variables, +their values are substituted. +A regular expression can contain positional and named captures +that can later be used through variables, for example: + + +  +  + + + + + + + + +include + +Includes the result of another request into a response. +The command has the following parameters: + + +file + +specifies an included file, for example: + + + + + +virtual + +specifies an included request, for example: + + + +Several requests specified on one page and processed by proxied or +FastCGI servers run in parallel. +If sequential processing is desired, the wait +parameter should be used. + + +stub + +non-standard parameter that names the block whose +content will be output if an included request results in an empty +body or if an error occurs during request processing, for example: + +  + + +The replacement block content is processed in the included request context. + + +wait + +non-standard parameter that instructs to wait for a request to fully +complete before continuing with SSI processing, for example: + + + + + +set + +non-standard parameter that instructs to write a successful result +of request processing to the specified variable, +for example: + + + +It should be noted that only the results of responses obtained using the +ngx_http_proxy_module and +ngx_http_memcached_module +modules can be written into variables. + + + + + + + +set + +Sets a value of a variable. +The command has the following parameters: + + +var + +variable name. + + +value + +variable value. +If an assigned value contains variables, +their values are substituted. + + + + + + + + +