Webmaster in a Nutshell

Previous Chapter 13 Next
 

13. Server Side Includes

Contents:
Configuring the Apache and NCSA Servers for SSI
Faking SSI for the CERN Server
Basic SSI Directives
SSI Environment Variables
Configurable Time Formats for SSI Output

Server Side Includes (SSI) are directives you can place into an HTML document to execute other programs or to output data, such as file statistics or the contents of environment variables. SSI directives can save you the trouble of writing complete CGI programs to output documents containing a small amount of dynamic information. While Server Side Includes technically are not CGI, they can become an important tool for incorporating CGI-like information as well as output from CGI programs.

Keep in mind, however, that not all servers support these directives; in particular, the CERN server cannot handle SSI without some modification to the server's configuration, although the Apache, NCSA, Netscape, and WebSite servers can.

When a client requests a document from an SSI-enabled server, and the document is coded appropriately, the server parses the specified document looking for SSI directives. We've already considered the advantages to this system; there are also a couple of liabilities. First, parsing documents before sending them to the client represents additional server overhead. And second, enabling SSI creates a security risk. For example, an unwise user might embed directives to execute system commands that output confidential information. So, SSI can be very handy, but it must be used efficiently and cautiously.

The current chapter summarizes the Server Side Includes. There aren't many, but they perform some of the most basic CGI-like operations, and can spare you quite a bit of coding.

13.1 Configuring the Apache and NCSA Servers for SSI

In order to tell the NCSA and Apache servers which files to parse, you must modify two server configuration files, srm.conf and access.conf, as follows:

  1. In the server configuration file, srm.conf, specify the extension(s) of the files the server should parse. For example, the following line specifies that the server will parse all files that end in the suffix .shtml:

    AddType text/x-server-parsed-html .shtml
    

    Alternatively, specifying the suffix .html would make the server parse all HTML documents; however, keep in mind that parsing every HTML file could present a noticeable server drain.

  2. In the access configuration file, access.conf, specify the type of SSI directives you can place in your documents.

    • To embed SSI directives that display environment variables and file statistics, enable the Includes feature.

    • To use SSI directives that execute external programs (both CGI and system applications), enable the Exec feature.

    • To enable both features, add the following line to your access.conf file:

      Options Includes ExecGCI
      

See Chapter 13, Server Side Includes, for more information on configuring the Apache and NCSA servers.


Previous Home Next
The Cookie Request Header Book Index Faking SSI for the CERN Server

HTML: The Definitive Guide CGI Programming JavaScript: The Definitive Guide Programming Perl WebMaster in a Nutshell