SSI_Parser(3pm)

✨ NAME ✨

Okay bestie, welcome to a User Contributed Perl Documentation page 💖 — this one's called SSI_Parser, and it's all about CGI::SSI_Parser, which implements SSI for Perl CGI. That's the whole vibe. No cap.

---

🦋 SYNOPSIS 🦋

Here's the whole thing at a glance, copy-paste ready, exactly as written:

use CGI::SSI_Parser;

$CGI::SSI_Parser::recursive = 1;

fssi($filename);
sssi($string);

---

💜 DESCRIPTION 💜

So CGI::SSI_Parser is the module you reach for inside CGI scripts when you wanna parse SSI directives — whether they're chillin' in files or just vibing inside string variables. And it fully implements the functionality of apache's mod_include module. Like, full send. 💅

It's an alternative to the famous Apache::SSI modules, except — plot twist — it doesn't require mod_perl. That's the glow-up for anyone stuck on public hosting services. 👑

But bestie, we gotta talk about the downside 😭 — this module consumes much memory, and the author straight up says he doesn't recommend using it on heavy-loaded sites. Currently it's being used on a site with 10000 hits, and he considers that the limit. He hopes to get rid of this disadvantage by the time the release comes out (right now it's beta, so, y'know).

🌸 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 — go read it, iykyk.

• config — supported, go off ✨
• echo — this directive is not fully supported in current version 🙈
• exec — supported
• fsize — supported
• flastmod — supported
• include — supported
• printenv — supported
• set — this directive is not supported in current version 💀
• perl — this directive is not supported in current version 💀
• if — see the note below 👇
• elif — see the note below 👇
• else — see the note below 👇
• endif — see the note below 👇

These four directives — if, elif, else, endif — are not supported in current version. Don't come for me, that's just what the page says 🫶

🎀 Outline Usage 🎀

Step one, babe — load the CGI::SSI_Parser module:

use CGI::SSI_Parser;

Step two: if you need processing of all nested directives, you gotta specify this (and the default value is 0, so it's off unless you say otherwise):

$CGI::SSI_Parser::recursive = 1;

Step three: to parse a file or a string, you use:

fssi($filename);
sssi($string);

And the result? It gets printed to STDOUT. That's it, that's the whole ritual. 🌈

---

🔥 TO DO 🔥

The author's manifesting list, fr fr:

• Full implementation of all SSI directives.
• Optimize memory consumption.

---

👑 AUTHOR 👑

Vadim Y. Ponomarenko, vp@istc.kiev.ua — give him his flowers 💐

---

🌈 SEE ALSO 🌈

• mod_include
• perl(1)

---

And that's a wrap, bestie 🎀 This page came to you courtesy of perl v5.32.1, dated 2022-01-08, from the User Contributed Perl Documentation collection. Stan a well-documented module. Periodt. 💖✨🦋