Apache::MIMEMapper - associate file extensions with PerlHandlers
PerlModule Apache::MIMEMapper PerlTypeHandler Apache::MIMEMapper
AddHandler Apache::RegistryFilter .pl AddHandler Apache::SSI .html .pl
Alias /perl-bin/ /usr/local/apache/perl-bin/ <Location /perl-bin/> SetHandler perl-script PerlHandler Apache::Registry Options +ExecCGI PerlSendHeader On </Location>
Apache::MIMEMapper extends the core AddHandler directive to allow you to dispatch different PerlHandlers based on the file extension of the requested resource. This means that you can now have .pl scripts under htdocs/ (or wherever) without resorting to a <Files> based configuration.
Apache::MIMEMapper also adds the ability to stack PerlHandlers transparently using Apache::Filter. Handlers are added to the PerlHandler stack in the order they appear in the httpd.conf file - PerlSetVar Filter On is set if more than one extension is associated with a specific Perl module.
In this example, .html files are scheduled for processing with Apache::SSI. Additionally, .pl files outside of /perl-bin are handled by Apache::RegistryFilter and Apache::SSI (in that order).
Because the SetHandler directive supercedes all other mod_mime directives, all files inside of /perl-bin are processed using Apache::Registry.
The current logic checks AddHandler for something that looks like a Perl module, so
AddHandler server-parsed .shtml
still works. The criterion for deciding if Apache::MIMEMapper intercepts the request is whether the handler is in the form Foo::Bar - it checks for '::'. This is not ideal, but simple and sufficient for most cases.
Apache::MIMEMapper is a PerlTypeHandler. It does just about everything that mod_mime does (via MIME::Types). The only place where it interferes is for content-negotiated requests, where the AddLanguage and associated directives are necessary. Should you need these directives, you can install Apache::MIMEMapper as a PerlFixupHandler instead.
perl(1), mod_perl(1), Apache(3)
Geoffrey Young <geoff@modperlcookbook.org>
Paul Lindner <paul@modperlcookbook.org>
Randy Kobes <randy@modperlcookbook.org>
Copyright (c) 2001, Geoffrey Young, Paul Lindner, Randy Kobes.
All rights reserved.
This module is free software. It may be used, redistributed and/or modified under the same terms as Perl itself.
This code is derived from the Cookbook::MIMEMapper module, available as part of "The mod_perl Developer's Cookbook".
For more information, visit http://www.modperlcookbook.org/
To install Apache::MIMEMapper, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Apache::MIMEMapper
CPAN shell
perl -MCPAN -e shell install Apache::MIMEMapper
For more information on module installation, please visit the detailed CPAN module installation guide.