Overview
Download
Installation
Docs
Tutorial
Credits

Page Source

Hosted by:
Convolution
 Source of template.plp
Back
  1. <(template.plp)>
  2. <: BEGIN { $title = 'Install'; } :>
  3. <: title "Installing PLP in 9 easy steps." :>

  5. <: item 'Prerequisites' :>
  6. Make sure you have Perl 5.6 or newer, and that you have an 1.3 version of Apache (tested with 1.3.12 and 1.3.24).

  8. <: item 'Deciding on mod_perl versus CGI' :>
  9. All default Apache installations allow for CGI to be used. However, CGI is very inefficient
  10. because a new process has to be started for every script execution. With mod_perl, you have
  11. a resident Perl interpreter built into Apache, which allows for speeds up to six times as fast
  12. as with CGI.<BR>
  13. mod_perl is not hard to install, as you can read in Stas Bekman's quick start guide "<a href="http://www.perl.com/pub/a/2002/03/22/modperl.html">mod_perl in 30 minutes</a>". As always, Debian users are lucky people: packages are available (read <a href="/debianmodperl.txt">these instructions</a>).<BR><BR>

  15. <: item 'Downloading and installing the PLP modules' :>
  16. Get the distribution from the <a href="/files/">files directory</a> of this site, and follow the
  17. usual installation procedures:
  18. <: code Entity "tar -zvxf PLP-versionnumber.tar.gz\ncd PLP-versionnumber\nperl Makefile.PL\nmake\nmake install"; :>
  19. Once again, Debian users are blessed with a package, which is also downloadable from the <a href=
  20. "/files/">files directory</a>.
  21. <: code Entity "dpkg -i libplp-perl_versionnumber-1_all.deb" :>

  23. <: item 'PLP with mod_perl' :>
  24. Installation with mod_perl is easy, just put these lines in your httpd.conf:
  25. <: code Entity "<Files *.plp>\n  SetHandler perl-script\n  PerlHandler PLP\n  PerlSendHeader On\n  PerlSetVar PLPcache On\n</Files>" :>
  26. And restart Apache.

  28. <: item 'PLP with CGI' :>
  29. First, create a directory for PLP. I'll use /foo/bar in examples, but something like /usr/local/lib/plp might be handier.
  30. In that directory, we put plp.cgi that is in the distribution (if you didn't use the tar.gz, you can find the script using "man PLP". Don't be alarmed, it's only three lines), and we make it executable.
  31. <: code Entity "mkdir -p /foo/bar\ncd /foo/bar\ncp ~/PLP-versionnumber/plp.cgi .\nchmod 755 plp.cgi" :>
  32. Then, we add a bunch of configuration to httpd.conf:
  33. <: code Entity
  34. qq{ScriptAlias /foo/bar/ /PLP_COMMON/
  35. <Directory /foo/bar/>
  36.   AllowOverride None
  37.   Options +ExecCGI
  38.   Order allow,deny
  39.   Allow from all
  40. </Directory>
  41. AddHandler plp-document plp
  42. Action plp-document /PLP_COMMON/plp.cgi}
  43. :>
  44. Restart Apache to make it use the new settings.

  46. <: item 'Testing the PLP installation' :>
  47. We test by creating a simple test.plp file in our website directory.
  48. <: code Entity qq{<html><body>\n<: print "It works!<BR>" for 1..10 :\>\n</body></html>} :>
  49. If that prints "It works!" ten times, you're set to go. If not, examing your error log
  50. for details (search for error_log or error.log if you don't know where to find it).