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 of the Configuration Directives defined by mod_dir and mod_autoindex. For more information about those, checkout the Apache Documentation http://www.apache.org/docs/mod/

Most of the Directive documentation comes directly from there.

SUPPORTED DIRECTIVES

DirectoryIndex

This is the same thing as the usual mod_autoindex, some directives are not used yet and the +/- syntax is not working yet.

FancyIndexing

IndexOptions FancyIndexing should be used instead. Currently, it will work also.

HeaderName filename [filename]*

You can now add more than one filename to check for.

When indexing the directory /web, the server will first look for the HTML file /web/HEADER.html and include it if found, otherwise it will include the plain text file /web/HEADER, if it exists.

ReadmeName filename [filename]*

Idem.

IndexIgnore filename [filename]*

The IndexIgnore directive defines a list of files to hide when listing a directory.

NEW DIRECTIVES

PerlSetVar AutoIndexDebug [0|1]

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

UNSUPPORTED DIRECTIVES

AddDescription
FancyIndexing and IndexOptions FancyIndexing
IndexOrderDefault
IconHeights[=pixels]
IconWidth[=pixels]
IconsAreLinks
NameWidth[=n|*]
ScanHTMLTitles
SuppressColumnSorting
SuppressDescription
*SuppressHTMLPreamble
SuppressLastModified
SuppressSize

TODO

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

IndexOptions +/- inheritance.

Merging configuration directives should work in vhost/dir/location etc.

Add new configuration directives.

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>

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