apache_mod_perl-108~358::mod_perl-2.0.7::docs::api::ApacUser:Contributed Peapache_mod_perl-108~358::mod_perl-2.0.7::docs::api::Apache2::Command(3)NAME
Apache2::Command - Perl API for accessing Apache module command information
Synopsis
use Apache2::Module ();
use Apache2::Command ();
my $module = Apache2::Module::find_linked_module('mod_perl.c');
for (my $cmd = $module->cmds; $cmd; $cmd = $cmd->next) {
$cmd->args_how();
$cmd->errmsg();
$cmd->name();
$cmd->req_override();
}
Description
"Apache2::Command" provides the Perl API for accessing Apache module command information
API
"Apache2::Command" provides the following functions and/or methods:
"args_how"
What the command expects as arguments:
$how = $cmd->args_how();
obj: $cmd ( "Apache2::Command object" )
ret: $how ( "Apache2::Const :cmd_how constant" )
The flag value representing the type of this command (i.e. "Apache2::Const::ITERATE", "Apache2::Const::TAKE2").
since: 2.0.00
"errmsg"
Get usage message for that command, in case of syntax errors:
$error = $cmd->errmsg();
obj: $cmd ( "Apache2::Command object" )
ret: $error ( string )
The error message
since: 2.0.00
"name"
Get the name of this command:
$name = $cmd->name();
obj: $cmd ( "Apache2::Command object" )
ret: $name ( string )
The command name
since: 2.0.00
"next"
Get the next command in the chain of commands for this module:
$next = $cmd->next();
obj: $cmd ( "Apache2::Command object" )
ret: $next ( "Apache2::Command object" )
Returns the next command in the chain for this module, "undef" for the last command.
since: 2.0.00
"req_override"
What overrides need to be allowed to enable this command:
$override = $cmd->req_override
obj: $cmd ( "Apache2::Command object" )
ret: $override ( "Apache2::Const :override constant" )
The bit mask representing the overrides this command is allowed in (i.e "Apache2::Const::OR_ALL"/"Apache2::Const::ACCESS_CONF").
since: 2.0.00
For example:
use Apache2::Const -compile => qw(:override);
$cmd->req_override() & Apache2::Const::OR_AUTHCFG;
$cmd->req_override() & Apache2::Const::OR_LIMIT;
See Also
mod_perl 2.0 documentation.
Copyright
mod_perl 2.0 and its core modules are copyrighted under The Apache Software License, Version 2.0.
Authors
The mod_perl development team and numerous contributors.
perl v5.16.2 2011-02apache_mod_perl-108~358::mod_perl-2.0.7::docs::api::Apache2::Command(3)
Check Out this Related Man Page
apache_mod_perl-108~358::mod_perl-2.0.7::docs::api::ApacUser:Contributed Perapache_mod_perl-108~358::mod_perl-2.0.7::docs::api::Apache2::Module(3)NAME
Apache2::Module - Perl API for creating and working with Apache modules
Synopsis
use Apache2::Module ();
#Define a configuration directive
my @directives = (
{
name => 'MyDirective',
}
);
Apache2::Module::add(__PACKAGE__, @directives);
# iterate over the whole module list
for (my $modp = Apache2::Module::top_module(); $modp; $modp = $modp->next) {
my $name = $modp->name;
my $index = $modp->module_index;
my $ap_api_major_version = $modp->ap_api_major_version;
my $ap_api_minor_version = $modp->ap_api_minor_version;
my $commands = $modp->cmds;
}
# find a specific module
my $module = Apache2::Module::find_linked_module('mod_ssl.c');
# remove a specific module
$module->remove_loaded_module();
# access module configuration from a directive
sub MyDirective {
my ($self, $parms, $args) = @_;
my $srv_cfg = Apache2::Module::get_config($self, $parms->server);
[...]
}
# test if an Apache module is loaded
if (Apache2::Module::loaded('mod_ssl.c')) {
[...]
}
# test if a Perl module is loaded
if (Apache2::Module::loaded('Apache2::Status')) {
[...]
}
Description
"Apache2::Module" provides the Perl API for creating and working with Apache modules
See Apache Server Configuration Customization in Perl.
API
"Apache2::Module" provides the following functions and/or methods:
"add"
Add a module's custom configuration directive to Apache.
Apache2::Module::add($package, $cmds);
arg1: $package ( string )
the package of the module to add
arg2: $cmds ( ARRAY of HASH refs )
the list of configuration directives to add
ret: no return value
since: 2.0.00
See also Apache Server Configuration Customization in Perl.
"ap_api_major_version"
Get the httpd API version this module was build against, not the module's version.
$major_version = $module->ap_api_major_version();
obj: $module ( "Apache2::Module object" )
ret: $major_version ( integer )
since: 2.0.00
This methid is used to check that module is compatible with this version of the server before loading it.
"ap_api_minor_version"
Get the module API minor version.
$minor_version = $module->ap_api_minor_version();
obj: $module ( "Apache2::Module object" )
ret: $minor_version ( integer )
since: 2.0.00
"ap_api_minor_version()" provides API feature milestones.
It's not checked during module init.
"cmds"
Get the "Apache2::Command" object, describing all of the directives this module defines.
$command = $module->cmds();
obj: $module ( "Apache2::Module object" )
ret: $command ( "Apache2::Command object" )
since: 2.0.00
"get_config"
Retrieve a module's configuration. Used by configuration directives.
$cfg = Apache2::Module::get_config($class, $server, $dir_config);
$cfg = Apache2::Module::get_config($class, $server);
$cfg = $self->get_config($server, $dir_config);
$cfg = $self->get_config($server);
obj: $module ( "Apache2::Module object" )
arg1: $class ( string )
The Perl package this configuration is for
arg2: $server ( "Apache2::ServerRec object" )
The current server, typically "$r->server" or "$parms->server".
opt arg3: $dir_config ( "Apache2::ConfVector object" )
By default, the configuration returned is the server level one. To retrieve the per directory configuration, use "$r->per_dir_config"
as a last argument.
ret: $cfg (HASH reference)
A reference to the hash holding the module configuration data.
since: 2.0.00
See also Apache Server Configuration Customization in Perl.
"find_linked_module"
Find a module based on the name of the module
$module = Apache2::Module::find_linked_module($name);
arg1: $name ( string )
The name of the module ending in ".c"
ret: $module ( "Apache2::Module object" )
The module object if found, "undef" otherwise.
since: 2.0.00
For example:
my $module = Apache2::Module::find_linked_module('mod_ssl.c');
"loaded"
Determine if a certain module is loaded
$loaded = Apache2::Module::loaded($module);
name: $module ( string )
The name of the module to search for.
If $module ends with ".c", search all the modules, statically compiled and dynamically loaded.
If $module ends with ".so", search only the dynamically loaded modules.
If $module doesn't contain a ".", search the loaded Perl modules (checks %INC).
ret: $loaded ( boolean )
Returns true if the module is loaded, false otherwise.
since: 2.0.00
For example, to test if this server supports ssl:
if (Apache2::Module::loaded('mod_ssl.c')) {
[...]
}
To test is this server dynamically loaded mod_perl:
if (Apache2::Module::loaded('mod_perl.so')) {
[...]
}
To test if "Apache2::Status" is loaded:
if (Apache2::Module::loaded('Apache2::Status')) {
[...]
}
"module_index"
Get the index to this modules structures in config vectors.
$index = $module->module_index();
obj: $module ( "Apache2::Module object" )
ret: $index ( integer )
since: 2.0.00
"name"
Get the name of the module's .c file
$name = $module->name();
obj: $module ( "Apache2::Module object" )
ret: $name ( string )
since: 2.0.00
For example a mod_perl module, will return: mod_perl.c.
"next"
Get the next module in the list, "undef" if this is the last module in the list.
$next_module = $module->next();
obj: $module ( "Apache2::Module object" )
ret: $next_module ( "Apache2::Module object" )
since: 2.0.00
"remove_loaded_module"
Remove a module from the list of loaded modules permanently.
$module->remove_loaded_module();
obj: $module ( "Apache2::Module object" )
ret: no return value
since: 2.0.00
"top_module"
Returns the first module in the module list. Usefull to start a module iteration.
$module = Apache2::Module::top_module();
ret: $module ( "Apache2::Module object" )
since: 2.0.00
See Also
mod_perl 2.0 documentation.
Copyright
mod_perl 2.0 and its core modules are copyrighted under The Apache Software License, Version 2.0.
Authors
The mod_perl development team and numerous contributors.
perl v5.16.2 2011-02-apache_mod_perl-108~358::mod_perl-2.0.7::docs::api::Apache2::Module(3)