Building mod_perl 2.0.2
Building a Web Server, for Windows
Requirements
- Microsoft Visual C++
[we will use Visual Studio 98 / VC++ 6.0]
[Visual Studio .NET will also work with the same instructions] - Perl 5.8.0+
- Apache 2.0.47+
- Notes:
- When using the command-line (command-shell) with VC++, always set the Build Environment and update the System PATH to reflect the tools used in the build --> Guide: Working with the Command Shell
Download
- Package(win32 source) : mod_perl-2.0-current.tar.gz
- Unpack as C:\build\mod_perl-2.0.2
Our Configuration
- Install to : C:\www\perl
[do not install to a directory that contains white spaces] - Apache path : C:\www\Apache2
Build/Install Required Perl-Modules
A group of Perl modules need to be built and installed prior to the main mod_perl build process. This step can be skipped by installing Bundle::Apache2. Note that this is needed for the 'nmake test' process -- these modules are not required to build mod_perl, just to test that build.
- Download and unpack the following modules...
- Devel-Symdump 2.0602
[not required, but recommended] - Compress-Zlib 1.42
[not required, but recommended] - FCGI 0.67
[not required, but recommended] - libwin32 0.26
- CGI.pm 3.23
[not required, but recommended; no need to install -- CGI.pm v3.20 packaged with Perl v5.8.8] - HTML-Tagset 3.10
- HTML-Parser 3.55
- URI 1.35
- libwww-perl 5.805
- Devel-Symdump 2.0602
- In the order above, from the source directory of each module, build and install each module...
[read file README in each module dir for the official instructions]...\module> perl Makefile.PL
[create 'Makefile']...\module> nmake
[build module]...\module> nmake test
[test built module; this step is optional]
[note that several tests could fail; continue]...\module> nmake install
[install module]
Build/Install mod_perl
cd /d C:\build\mod_perl-2.0.2> perl Makefile.PL MP_AP_PREFIX=C:\www\Apache2
[select 'no' for apxs]> nmake> nmake test
[this step is optional, and could be time consuming]
[for this step, use httpd.default.conf (the original and unmodified httpd.conf) for Apache2\conf\httpd.conf]
[note that several tests could fail with an illegal memory reference; click 'ok' each time, continue]> nmake install
Apache Setup for mod_perl
- Edit file C:\www\Apache2\conf\httpd.conf
- Add
LoadModule perl_module modules/mod_perl.so
- Add
Testing mod_perl
This will create an example perl module, Hello.pm
- Edit file C:\www\Apache2\conf\httpd.conf
PerlModule Apache2::Hello
<Location /hello>
SetHandler modperl
PerlResponseHandler Apache2::Hello
</Location>
- Create file C:\www\perl\site\lib\Apache2\Hello.pm
package Apache2::Hello;
use strict;
use Apache2::RequestRec (); # for $r->content_type
use Apache2::RequestIO (); # for $r->puts
use Apache2::Const -compile => ':common';
sub handler {
my $r = shift;
my $time = scalar localtime();
my $package = __PACKAGE__;
$r->content_type('text/html');
$r->puts(<<"END");
<HTML><BODY>
<H3>Hello</H3>
Hello from <B>$package</B>! The time is $time.
</BODY></HTML>
END
return Apache2::Const::OK;
}
1;
- Restart Apache and access http://localhost/hello
Help
- mod_perl 2.0 Win32 Platforms Info
- mod_perl 2.0 Renaming Info
