Mod ssi » History » Revision 15

« Previous | Revision 15/28 (diff) | Next »
stbuehler, 2009-02-17 10:48

Module mod_ssi - Server-Side Includes


SSI is a very old and cheap way to generate content dynamically on server-side.

The use of this module is strongly discouraged:
  • the execution of a SSI script is done in the server-core
  • a long-running SSI script blocks the handling of ALL connections
  • as soon as you use #exec the performance gets worse than using CGI scripts directly
You should only use SSI for two reason:
  • content assembling with #include
  • legacy applications


You have to load the mod_ssi module and set the ssi-extension:

server.modules = ( ..., "mod_ssi", ... )
ssi.extension = ( ".shtml" )

Supported Options

Expression Handling

Every "expr" is interpreted:
  • logical: AND, OR, !
  • compare: =, <, <=, >, =>, !=
  • precedence: (, )
  • quoted strings: 'string with a dollar: $FOO'
  • variable substitution: $REMOTE_ADDR
  • unquoted strings: string

Flow Control

if, elif, else and endif can only be used to insert content under special conditions.

Unsupported Features

The original SSI module from NCSA and Apache provided some more options which are not supported by this module for various reasons:

Updated by stbuehler over 14 years ago · 15 revisions