Kazuho Oku > Test-Httpd-Apache2-0.09 > Test::Httpd::Apache2

Download:
Test-Httpd-Apache2-0.09.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.09   Source  

NAME ^

Test::Httpd::Apache2 - Apache2 runner for tests

SYNOPSIS ^

    use Test::Httpd::Apache2;

    my $httpd = Test::Httpd::Apache2->new(
        custom_conf => << 'EOT',
    DocumentRoot "htdocs"
    EOT
    );

    # do whatever you want
    my $url = "http://" . $httpd->listen . "/";
    ...

DESCRIPTION ^

The module automatically setups an instance of Apache2 httpd server and destroys it when the perl script exits.

FUNCTIONS ^

new

Creates and runs the httpd server. Httpd is terminated when the returned object is DESTROYed. The function accepts following arguments, which can also be read and/or be set through the accessors of the same name.

listen

The address to which the httpd binds to. Corresponds to the "Listen" configuration directive of Apache. The default value is "127.0.0.1:<whatever_port_that_was_unused>".

server_root

The "ServerRoot" runtime directive. Set to current working directory if omitted.

custom_conf

Application-specific configuration passed that will be written to the configuration file of Apache. Default is none.

required_modules

An arrayref to specify the required apache modules. If any module are specified, Test::Httpd::Apache2 will check the list of statically-compiled-in and dynamically-aviable modules and load the necessary modules automatically. Module names should be specified excluding the "mod_" prefix and ".so" suffix. For example, auth_basic_module should be specified as "auth_basic". Default is an empty arrayref.

Note: "Authz_host" is automatically translated to "access" if the found httpd is Apache/2.0.x for compatibility.

search_paths

Paths to look for the httpd server in addition to the PATH environment variable. The default is: /usr/sbin, /usr/local/sbin, /usr/local/apache/bin.

pid

the read-only accessor returns pid of the httpd server or undef if it is not running

start

the instance method starts the httpd server

stop

the instance method stops the httpd server

COPYRIGHT ^

Copyright (C) 2010 Cybozu Labs, Inc. Written by Kazuho Oku.

THANKS TO ^

Tatsuhiko Miyagawa mattn

LICENSE ^

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See http://www.perl.com/perl/misc/Artistic.html

syntax highlighting: