Vadim Ponomarenko > CGI-SSI_Parser-0.01 > CGI::SSI_Parser

Download:
CGI-SSI_Parser-0.01.tar.gz

Dependencies

Annotate this POD

Related Modules

CGI::SSI
HTML::Template
Apache::SSI
LWP::Simple
HTML::TokeParser
CGI::Carp
CGI::Application
more...
By perlmonks.org
View/Report Bugs
Module Version: 0.01   Source  

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 .

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).

syntax highlighting: