Barry King

NAME

Apache::Wyrd::Request - Unified libapreq configuration or libapreq replacement

SYNOPSIS

in Apache config:

        PerlSetVar RequestParms DISABLE_UPLOADS
        PerlAddVar RequestParms 1
        PerlAddVar RequestParms POST_MAX
        PerlAddVar RequestParms 1024

DESCRIPTION

Wrapper for Apache::Request or CGI object with Apache::Request-type assurances that this is the first and only invocation for this PerlResponseHandler. The wrapper is for the convenience of allowing a consistent set of parameters to be used in initializing the Apache::Request object between stacked/different handlers.

These parameters are handed to the object via the RequestParms directory config variable. As this is a hash, items must be added in pairs using PerlSetVar and PerlAddVar as shown in the SYNOPSIS.

If libapreq/Apache::Request is not installed, the object provides a unified interface to the CGI parameters via the CGI module. When libapreq is not installed, this behavior will be automitically invoked. If neither are available, it will call die(), causing a server error.

You can force the use of Apache::Request or CGI by setting the WYRD_USE_CGI or WYRD_USE_APR environment variables. If the forced module fails to load, the module will die(), causing a server error. Note that this also affects the behavior of Apache::Wyrd::Cookie.

METHODS

(format: (returns) name (arguments after self))

(Apache::Wyrd::Request) instance (void)

See Apache::Request->instance(). The only difference is the configuration via PerlSetVar/PerlAddVar directives.

BUGS/CAVEATS/RESERVED METHODS

UNKNOWN

AUTHOR

Barry King <wyrd@nospam.wyrdwright.com>

SEE ALSO

Apache::Wyrd

General-purpose HTML-embeddable perl object

LICENSE

Copyright 2002-2007 Wyrdwright, Inc. and licensed under the GNU GPL.

See LICENSE under the documentation for Apache::Wyrd.