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).