NAME

Apache::Module - Interface to Apache C module structures

SYNOPSIS

            

              
              
use Apache::Module ();
            
          

DESCRIPTION

This module provides an interface to the list of apache modules configured with your httpd and their module * structures.

METHODS

top_module

This method returns a pointer the first module in Apache's internal list of modules.

            

              
              
  Example:
  my $top_module = Apache::Module->top_module;
  print "Configured modules: \n";
  for (my $modp = $top_module; $modp; $modp = $modp->next) {
print $modp->name, "\n";
  }
            
          

find($module_name)

This method returns a pointer to the module structure if found, under otherwise.

            

              
              
 Example:
for (qw(proxy perl include cgi)) {
    if(my $modp = Apache::Module->find($_)) {
 print "$_ module is configured\n";
        print "with enabled commands: \n";
 for (my $cmd = $modp->cmds; $cmd; $cmd = $cmd->next) {
     print "   ", $cmd->name, "\n";
 }
    }
    else {
 print "$_ module is not configured\n";
    }
}
            
          

handlers

Returns a pointer to the module response handler table.

Example:

            

              
              
   print "module ", $modp->name, " handles:\n";
   for (my $hand = $modp->handlers; $hand; $hand = $hand->next) {
print $hand->content_type, "\n";
   }
            
          

Other Stuff

There's more you can do with this module, I will document it later. For now, see Apache::ModuleDoc and Apache::ShowRequest for examples.

AUTHOR

Doug MacEachern

SEE ALSO

Apache::ModuleDoc(3), Apache::ShowRequest(3), Apache(3), mod_perl(3).