Server Side Includes (SSI) allows the insertion of dynamic data into .html documents.
Since parsing SSI is CPU intensive, only specially marked files are processed in order to not sacrifice performance.Only files ending with .shtml are processed for SSI directives
The following commands are support under our implementation:
#config
Configures the SSI environment. The environment is reset for each SSI document. You can configure the error message, the size format and the time format.
#echo
Inserts the value of a variable. Supported environment variables include:
DOCUMENT_NAME
DOCUMENT_URI
QUERY_STRING_UNESCAPED
DATE_LOCAL
DATE_GMT
LAST_MODIFIED
SERVER_SOFTWARE
SERVER_NAME
GATEWAY_INTERFACE
SERVER_PROTOCOL
SERVER_PORT
REQUEST_METHOD
PATH_INFO
PATH_TRANSLATED
SCRIPT_NAME
QUERY_STRING
REMOTE_HOST
REMOTE_ADDR
AUTH_TYPE
REMOTE_USER
REMOTE_IDENT
CONTENT_TYPE
CONTENT_LENGTH
For example, the following line will insert the current time and date:
<!--#echo var="DATE_LOCAL"-->
#exec
Executes a program and inserts its output into the document. Use the cgi keyword for URL-based scripts and the cmd keyword for system commands. The SSI #exec method uses Standard CGI only. This means that if you are using Perl (or any other external processor), only the Standard CGI configured extension will work. this means that if you process .pl with Perl ISAPI, it will not work under SSI. Example usage:
<!--#exec cgi="/cgi-bin/hello.pl"-->
[insecure]
#flastmod
Returns the date of the last modification to the specified file. Use the virtual keyword for URL-based files and the file keyword for path based files. Example usage:
<!--#flastmod virtual="stuff/extra.txt"-->
<!--#flastmod file="c:\mystuff\extra.txt"-->
[insecure]
#fsize
Inserts the size of a file. Use the virtual keyword for URL-based files and the file keyword for path based files. Example usage:
<!--#fsize virtual="stuff/extra.txt"-->
<!--#include file="d:\website\yourdomaincom\mystuff\extra.txt"-->
#include
Inserts a file into the document. You may nest documents up to 8 layers. Use the virtual keyword for URL-based includes and the file keyword for path based includes. Example usage:
<!--#include virtual="stuff/extra.txt"-->
<!--#include file="d:\website\yourdomaincom\mystuff\extra.txt"-->
Now, we shall create a SSI-driven page! Open Notepad and copy-paste the following information:
<font size="1"><b>This page is basic html
<a href="http://www.batchelors.net/hosting/support/ssi.html">Click
here</a> to the SSI help page<b></font>
Save the file as ssi.htm. Click here to view ssi.htm
Now open a new document and copy-paste the following code:
<HTML>
<HEAD>
<TITLE>Test SSI-Page</TITLE>
</HEAD>
<BODY>
<!--#include file="ssi.htm" -->
</BODY>
</HTML>
Save that file as ssi-test.shtml.
Upload both files to your Web Server and preview them in your browser and test.