Ogni volta che Apache deve processare un URL può rispondere in tre modi:
- Restituisce la risorsa richiesta.
- Restituisce un errore.
- Restituisce una pagina html contenente l'elenco degli oggetti contenuti nella directory.
La terza possibilità viene identificata come Directory listing e viene gestita tramite il modulo mod_autoindex.
Tramite la direttiva Options è possibile abilitare e disabilitare la visualizzazione dei file contenuti in una directory, quando non esiste la DirectoryIndex, cioè un file predefinito come home page:
Options +Indexes
Options -Indexes
Per motivi di sicurezza e riservatezza è generalmente consigliabile disabilitare l'opzione di Indexes a meno che l'intento sia proprio quello di mostrare tutto il contenuto di una directory.
L'aspetto della pagina html generata on-the-fly dipende inanzitutto dal contenuto della directory e da varie opzioni settatte tramite le direttive sotto indicate.
Di default viene generata una pagina html con l'opzione FancyIndexing ed in modo automatico viene visualizzato il possibile contenuto di un file readme e HEADER.
Di fatto le configurazioni preimpostate di Apache sono più che adeguate, l'unica attenzione va posta su quali directory permettere il Listing e su quali impedirlo.
IndexOptions
Modifica la visualizzazione del contenuto, con la possibilità di modificare a piacere le dimensione delle icone o visualizzare o meno alcuni attributi dei file contenuti nella directory:
IndexOptions FancyIndexing
HeaderName
E' la direttiva che permette di definire il nome di un file che verrà incluso e visualizzato in modo automatico come header, prima dell'elenco dei file nella directory:
HeaderName intro
IndexIgnore
Direttiva che permette di non visualizzare specifici file nel listing della directory:
IndexIgnore *.doc *.mp3
AddIcon, Addalt
Permette di associare una icona e un alt-text ad un tipo di file:
AddIcon /icons/jpg.gif .jpg
Addalt "JPG Image" .jpg
AddType, AddIconByType, AddAltByType
Permette di associare una icona e un alt-text ad un di file a seconda del suo MIME type.
AddEncoding, AddIconByEncoding, AddAltByEncoding
Permette di associare una icona e un alt-text ad un di file a seconda del suo MIME Encoding.
DefaultIcon
Setta la icona di default che viene visualizzata nel caso in cui il tipo di file non è associato a nessuna icona:
DefaultIcon /icons/blank.gif
AddDescription
Direttiva che permette di aggiungere la descrizione ad eventuali tipi di file:
AddDescription "GIF IMAGE" *.gif
Gestione della visualizzazione di directory. Definizione index predefiniti.