NAME
Apache::PAR::Static - Serve static content to clients from within .par files.
SYNOPSIS
A sample configuration (within a web.conf) is below:
Alias /myapp/static/ ##PARFILE##/
<Location /myapp/static>
SetHandler perl-script
PerlHandler Apache::PAR::Static
PerlSetVar PARStaticDirectoryIndex index.htm
PerlAddVar PARStaticDirectoryIndex index.html
PerlSetVar PARStaticDefaultMIME text/html
</Location>DESCRIPTION
The Apache::PAR::Static module allows a .par file creator to place any static content into a .par archive (under a configurable directory in the .par file) to be served directly to clients.
To use, add Apache::PAR::Static into the Apache configuration, either through an Apache configuration file, or through a web.conf file (discussed in more detail in Apache::PAR.)
Some things to note:
Apache::PAR::Static does not currently use Apache defaults in mod_dir. Therefore, it is necessary to specify variables for directory index files and the default mime type. To specify files to use for directory indexes, use the following syntax in the configuration:
PerlSetVar PARStaticDirectoryIndex index.htm
PerlAddVar PARStaticDirectoryIndex index.html
...To set the default MIME type for requests, use: PerlSetVar PARStaticDefaultMIME text/html
Currently, Apache::PAR::Static does not have the ability to generate directory indexes for directories inside .par files. Also, other Apache module features, such as language priority, do not take effect for content inside .par archives.
The default directory to serve static content out of in a .par file is htdocs/ to override this, set the PARStaticFilesPath variable. For example, to set this to serve files from a static/ directory within the .par file, use: PerlSetVar PARStaticFilesPath static/
Under mod_perl 1.x, byte range requests are supported, to facilitate the serving of PDF files, etc. For mod_perl 2.x users, use the appropriate Apache filter (currently untested.)
EXPORT
None by default.
AUTHOR
Nathan Byrd, <nathan@byrd.net>
SEE ALSO
perl.
PAR.
COPYRIGHT
Copyright 2002 by Nathan Byrd <nathan@byrd.net>.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.