SSI Commands (Web Design in a Nutshell, 2nd Edition)

home | O'Reilly's CD bookshelfs | FreeBSD | Linux | Cisco | Cisco Exam

Book Home

18.6. SSI Commands

The following section describes the primary Server Side Includes and their respective attributes.

config

config errmsg|sizefmt|timefmt="string"

Controls various aspects of SSI.

Attributes

errmsg: Defines the default message sent if an error occurs while parsing the document.

sizefmt: Sets the format to be used when displaying the size of the file. Valid values are bytes or abbrev, which rounds the size up to the nearest kilobyte.

timefmt: Sets the format for dates and times. The full range of formats and examples are provided in Section 18.8, "Time Formats for SSI Output".

Example

<!-- #config errmsg="Error: File not found" -->
<!-- #config sizefmt="abbrev" -->

echo

echo var="environment or set variable"

Prints (displays in the document) the value of the variable. For an list of available variables, see Section 18.7, "Include Variables" later in this chapter.

Attributes

var: The value is the name of the variable to print.

Example

<! -- #echo var="DATE_GMT"  -- >

exec

exec cmd|cgi="string"

Executes an external program and inserts the output in the current document.

Attributes

cgi: Provides the relative URL path to the CGI script.

cmd: Specifies any shell program on the server. The SSI variables are available to the command.

Example

You are visitor number <! -- #exec cgi="/cgi-bin/counter.pl"  -- >
<!--#exec cmd="/bin/finger $REMOTE_USER@$REMOTE_HOST" -->

fsize

fsize file|virtual="path"

Inserts the file size of a specified file. The size follows the sizefmt format configuration.

Attributes

file: Specifies the location of the file as a pathname relative to the directory of the document being parsed. This attribute is not recommended for use (it is there for backwards compatibility with old NCSA scripts).

virtual: Specifies the URL path relative to the current document being parsed. If it does not begin with a slash ( / ) it is taken to be relative to the current document.

Example

The size of this file is <!--#fsize file="thisfile.html" -->

flastmod file|virtual="path"

Inserts the last modification date of a specified file. The date follows the timefmt format configuration.

Attributes

file: Specifies the location of the file as a pathname relative to the directory of the document being parsed. This attribute is not recommended for use (it is there for backwards compatibility with old NCSA scripts).

virtual: Specifies the URL path relative to the current document being parsed. The URL cannot contain a scheme or hostname, only a path (and optional query string). If it does not begin with a slash ( / ), it is taken to be relative to the current document.

Example

That file was last modified on
 <!--#flastmod virtual="/mydocs/thatfile.html" -->

include file|virtual ="path"

Inserts the contents of another document or file into the parsed file.

Attributes

file: Specifies a path relative to the directory of the parsed file (i.e., it cannot include ../ nor can it be an absolute path). The virtual attribute should always be used in preference to this one. This attribute is not recommended for use (it is there for backwards compatibility with old NCSA scripts).

virtual: Specifies a URL relative to the document being parsed. The URL cannot contain a scheme or hostname. If it does not begin with a slash ( / ), it is taken to be relative to the current document.

printenv

Prints out a listing of all existing variables and their values.

Example

<! -- #printenv  -- >

set

set

Sets the value of a variable.

Attributes

var: The name of the variable to be set.

value: The value given to the variable.

Example

<!--#set var="password" value="mustard" -->

Library Navigation Links

Copyright © 2002 O'Reilly & Associates. All rights reserved.