NAME

Apache::Config::Preproc::include - expand Include statements

SYNOPSIS

$x = new Apache::Config::Preproc '/path/to/httpd.conf',
            -expand => [ qw(include) ];

$x = new Apache::Config::Preproc '/path/to/httpd.conf',
            -expand => [
                { include => [ server_root => $dir ] }
            ];

$x = new Apache::Config::Preproc '/path/to/httpd.conf',
            -expand => [
                { include => [ probe => [ '/usr/sbin/httpd' ] ] }
            ];

DESCRIPTION

Processes Include and IncludeOptional statements and replaces them with the contents of the files supplied in their arguments. If the argument is not an absolute file name, it is searched in the server root directory.

Keyword arguments:

server_root => DIR

Sets default server root value to DIR.

probe => LISTREF | 1

Determine the default server root value by analyzing the output of httpd -V. If LISTREF is given, it contains alternative pathnames of the Apache httpd binary. Otherwise,

probe => 1

is a shorthand for

probe => [qw(/usr/sbin/httpd /usr/sbin/apache2)]
    

When the ServerRoot statement is seen, its value overwrites any previously set server root directory.