v3.12 release
[perl/plp/.git] / README
1 NAME
2     PLP - Perl in HTML pages
3
4 MODULE INSTALLATION
5
6     perl Makefile.PL
7     make
8     make install
9
10 SYNOPSIS
11   mod_perl installation
12     * httpd.conf (for mod_perl setup)
13                   <Files *.plp>
14                       SetHandler perl-script
15                       PerlHandler PLP
16                       PerlSendHeader On
17                   </Files>
18
19                   # Who said CGI was easier to set up? :)
20
21   CGI installation
22     * /foo/bar/plp.cgi (local filesystem address)
23                   #!/usr/bin/perl
24                   use PLP;
25                   PLP::everything();
26
27     * httpd.conf (for CGI setup)
28                   ScriptAlias /foo/bar/ /PLP_COMMON/
29                   <Directory /foo/bar/>
30                       AllowOverride None
31                       Options +ExecCGI
32                       Order allow,deny
33                       Allow from all
34                   </Directory>
35                   AddHandler plp-document plp
36                   Action plp-document /PLP_COMMON/plp.cgi
37
38   Test script (test.plp)
39         <html><body>
40         <:
41             print "Hurrah, it works!<br>" for 1..10;
42         :>
43         </body></html>
44
45 DESCRIPTION
46     PLP is yet another Perl embedder, primarily for HTML documents. Unlike
47     with other Perl embedders, there is no need to learn a meta-syntax or
48     object model: one can just use the normal Perl constructs. PLP runs
49     under mod_perl for speeds comparable to those of PHP, but can also be
50     run as a CGI script.
51
52 WEBSITE
53     For now, all documentation is on the website. Everything will be POD one
54     day, but until that day, you will need to visit http://plp.juerd.nl/
55
56 FAQ
57     A lot of questions are asked often, so before asking yours, please read
58     the FAQ that is located at http://plp.juerd.nl/faq.plp
59
60 NO WARRANTY
61     No warranty, no guarantees. Use PLP at your own risk, as I disclaim all
62     responsibility.
63
64 AUTHOR
65     Juerd Waalboer <juerd@juerd.nl>
66