NAME

Apache::AutoIndex - Perl replacment for mod_autoindex and mod_dir Apache module

SYNOPSIS

PerlModule Apache::Icon
PerlModule Apache::AutoIndex
PerlHandler Apache::AutoIndex

DESCRIPTION

This module can replace completely mod_dir and mod_autoindex standard directory handling modules shipped with apache. It can currently live right on top of those modules. But it also works if they are not even compiled in.

To start using it on your site right away, simply preload Apache::Icon and Apache::AutoIndex either with:

PerlModule Apache::Icon
PerlModule Apache::AutoIndex

in your httpd.conf file or with:

  use Apache::Icon ();
  use Apache::AutoIndex;

in your require.pl file.

Then it's simply adding PerlHandler Apache::AutoIndex somewhere in your httpd.conf but outside any Location/Directory containers.

It uses most (pretty soon it'll be all) of the Configuration Directives defined by mod_dir and mod_autoindex.

Since the documentation about all those directives can be found on the apache website at:

http://www.apache.org/docs/mod/mod_autoindex.html 
http://www.apache.org/docs/mod/mod_dir.html

I will only list modification that might have occured in this perl version.

SUPPORTED DIRECTIVES

• DirectoryIndex

• FancyIndexing

• IndexOptions - Now everything should be recognized, but some directives are not used. Also, the +/- syntax should work by now.

• HeaderName - It can now accept a list of files instead of just one

• ReadmeName - It can now accept a list of files instead of just one

• IndexIgnore

• IndexOrderDefault

NEW DIRECTIVES

PerlSetVar AutoIndexDebug [0|1]

If set to 1, the listing displayed will print usefull (well, to me) debugging information appended to the bottom. The default is 0.

UNSUPPORTED DIRECTIVES

AddDescription -- Will be as soon as the new Apache::Icon comes out

TODO

Correct the bug that prevents using Apache::AutoIndex in <Location> <Directory> context.

Implement correctly all directives currently being silently ignored.

Find new things to add...

SEE ALSO

perl(1), Apache(3), Apache::Icon(3).

SUPPORT

Please send any questions or comments to the Apache modperl mailing list <modperl@apache.org> or to me at <gozer@ectoplasm.dyndns.com>

NOTES

This code was made possible by :

• Doug MacEachern <dougm@pobox.com> Creator of Apache::Icon, and of course, mod_perl.

• Rob McCool who produced the final mod_autoindex.c I copied, hrm.., well, translated to perl.

• The mod_perl mailing-list at <modperl@apache.org> for all your mod_perl related problems.

AUTHOR

Philippe M. Chiasson <gozer@ectoplasm.dyndns.com>

COPYRIGHT

Copyright (c) 1999 Philippe M. Chiasson. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

cpanm Apache::AutoIndex

perl -MCPAN -e shell
install Apache::AutoIndex