v3.20 release

improve lighttpd configuration samples

Use the merge (+=) syntax so the user doesn't have to integrate any
existing options, and can simply add the snippet as is (even as a
seperate include, especially easy in a Debian setup).

Extend backend configuration examples with options for a directory index
of index.plp, and (static) source rejection.

keep SCRIPT_* environment variables in CGI

These are now identical to their PLP_* counterparts, and should be used
instead for familiarity (why rename for no apparant reason; SCRIPT_* now
contain their expected values so no reason to suggest otherwise).
Apache already has both.

license file from COPYING renamed LICENSE

While COPYING seems to be most frequently used overall, LICENSE is used
more in perl modules and recommended by Kwalitee guidelines.  Fine with
me either way, so use the name that breaks the least.

do not import parent module in PLP::Backend::FastCGI

FastCGI initialized normal CGI as well, providing unneeded CGI support.
Apparantly it's not in the way, but wrong nonetheless (and quite
confusing to be able to use the fastcgi module with cgi).

suppress warning in PLP::Backend::CGI

Add parentheses to my $scalar argument to read() to verify it's really
only a single variable.  Works the same, but fixes a warning if run -w.

restructure file locations

Use root directories lib/ (pm and pod) and bin/ (executable scripts).
This is the common layout of modern modules, and in fact ever more
expected (by Module::Build for example).

custom META.yml

Automatically generated module information cannot ascertain certain
information, so I'd rather provide all YAML myself.

Compared to ExtUtils::MakeMaker 6.42 output, this adds resources,
recommends, and optional_features.

seperate/rewritten README file

Plain text README should be a minimal introductionary basics: intro
(first paragraph of pod description), installation, help, copyright.
Leave the pod (and only that) to be the full manual.  All users should
be able to run perldoc, without being held off by some wannabe text
conversion.

set $PLP::interface to executing backend

Useful to know how we're running, as code may want to target specific
backends.  Currently undocumented so that behaviour can be changed
easily if need be.

change to MIT license

Add a proper license instead of the just saying 'public domain'
(arguably unfulfilling, see http://www.linuxjournal.com/article/6225).
The MIT or X11 license is similar in intent to the perceived PD,
and should provide all if not more rights to users.
It's essentially the same as the 2-clause BSD and ISC licenses.

With consent of the original copyright holder Juerd Waalboer:
> BTW, mocht je een echte licentie willen gebruiken, dan stel ik MIT
> voor als je je daar zelf in kunt vinden

test for pod correctness

If Test::Pod is present, check the pod of files in our manifest.

expand backend documentation

Add descriptions for PLP::Backend::FastCGI and ::Apache explaining
their configuration and advantages, and recommend/reorder backends
accordingly.

Document a major bug in mod_perl2, and discourage its use for now.
Not investigated, but easily reproducable with:

<:
use Cwd qw(cwd);
say cwd, '<br>';
sleep 10;  # now request a plp from a different directory
say cwd, '<br>';

handle fastcgi signals

http://www.fastcgi.com/devkit/doc/fcgi-spec.html#S7
> A Web server can request that a FastCGI application exit by sending it
> SIGTERM. If the application ignores SIGTERM the Web server can resort
> to SIGKILL.

So stop accepting new requests after receiving a TERM signal.  Allow the
current page to finish, we should assume it won't be long (long-running
scripts usually require customized destructors anyway, so don't account
for those).  This is quite important to prevent interrupted output.

According to http://www.fastcgi.com/docs/faq.html#Signals Apache
mod_fastcgi will send a SIGUSR1 in addition to the TERM.  Seems safe to
ignore these.

If a client aborts a connection, we'll get a SIGPIPE.  Because the page
may still have crucial actions to perform, we should ignore and finish
the code.  Pages can easily handle PIPEs themselves if wanted.

The LastCall method is used, even though FCGI 0.67 warns:
> Note that this method is still experimental and everything about it,
> including its name, is subject to change.

As it's stable since september 2001, I guess it'll be fine for now.

fix default text for pod links to other modules

Do not provide an explicit link presentation for stand-alone module
references (no context, so let the renderer do what it thinks best).
In a running text we want the opposite though: make sure modules names
aren't 'linkified' when they shouldn't (e.g. "use the XML::Quote
manpage" when we mean just the module).

short TODO with planned features

Note some of the things planned for near-future releases.

move backend interface modules into PLP::Backend:: namespace

Keep our namespace a bit organized.

fix exit constants usage in apache2

Apache2::Const requires HTTP_* constants to be compiled before they can be
accessed. This caused at least a warning message at the end of each page,
usually:

Use of inherited AUTOLOAD for non-method Apache2::Const::OK() is deprecated

update plp.cgi

Update plp.cgi intro comments to reflect new interfaces status.
To make it more usable out of the box, executable flag is set (so it can be
run directly) and uses interpreter from environment (/usr/bin/env should be
supported better than /usr/bin/perl).

move detailed setup documentation to interface modules

Only keep basic instructions for Lighttpd+mod_fastcgi and
Apache+mod_perl in PLP's main synopsis. Other configurations is given in
the pods of interface modules. These are linked at PLP#DESCRIPTION,
which now also contains an overview of supported servers.

Mod_perl configuration variables have also been moved into PLP::Apache.
In all, makes the main documentation much cleaner (uncluttered with
interface-specific details).

add license to Makefile definitions

As recommended by Kwalitee indicator metayml_has_license.
Currently we specify public domain even though it's not listed in
Module::Build::Api and arguably not a valid license at all. Maybe change
our license later, or classify as 'unrestricted'.

git exclude of compile-time files

Ignore everything generated by/for make.

handle request automatically on PLP::CGI import

As it's not used for much else, PLP::CGI can simply start running on
import. So like PLP::FastCGI, the executable only needs to C<use PLP::CGI>
(and C<require> for advanced usage).

No backwards compatibility issues, as the last release didn't have this
modularized (PLP wrapper works the same as before).

fix setting PLPcache from apache configuration

Apache has been split from PLP package, so need to specify variable
explicitly.

make mod_perl request object a global in PLP::Apache only

No reason to always create $PLP::r, as it's only used with Apache.

eg/plpinfo.plp demo/status page

Demo page reporting about the current status of Perl and PLP. Useful as
test page (see if correct versions are loaded as they should, and what
variables are set), or at least as a somewhat larger example of a plp
page.

Modelled closely after PHP's phpinfo() output (even color scheme is the
same, albeit html is much cleaner) to keep it as familiar as possible to
php switcheroos.

FastCGI interface (PLP::CGI extension using FCGI)

Do not exit from PLP::CGI, allowing it to be used consecutively.

Coincidentally, PLP::FastCGI does just that: extending the PLP::CGI
interface to handle FCGI requests. Its import() runs a PLP dispatcher,
so a FastCGI executable (example plp.fcgi is provided) only has to
C<use PLP::FastCGI>. If a server supports run arguments, a wrapper
script isn't even needed this way: just do /usr/bin/perl -MPLP::FastCGI.

PATH_TRANSLATED is explicitly removed from environment so file names are
gotten from SCRIPT_*, which mostly already point to the requested script
(at least much more correctly than can be determined from PATH_*).

This seems to work correctly on at least:
- Apache 1.3.34, 2.2.4, 2.2.8 with mod_fastcgi and mod_fcgid
- Lighttpd 1.4.7 and 1.4.18 with mod_fastcgi

Caching can be controlled by setting an environment variable PLP_CACHE
(unlike with mod_perl, no other means of configuration are provided).
If not specified, PLPcache will be turned on.

fcgi script

generalize reading post input

Input retrieval differs per server interface, so set $PLP::read to a
function providing a read of specified number of bytes. This differs
from $PLP::print as it's not just a name, because it won't be evalled
but called directly.

404 handling for pre-parsed CGI handling

When using SCRIPT_FILENAME provided by server, still make sure the file
exists. Lighttpd can provide non-existant files when setting check-local
is turned off.

PATH_TRANSLATED handling (i.e. Apache) is unaffected: always does 404
checking when walking the path.

clean up CGI environment parsing

When parsing PATH_TRANSLATED, put results in SCRIPT_* variables. Create
additional PLP_* vars only later. This makes both cases result in the
same intermediate state, and therefor easier to follow.

Lighttpd CGI support

In case no PATH_TRANSLATED environment var is present, assume request is
already parsed and SCRIPT_* pointing to target script (not plp handler).
This supports at least Lighttpd CGI requests.  Functionality unchanged
for Apache1/2 CGI.

use recommended apache2 constants

According to mod_perl documentation (porting/compat):

REDIRECT and similar constants have been deprecated in Apache for
years, in favor of the HTTP_* names (they no longer exist Apache
2.0). mod_perl 2.0 API performs the following aliasing behind the
scenes

make PLP::Apache mod_perl 2.0 compatible

move plp server handlers to respective modules

Keep compatibility wrappers for handler() and everything().

test-suite directory

Anticipating more tests.

Also clarifies (limited) testing scope by filename.

seperate modules for backend-specific code

Split out initialization and other specifics for CGI and mod_perl (Apache).

remove disabled Cwd include

documentation fixes

Typo, small mistake in example, unmarked code.

fix html of default error message

Remove unclosed and useless tag; consistent tag capitalization.

reindent remaining 4-space+tab@8 code

Use only tabs for indenting, spaces for alignment.

tiny speedup decoding + in DecodeURI()

v3.19 release

minor code cleanups and clarifications

common argument handling in functions

Slightly cleaner and faster, and accepts read-only values in all functions.

change code indenting to tabs

remove undocumented function HiddenFields()

add tests for all quoting functions

update text dump of documentation

README regenerated from PLP.pm pod.

makefile cleanup

Also drops perl <5.5 support, since PLP requires 5.6 anyway.

module Cwd not used in PLP; don't use

document caveats for quoting functions; fix documentation indenting/wrapping.

fix header sending for tied printing

Headers were not sent on initial printf or print with empty first argument.

plp.tieprint.patch by Shiar 2002-08-21 18:54:45

new maintainer: shiar

v3.18 release

extend howto

Explain basic http authentication. Mention SQLite.

cleanup (minor things like punctuation, use spaces for docu indenting)

optional end tag for plp code

fix header key conversion to match documentation

Really convert Content_Type to content-type.

v3.17 release

- More cleanups
- %get is now built on script start, no longer on first access
- Apache->request->print is used now under mod_perl, not print (faster)
- Small documentation fixes
- Setting a header when headers are already sent now tells you where output
  started
- Speedup in source()

v3.16 release

disable Safe.pm implementation

Leave commented out for future reregard.

code comment cleanup addendum

use relative paths in compile-time includes

Safe.pm implementation

code cleanup (mainly improving comments)

update author's email address

added howto documentation

v3.15 release

- Added caching of scripts. This means using more memory but it also means
  executing scripts 45-65% faster! (mod_perl only)
- Added configurability of caching: PerlSetVar PLPcache On/Off (Default: On)
- Changed PLP.pm to use File::Basename and File::Spec
- Added recursion protection for compile-time includes (fixed max depth: 128)

v3.14 release

plp.vim update

small documentation changes

v3.13 release

v3.12 release

fixed strict-violation in PLP.pm that happened only without mod_perl

v3.11 release

fixed all tie-stuff by reverting a change

Symbol.pm's delete_package doesn't delete a package in the way I thought it did.

checkin v3.10

v3.06 release

v3.05 release

v3.04 release

v3.03 release

v3.02 release

v3.01 release

v3.00 release

v2.40 release

v2.22 release

v2.21 release

v2.01 release