Kwiki::ModPerl(3)

💖 Kwiki::ModPerl 💖

okay bestie, welcome to the Kwiki::ModPerl(3) page, part of the User Contributed Perl Documentation collection ✨ — yes it's a real manpage, yes it's about making Kwiki live inside mod_perl, and yes we're gonna make it make sense 🫶

---

🌸 NAME 🌸

Kwiki::ModPerl — the glow-up that lets Kwiki run under mod_perl 💅

---

✨ SYNOPSIS ✨

Start by making a brand new Kwiki, like so:

$ kwiki -new /path/to/webroot/kwiki

Then, bestie, you go tell Apache what's up:

<Location /kwiki>
  SetHandler  perl-script
  PerlSetVar  KwikiBaseDir /path/to/webroot/kwiki
  PerlHandler +Kwiki::ModPerl
</Location>

Got a custom lib directory for your Kwiki? Then you also need this:

<Perl>
  use lib '/path/to/webroot/kwiki/lib';
</Perl>

And ooh, if you're running mod_perl2, pls pls pls add this one line into your httpd.conf:

PerlModule Apache2

---

👑 DESCRIPTION 👑

This module is literally just here so you can use Kwiki as a mod_perl content handler. That's the whole vibe. No cap. 💖

---

🦋 FEATURES, BUGS and NOTES 🦋

• Sub-view are supported automatically 🌈

You do not need any extra apache configuration for this. It just works. Iconic behaviour fr fr.

• Multiple Kwikis are supported. 🎀

As long as each Kwiki has its own KwikiBaseDir, you're golden. Periodt.

• You might need a redirect for the Kwiki base directory. 🙈

For example, if your Kwiki is at the location "/kwiki/" and you browse to "/kwiki" (without the trailing slash), you'll definitely experience some weirdness. I highly suggest adding a redirect:

RedirectMatch ^/kwiki$ http://example.com/kwiki/

• Why index.cgi still shows up in the URL ? 😭

Don't worry, it's ignored internally, so that it is still handled under mod_perl, not as a cgi script. Also, It can make all browser happy with relative URI redirection. (Although it shouldn't be a relative redirection, should be fixed in Kwiki base in the future).

• You might need to restart Apache. 💀

Otherwise module additions and removal might not be working. Yeah. Just restart it, bestie.

---

💜 AUTHORS 💜

Ian Langworth <langworth.com> 💖

Now Maintained by Kang-min Liu <gugod@gugod.org> ✨

---

🌈 SEE ALSO 🌈

Kwiki — go look at that one too, iykyk 🧚

---

🍓 COPYRIGHT AND LICENSE 🍓

Copyright (C) 2004 by Ian Langworth Copyright (C) 2005 by Kang-min Liu

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. Slay, honestly. 💅

---

and that's a wrap, bestie!! this page came to you from perl v5.42.0, dated 2025-07-25, and it is Kwiki::ModPerl(3) — go forth and mod_perl responsibly 🫶✨🌸