| iMatix home page | Xitami home page | << | < | > | >> | Xitami Version 2.5b6

## 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.

| << | < | > | >> | Welcome To Xitami | Table Of Contents | Installing Xitami | Administration | Configuration | Using The Common Gateway Interface (CGI) | Server-Side Includes (SSI) | Using Filters | Server-Side XML Processing | Server-Side GSL Scripting | Image Maps | Virtual Hosts | The FTP Service | The Dynamic DNS Feature | Throttle Pipes | A Beginner's Guide | Writing Web Server Extension (WSX) Agents | Extending Xitami with External Peer Processes | FAQ | Getting Support | Credits | Release History | License Agreement | Copyright © 1996-2002 iMatix Corporation