Server-Side Includes (SSI)

| iMatix home page
| Xitami home page
| << | < | > | >>

Xitami
Version 2.5b4

Server-Side Includes (SSI)

SSI (server-side includes) is a fairly standard syntax which you can read about on the NCSA site. By default, Xitami parses any document with extension '.ssi', '.shtm', or '.shtml' as an SSI document. This is defined in the [WSX] section of the configuration files, where the SSI WSX agent is xixssi. You can add SSI support to other file types, e.g. for .html files. SSI documents are placed in the normal web pages directory, and are recognised purely by their extension, not the path.

Xitami supports these SSI tags:

Element syntax: Effect:
#config errmsg="text" Specify the SSI error message.
#config sizefmt="format" Specify whether file sizes are shown in full, or abbreviated. Use the format 'abbrev' to show abbreviated sizes.
#config timefmt="format" Specify the format used for file times. By default this is: "%A, %d-%b-%y %H:%M:%S %Z".
#echo var="variable" Output the value of the specified variable. Xitami recognises these variables: DOCUMENT_NAME, DOCUMENT_URI, DATE_GMT, DATE_LOCAL, LAST_MODIFIED, and any environment variable (including the standard CGI environment variables).
#exec cgi="pathname" Outputs the result of the CGI program, which must be in the CGI binary directory (it cannot be on a CGI alias directory). Note that the CGI program runs in the main Xitami directory.
#exec cmd="command" Executes a native command and includes the output of this command. Note that the command runs in the main Xitami directory. This SSI command - which is a potential security risk for your system - is only accepted if the ssi:exec configuration option is enabled.
#include virtual="filename" Includes the contents of the specified URI, which is assumed to be within the webpages root.
#include file="filename" Includes the contents of the specified file, which may be anywhere in the file system space.
#flastmod {virtual|file}="filename" Outputs the time that the specified file was last modified. The file can be a URI within the webpages root, or an absolute filename, depending on whether 'virtual' or 'file' is specified.
#fsize {virtual|file}="filename" Outputs the size of the specified URL or file, using the sizefmt.

Element syntax:	Effect:
#config errmsg="text"	Specify the SSI error message.
#config sizefmt="format"	Specify whether file sizes are shown in full, or abbreviated. Use the format 'abbrev' to show abbreviated sizes.
#config timefmt="format"	Specify the format used for file times. By default this is: "%A, %d-%b-%y %H:%M:%S %Z".
#echo var="variable"	Output the value of the specified variable. Xitami recognises these variables: DOCUMENT_NAME, DOCUMENT_URI, DATE_GMT, DATE_LOCAL, LAST_MODIFIED, and any environment variable (including the standard CGI environment variables).
#exec cgi="pathname"	Outputs the result of the CGI program, which must be in the CGI binary directory (it cannot be on a CGI alias directory). Note that the CGI program runs in the main Xitami directory.
#exec cmd="command"	Executes a native command and includes the output of this command. Note that the command runs in the main Xitami directory. This SSI command - which is a potential security risk for your system - is only accepted if the ssi:exec configuration option is enabled.
#include virtual="filename"	Includes the contents of the specified URI, which is assumed to be within the webpages root.
#include file="filename"	Includes the contents of the specified file, which may be anywhere in the file system space.
#flastmod {virtual\|file}="filename"	Outputs the time that the specified file was last modified. The file can be a URI within the webpages root, or an absolute filename, depending on whether 'virtual' or 'file' is specified.
#fsize {virtual\|file}="filename"	Outputs the size of the specified URL or file, using the sizefmt.