ModPerl::MM -- A "subclass" of ExtUtils::MakeMaker for mod_perl 2.0
use ModPerl::MM; # ModPerl::MM takes care of doing all the dirty job of overriding ModPerl::MM::WriteMakefile(...); # if there is a need to extend the default methods sub MY::constants { my $self = shift; $self->ModPerl::MM::MY::constants; # do something else; } # or prevent overriding completely sub MY::constants { shift->MM::constants(@_); }"; # override the default value of WriteMakefile's attribute my $extra_inc = "/foo/include"; ModPerl::MM::WriteMakefile( ... INC => $extra_inc, ... ); # extend the default value of WriteMakefile's attribute my $extra_inc = "/foo/include"; ModPerl::MM::WriteMakefile( ... INC => join " ", $extra_inc, ModPerl::MM::get_def_opt('INC'), ... );
ModPerl::MM is a "subclass" of ExtUtils::MakeMaker for mod_perl 2.0, to a degree of sub-classability of ExtUtils::MakeMaker.
ModPerl::MM
ExtUtils::MakeMaker
When ModPerl::MM::WriteMakefile() is used instead of ExtUtils::MakeMaker::WriteMakefile(), ModPerl::MM overrides several ExtUtils::MakeMaker methods behind the scenes and supplies default WriteMakefile() arguments adjusted for mod_perl 2.0 build. It's written in such a way so that normally 3rd party module developers for mod_perl 2.0, don't need to mess with Makefile.PL at all.
ModPerl::MM::WriteMakefile()
ExtUtils::MakeMaker::WriteMakefile()
WriteMakefile()
MY::
ModPerl::MM overrides method foo as long as Makefile.PL hasn't already specified a method MY::foo. If the latter happens, ModPerl::MM will DWIM and do nothing.
In case the functionality of ModPerl::MM methods needs to be extended, rather than completely overriden, the ModPerl::MM methods can be called internally. For example if you need to modify constants in addition to the modifications applied by ModPerl::MM::MY::constants, call the ModPerl::MM::MY::constants method (notice that it resides in the package ModPerl::MM::MY and not ModPerl::MM), then do your extra manipulations on constants:
ModPerl::MM::MY::constants
ModPerl::MM::MY
# if there is a need to extend the methods sub MY::constants { my $self = shift; $self->ModPerl::MM::MY::constants; # do something else; }
In certain cases a developers may want to prevent from ModPerl::MM to override certain methods. In that case an explicit override in Makefile.PL will do the job. For example if you don't want the constants() method to be overriden by ModPerl::MM, add to your Makefile.PL:
constants()
sub MY::constants { shift->MM::constants(@_); }";
ModPerl::MM overrides the following methods:
ModPerl::MM::MY::post_initialize
This method is deprecated.
ModPerl::MM::WriteMakefile supplies default arguments such as INC and TYPEMAPS unless they weren't passed to ModPerl::MM::WriteMakefile from Makefile.PL.
ModPerl::MM::WriteMakefile
INC
TYPEMAPS
If the default values aren't satisfying these should be overriden in Makefile.PL. For example to supply an empty INC, explicitly set the argument in Makefile.PL.
ModPerl::MM::WriteMakefile( ... INC => '', ... );
If instead of fully overriding the default arguments, you want to extend or modify them, they can be retrieved using the ModPerl::MM::get_def_opt() function. The following example appends an extra value to the default INC attribute:
ModPerl::MM::get_def_opt()
my $extra_inc = "/foo/include"; ModPerl::MM::WriteMakefile( ... INC => join " ", $extra_inc, ModPerl::MM::get_def_opt('INC'), ... );
ModPerl::MM supplies default values for the following ModPerl::MM::WriteMakefile attributes:
CCFLAGS
LIBS
OPTIMIZE
LDDLFLAGS
dynamic_lib
OTHERLDFLAGS
dynamic_lib => { OTHERLDFLAGS => ... }
macro
MOD_INSTALL
macro => { MOD_INSTALL => ... }
makes sure that Apache-Test/ is added to @INC.
The following functions are a part of the public API. They are described elsewhere in this document.
ModPerl::MM::WriteMakefile(...);
get_def_opt()
my $def_val = ModPerl::MM::get_def_opt($key);
To install mod_perl2, copy and paste the appropriate command in to your terminal.
cpanm
cpanm mod_perl2
CPAN shell
perl -MCPAN -e shell install mod_perl2
For more information on module installation, please visit the detailed CPAN module installation guide.