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 77 78 79 80 81 82
|
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).
|