summaryrefslogtreecommitdiff
path: root/doc/ssi.txt
blob: c65e7e17e36e8fe3ee4bd788d42d6ab2d915b7bd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
====================
Server-Side Includes
====================

---------------
Module: mod_ssi
---------------

:Author: Jan Kneschke
:Date: $Date: 2004/08/29 09:44:53 $
:Revision: $Revision: 1.2 $

:abstract:
  The module for server-side includes provides a compatability
  layer for NSCA/Apache SSI.

.. meta::
  :keywords: lighttpd, ssi, Server-Side Includes

.. contents:: Table of Contents

Description
===========

Configuration
-------------

::

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

Supported Options
-----------------

- ``<!--#echo var="..." -->``
- ``<!--#include (file="..."\|virtual="...") -->``
- ``<!--#flastmod (file="..."\|virtual="...") -->``
- ``<!--#fsize (file="..."\|virtual="...") -->``
- ``<!--#config timefmt="..." sizefmt="(bytes|abbrev)" -->``
- ``<!--#printenv -->``
- ``<!--#set var="..." value="..." -->``
- ``<!--#if expr="..." -->``
- ``<!--#elif expr="..." -->``
- ``<!--#else -->``
- ``<!--#endif -->``

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:

- exec
- nested virtual
- config.errmsg
- echo.encoding