NAME¶
CGI::SSI_Parser - Implement SSI for Perl CGI
SYNOPSIS¶
use CGI::SSI_Parser;
$CGI::SSI_Parser::recursive = 1;
fssi($filename);
sssi($string);
DESCRIPTION¶
CGI::SSI_Parser is used in CGI scripts for parsing SSI directives in files or
string variables, and fully implements the functionality of apache's
mod_include module.
It is an alternative to famous Apache::SSI modules, but it doesn't require
mod_perl. This is an advantage to those who are using public hosting services.
There is a disadvantage, however - the module consumes much memory, and I
don't recommend using it on heavy-loaded sites (currently it's being used on a
site with 10000 hits, and I consider this as a limit). I hope to get rid of
this disadvantage by the time the release comes out (currently it's beta).
SSI Directives
This module supports the same directives as mod_include. For methods listed
below but not documented, please see mod_include's online documentation at
http://httpd.apache.org/docs/mod/mod_include.html .
- • config
- • echo
- This directive is not fully supported in current version.
- • exec
- • fsize
- • flastmod
- • include
- • printenv
- • set
- This directive is not supported in current version.
- • perl
- This directive is not supported in current version.
- • if
- • elif
- • else
- • endif
- These four directives are not supported in current version.
Outline Usage
First you need to load the CGI::SSI_Parser module:
use CGI::SSI_Parser;
You need to specify the following when processing of all nested directives is
needed (default value - 0):
$CGI::SSI_Parser::recursive = 1;
To parse file or string you need to use:
fssi($filename);
sssi($string);
The result is printed to STDOUT.
TO DO¶
Full implementation of all SSI directives.
Optimize memory consumption.
AUTHOR¶
Vadim Y. Ponomarenko, vp@istc.kiev.ua
SEE ALSO¶
mod_include,
perl(1).