NAME Apache::MIMEMapper - associate file extensions with PerlHandlers SYNOPSIS PerlModule Apache::MIMEMapper PerlTypeHandler Apache::MIMEMapper AddHandler Apache::RegistryFilter .pl AddHandler Apache::SSI .html .pl Alias /perl-bin/ /usr/local/apache/perl-bin/ SetHandler perl-script PerlHandler Apache::Registry Options +ExecCGI PerlSendHeader On DESCRIPTION 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 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. EXAMPLE PerlModule Apache::MIMEMapper PerlTypeHandler Apache::MIMEMapper AddHandler Apache::RegistryFilter .pl AddHandler Apache::SSI .html .pl Alias /perl-bin/ /usr/local/apache/perl-bin/ SetHandler perl-script PerlHandler Apache::Registry Options +ExecCGI PerlSendHeader On 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. NOTES 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. FEATURES/BUGS 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. SEE ALSO perl(1), mod_perl(1), Apache(3) AUTHORS Geoffrey Young Egeoff@modperlcookbook.orgE Paul Lindner Epaul@modperlcookbook.orgE Randy Kobes Erandy@modperlcookbook.orgE COPYRIGHT 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. HISTORY This code is derived from the I module, available as part of "The mod_perl Developer's Cookbook". For more information, visit http://www.modperlcookbook.org/