File: README

package info (click to toggle)
libcgi-ssi-parser-perl 0.01-1.2
  • links: PTS
  • area: main
  • in suites: bullseye, buster, sid, stretch
  • size: 60 kB
  • ctags: 19
  • sloc: perl: 329; makefile: 44
file content (82 lines) | stat: -rw-r--r-- 2,069 bytes parent folder | download | duplicates (2)
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).