<-
Apache > Serveur HTTP > Documentation > Version 2.4 > Modules

Module Apache mod_autoindex

Langues Disponibles:  en  |  fr  |  ja  |  ko  |  tr 

Description:G�n�re automatiquement des index de r�pertoires d'une mani�re similaire � la commande Unix ls, ou � la commande shell Win32 dir
Statut:Base
Identificateur�de�Module:autoindex_module
Fichier�Source:mod_autoindex.c

Sommaire

L'index d'un r�pertoire peut �tre g�n�r� de deux mani�res :

Les deux fonctions sont s�par�es, si bien que vous pouvez enti�rement supprimer (ou remplacer) la g�n�ration automatique d'index, si vous le souhaitez.

On active la g�n�ration automatique d'index en sp�cifiant Options +Indexes. Voir la directive Options pour plus de d�tails.

Si la directive IndexOptions est sp�cifi�e avec l'option FancyIndexing, les en-t�tes de colonnes sont des liens qui permettent de contr�ler l'ordre de tri de l'affichage. Si vous actionnez le lien d'un en-t�te, le listing sera g�n�r� � nouveau, tri� en fonction des valeurs de la colonne concern�e. Si l'on actionne de mani�re r�p�titive le m�me en-t�te, l'ordre de tri est commut� entre les ordres croissant et d�croissant. On peut supprimer ces liens d'en-t�tes de colonnes � l'aide de l'option SuppressColumnSorting de la directive IndexOptions.

Notez que lorsque l'affichage est tri� en fonction de la taille, c'est la taille r�elle qui est prise en compte, et non la valeur affich�e - ainsi, un fichier de 1010 octets sera toujours affich� avant un fichier de 1011 octets (en ordre croissant), m�me si la taille affich�e des deux fichiers est "1K".

Directives

Sujets

top

Arguments de la requ�te d'autoindexation

La cha�ne de param�tres de la requ�te peut contenir de nombreux arguments permettant dans une certaine mesure au client de contr�ler l'ordre de l'index du r�pertoire, ainsi que la liste des fichiers � afficher. Si vous souhaitez d�sactiver cette fonctionnalit�, utilisez l'option IndexOptions IgnoreClient.

Les en-t�tes de tri des colonnes eux-m�mes sont des hyper-liens auto-r�f�rant qui ajoutent les options de tri � la requ�te �num�r�es ci-dessous qui peuvent �tre ajout�es � toute requ�te concernant la ressource r�pertoire.

Notez que l'argument 'P' (pour Pattern) n'est test� qu'apr�s que les directives habituelles IndexIgnore ont �t� trait�es, et que tous les noms de fichiers sont encore assujettis aux m�mes crit�res que pour tout autre listing auto-index�. L'interpr�teur d'arguments de requ�te de mod_autoindex s'arr�te imm�diatement s'il rencontre une option non reconnue. Les arguments de requ�te doivent �tre bien form�s, selon la table ci-dessus.

Les options de requ�tes sont illustr�es par l'exemple ci-dessous, qui peut �tre copi� et coll� dans un fichier header.html. Notez que l'argument inconnu "X", pour le bouton submit, est introduit en dernier afin de s'assurer que tous les arguments ont �t� interpr�t�s avant que mod_autoindex ne rencontre l'entr�e X=Go.

<form action="" method="get">
Montre moi une <select name="F">
<option value="0"> liste simple</option>
<option value="1" selected="selected"> liste avec en-t�tes</option>
<option value="2"> liste avec en-t�te sous forme de table</option>
</select>
tri�e par <select name="C">
<option value="N" selected="selected"> nom</option>
<option value="M"> date de modification</option>
<option value="S"> taille</option>
<option value="D"> description</option>
</select>
<select name="O">
<option value="A" selected="selected"> croissant</option>
<option value="D"> d�croissant</option>
</select>
<select name="V">
<option value="0" selected="selected"> dans l'ordre normal</option>
<option value="1"> en fonction de la version</option>
</select>
correspondant � <input type="text" name="P" value="*" />
<input type="submit" name="X" value="Go" />
</form>

top

AddAlt Directive

Description:Texte optionnel � afficher � la place d'un ic�ne pour un fichier en fonction de son nom
Syntaxe:AddAlt texte fichier [fichier] ...
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:Indexes
Statut:Base
Module:mod_autoindex

La directive AddAlt permet d'afficher un texte optionnel pour un fichier, � la place d'un ic�ne, dans le cas d'un affichage FancyIndexing. fichier est une extension de fichier, un nom de fichier partiel, une expression avec caract�res g�n�riques ou un nom de fichier complet permettant de caract�riser le(s) fichier(s) concern�(s). Si texte contient des espaces, vous devez l'entourer de guillemets ou d'apostrophes (" ou '). Ce texte optionnel sera affich� si le client ne peut pas afficher d'images, si le chargement d'images est d�sactiv� ou si l'ic�ne ne peut pas �tre trouv�.

AddAlt "PDF file" *.pdf
AddAlt Compressed *.gz *.zip *.Z
    
top

AddAltByEncoding Directive

Description:Texte optionnel � afficher � la place d'un ic�ne pour un fichier en fonction de son codage MIME
Syntaxe:AddAltByEncoding texte codage MIME [codage MIME] ...
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:Indexes
Statut:Base
Module:mod_autoindex

La directive AddAltByEncoding permet d'afficher un texte optionnel � la place d'un ic�ne pour un fichier dans le cas d'un affichage FancyIndexing. codage MIME doit �tre un type valide, comme x-compress. Si texte contient des espaces, vous devez l'entourer de guillemets ou d'apostrophes (" ou '). Ce texte optionnel sera affich� si le client ne peut pas afficher d'images, si le chargement d'images est d�sactiv� ou si l'ic�ne ne peut pas �tre trouv�.

      AddAltByEncoding gzip x-gzip
    
top

AddAltByType Directive

Description:Texte optionnel � afficher � la place d'un ic�ne pour un fichier en fonction de son type MIME
Syntaxe:AddAltByType texte type MIME [type MIME] ...
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:Indexes
Statut:Base
Module:mod_autoindex

La directive AddAltByType permet d'afficher un texte optionnel � la place d'un ic�ne pour un fichier dans le cas d'un affichage FancyIndexing. type MIME doit �tre un type MIME valide, comme text/html. Si texte contient des espaces, vous devez l'entourer de guillemets ou d'apostrophes (" ou '). Ce texte optionnel sera affich� si le client ne peut pas afficher d'images, si le chargement d'images est d�sactiv� ou si l'ic�ne ne peut pas �tre trouv�.

      AddAltByType 'Fichier texte' text/plain
    
top

AddDescription Directive

Description:Afficher la description d'un fichier
Syntaxe:AddDescription texte [fichier] ...
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:Indexes
Statut:Base
Module:mod_autoindex

Cette directive permet d'afficher une description pour un fichier, dans le cas d'un affichage FancyIndexing. fichier est une extension de fichier, un nom de fichier partiel, une expression avec caract�res g�n�riques ou un nom de fichier complet permettant de caract�riser le fichier. texte doit �tre entour� de guillemets (").

AddDescription "The planet Mars" mars.gif
AddDescription "My friend Marshall" friends/mars.gif
    

La taille par d�faut, habituelle du champ de description est de 23 octets. L'option IndexOptions SuppressIcon ajoute 6 octets, l'option IndexOptions SuppressSize en ajoute 7 et l'option IndexOptions SuppressLastModified en ajoute 19. Ainsi, la plus grande taille par d�faut qui peut �tre assign�e � la colonne description est de 55 octets.

Comme l'argument fichier peut �tre un nom de fichier partiel, vous devez garder � l'esprit qu'un nom de fichier partiel trop court pourra correspondre � des fichiers non voulus. Par exemple, le.html correspondra au fichier le.html, mais aussi au fichier example.html. En cas d'ambigu�t�, utilisez un nom de fichier aussi complet que possible, et ordonnez votre liste de directives AddDescription en cons�quence.

Voir le mot-cl� DescriptionWidth de la directive module="mod_autoindex">IndexOptions pour plus de d�tails sur la mani�re d'augmenter la taille de cette colonne, ou pour permettre des descriptions de taille illimit�e.

Avertissement

Le texte descriptif d�fini par la directive AddDescription peut contenir des marquages HTML, comme des balises ou des entit�s caract�res. Si la limite de taille de la colonne description venait � tronquer une balise (par exemple couper la fin d'une phrase en caract�res gras), le r�sultat pourrait en affecter toute la suite du listing du r�pertoire.

Arguments avec chemins

Les chemins absolus ne sont actuellement pas support�s et ne peuvent correspondre � aucun chemin r�el � l'ex�cution. Les arguments contenant des chemins relatifs, qui ne devraient �tre normalement utilis�s que dans les fichiers htaccess, sont implicitement pr�fix�s par '*/' afin d'�viter toute association avec des noms de r�pertoires partiels.

top

AddIcon Directive

Description:Ic�ne � afficher pour un fichier en fonction de son nom
Syntaxe:AddIcon ic�ne nom [nom] ...
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:Indexes
Statut:Base
Module:mod_autoindex

Cette directive permet de d�terminer l'ic�ne � afficher � c�t� d'un fichier dont le nom se termine par nom, dans le cas d'un affichage FancyIndexing. ic�ne est une URL relative (�chapp�e par des caract�res '%') vers l'ic�ne, une URL distante pleinement qualifi�e, ou de la forme (alttext,url), o� alttext est le symbole texte correspondant � l'ic�ne � afficher dans les navigateurs en mode texte.

nom correspond � ^^DIRECTORY^^ pour les r�pertoires, ^^BLANKICON^^ pour les lignes vides (pour personnaliser la pr�sentation du listing), une extension de fichier, une expression avec caract�res g�n�riques, un nom de fichier partiel ou un nom de fichier complet.

^^BLANKICON^^ n'est utilis� que pour le formatage, et n'est donc pas n�cessaire si vous utilisez IndexOptions HTMLTable.

#Examples
AddIcon (IMG,/icons/image.png) .gif .jpg .png
AddIcon /icons/dir.png ^^DIRECTORY^^
AddIcon /icons/backup.png *~
    

Lorsque c'est possible, il est pr�f�rable d'utiliser AddIconByType plut�t que AddIcon.

top

AddIconByEncoding Directive

Description:Ic�ne � afficher � c�t� d'un fichier en fonction de son codage MIME
Syntaxe:AddIconByEncoding ic�ne codage MIME [codage MIME] ...
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:Indexes
Statut:Base
Module:mod_autoindex

Cette directive permet de d�terminer l'ic�ne � afficher � c�t� d'un fichier dans le cas d'un affichage FancyIndexing. ic�ne est une URL relative (�chapp�e par des caract�res '%') vers l'ic�ne, une URL pleinement qualifi�e, ou de la forme (alttext,url), o� alttext est le symbole texte correspondant � l'ic�ne � afficher dans les navigateurs en mode texte.

codage MIME doit �tre un codage valide, comme x-compress.

      AddIconByEncoding /icons/compress.png x-compress
    
top

AddIconByType Directive

Description:Ic�ne � afficher � c�t� d'un fichier en fonction de son type MIME
Syntaxe:AddIconByType ic�ne type MIME [type MIME] ...
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:Indexes
Statut:Base
Module:mod_autoindex

Cette directive permet de d�terminer l'ic�ne � afficher � c�t� d'un fichier de type MIME type MIME dans le cas d'un affichage FancyIndexing. ic�ne est une URL relative (�chapp�e par des caract�res '%') vers l'ic�ne, une URL pleinement qualifi�e, ou de la forme (alttext,url), o� alttext est le symbole texte correspondant � l'ic�ne � afficher dans les navigateurs en mode texte.

type MIME est une expression avec caract�res g�n�riques repr�sentant le type MIME.

      AddIconByType (IMG,/icons/image.png) image/*
    
top

DefaultIcon Directive

Description:Ic�ne � afficher par d�faut lorsqu'aucun ic�ne sp�cifique n'est pr�cis�
Syntaxe:DefaultIcon chemin URL
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:Indexes
Statut:Base
Module:mod_autoindex

La directive DefaultIcon permet de d�finir l'ic�ne � afficher � c�t� d'un fichier lorsqu'aucun ic�ne sp�cifique n'a �t� pr�cis�, dans le cas d'un affichage FancyIndexing. chemin URL est une URL relative (�chapp�e par des caract�res '%') vers l'ic�ne ou une URL pleinement qualifi�e.

      DefaultIcon /icon/unknown.png
    
top

HeaderName Directive

Description:Nom du fichier qui sera ins�r� au d�but de la page contenant l'index
Syntaxe:HeaderName nom fichier
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:Indexes
Statut:Base
Module:mod_autoindex

La directive HeaderName permet de d�finir le nom du fichier qui sera ins�r� au d�but de la page contenant l'index. nom fichier est le nom du fichier � inclure.

      HeaderName HEADER.html
    

Les deux directives HeaderName et ReadmeName traitent maintenant nom fichier comme un chemin URI relatif au chemin utilis� pour acc�der au r�pertoire faisant l'objet de l'index. Si nom fichier commence par un slash '/', il sera consid�r� comme relatif au r�pertoire d�fini par la directive DocumentRoot.

        HeaderName /include/HEADER.html
      

nom fichier doit correspondre � un document dont le type MIME est du style text/* (par exemple text/html, text/plain, etc...). Cela signifie que nom fichier peut faire r�f�rence � un script CGI si le v�ritable type MIME du script (et non celui de sa sortie) est marqu� comme text/html par exemple � l'aide d'une directive comme :

        AddType text/html .cgi
      

Une n�gociation de contenu sera effectu�e si Options MultiViews a �t� pr�cis�. Si nom fichier correspond � un document statique text/html (et non � un script CGI), et une des deux options Includes ou IncludesNOEXEC est activ�e, le fichier sera trait� en tant qu'inclusion c�t� serveur (Server Side Include) (voir la documentation de mod_include).

Si le fichier sp�cifi� par la directive HeaderName contient les en-t�tes d'un document HTML ((<html>, <head>, etc...), vous serez probablement amen� � d�finir IndexOptions +SuppressHTMLPreamble, de mani�re � ce que ces balises ne soient pas r�p�t�es.

Voir aussi

top

IndexHeadInsert Directive

Description:Ins�re du texte dans la section HEAD de la page d'index.
Syntaxe:IndexHeadInsert "marque ..."
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:Indexes
Statut:Base
Module:mod_autoindex

La directive IndexHeadInsert permet de sp�cifier une cha�ne de caract�res � ins�rer dans la section <head> du code HTML g�n�r� pour la page d'index.

      IndexHeadInsert "<link rel=\"sitemap\" href=\"/sitemap.html\">"
    
top

IndexIgnore Directive

Description:Ajouts � la liste des fichiers � cacher lors de l'affichage de l'index d'un r�pertoire
Syntaxe:IndexIgnore fichier [fichier] ...
D�faut:IndexIgnore "."
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:Indexes
Statut:Base
Module:mod_autoindex

La directive IndexIgnore permet d'effectuer des ajouts � la liste des fichiers � cacher lors de l'affichage de l'index d'un r�pertoire. fichier est une expression avec caract�res g�n�riques de style shell ou un nom de fichier complet. Plusieurs directives IndexIgnore effectuent des ajouts � la liste, et ne remplacent pas la liste des fichiers � ignorer. Par d�faut, la liste contient . (le r�pertoire courant).

      IndexIgnore .??* *~ *# HEADER* README* RCS CVS *,v *,t
    

Expressions rationnelles

Cette directive est actuellement incompatible avec les sections de configuration qui comportent des arguments avec expressions rationnelles comme <DirectoryMatch>

top

IndexIgnoreReset Directive

Description:Vide la liste des fichiers � cacher lors de l'affichage du contenu d'un r�pertoire
Syntaxe:IndexIgnoreReset ON|OFF
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:Indexes
Statut:Base
Module:mod_autoindex
Compatibilit�:Versions 2.3.10 et sup�rieures

La directive IndexIgnoreReset supprime toute liste de fichiers d�finie par la directive IndexIgnore et h�rit�e par ailleurs d'autres sections de configuration.

<Directory /var/www>
    IndexIgnore *.bak .??* *~ *# HEADER* README* RCS CVS *,v *,t
</Directory>
<Directory /var/www/backups>
    IndexIgnoreReset ON
    IndexIgnore .??* *# HEADER* README* RCS CVS *,v *,t
</Directory>
    

Revoyez la configuration par d�faut pour une liste de mod�les que vous voulez ignorer explicitement apr�s usage de cette directive.

top

IndexOptions Directive

Description:Diverses options de configuration pour l'indexation d'un r�pertoire
Syntaxe:IndexOptions [+|-]option [[+|-]option] ...
D�faut:Par d�faut, aucune option n'est activ�e.
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:Indexes
Statut:Base
Module:mod_autoindex

La directive IndexOptions permet de sp�cifier les options de configuration de l'indexation du r�pertoire. option peut prendre l'une des valeurs suivantes :

AddAltClass
Ajoute une d�claration de classe CSS suppl�mentaire � chaque enregistrement de la table du listing du r�pertoire dans le cas o� IndexOptions HTMLTable est activ� et o� un IndexStyleSheet a �t� d�fini. Plut�t que d'appliquer � chaque enregistrement de la table les classes standards even et odd, c'est ici une classe even-ALT ou odd-ALT qui sera appliqu�e, o� ALT sera soit le texte alternatif standard associ� au style du fichier (par exemple snd, txt, img, etc...), soit le texte alternatif d�fini par une des diff�rentes directives AddAlt*.
Charset=jeu de caract�res (Versions 2.0.61 et sup�rieures du serveur HTTP Apache)
Le mot-cl� Charset vous permet de sp�cifier le jeu de caract�res de la page g�n�r�e. La valeur par d�faut est UTF-8 sous Windows et MAC OS X, et ISO-8859-1 dans les autres cas (en fait selon que le syst�me de fichiers sous-jacent utilise les noms de fichiers en Unicode ou non).
        IndexOptions Charset=UTF-8
      
DescriptionWidth=[n | *]
Le mot-cl� DescriptionWidth vous permet de sp�cifier la taille en caract�res de la colonne description.
Avec -DescriptionWidth (ou si l'option n'est pas d�finie), mod_autoindex calcule la meilleure taille.
DescriptionWidth=n fixe la taille de la colonne � n octets.
DescriptionWidth=* ajuste la taille de la colonne � la plus longue cha�ne de description.
Voir la section concernant AddDescription pour les dangers inh�rants � la troncature des descriptions.
FancyIndexing
Cette option active l'indexation "am�lior�e" des r�pertoires, c'est � dire avec en-t�tes de colonnes sous forme d'hyper-liens auto-r�f�rants.
FoldersFirst
Lorsque cette option est activ�e, la liste des sous-r�pertoires appara�tra toujours en premier, suivie de la liste des fichiers normaux du r�pertoire. Le listing comporte principalement deux parties, les fichiers et les sous-r�pertoires, chacun d'eux �tant tri� s�par�ment et les sous-r�pertoires affich�s en premier. Par exemple, si l'ordre de tri est d�croissant par nom, et si FoldersFirst est activ�, le sous-r�pertoire Zed sera affich� avant le sous-r�pertoire Beta, qui sera lui-m�me affich� avant les fichiers normaux Gamma et Alpha. Cette option n'a d'effet que si FancyIndexing est aussi activ�.
HTMLTable
Cette option pour l'affichage FancyIndexing permet de construire une table simple pour l'affichage de l'index du r�pertoire. Cette option s'av�rera particuli�rement n�cessaire pour les plates-formes o� utf-8 est activ� et dans le cas o� les noms de fichiers ou les cha�nes de description alternent entre les ordres de lecture gauche � droite et droite � gauche.
IconsAreLinks
Configure la partie r�serv�e aux ic�nes de l'ancrage pour le nom de fichier, dans le cas d'un affichage "am�lior�".
IconHeight[=pixels]
Si cette option est pr�sente, en combinaison avec IconWidth, le serveur va inclure les attributs height et width dans la balise img qui r�f�rence le fichier de l'ic�ne. Ceci va permettre au navigateur de pr�voir les caract�ristiques de la page sans devoir attendre que toutes les images aient �t� charg�es. En l'absence de cette option, c'est la hauteur standard d�finie par le logiciel Apache httpd qui est choisie comme valeur par d�faut.
IconWidth[=pixels]
Si cette option est pr�sente, en combinaison avec IconHeight, le serveur va inclure les attributs height et width dans la balise img qui r�f�rence le fichier de l'ic�ne. Ceci va permettre au navigateur de pr�voir les caract�ristiques de la page sans devoir attendre que toutes les images aient �t� charg�es. En l'absence de cette option, c'est la largeur standard d�finie par le logiciel Apache httpd qui est choisie comme valeur par d�faut.
IgnoreCase
Si cette option est activ�e, les noms sont tri�s sans tenir compte de la casse. Par exemple, si le tri s'effectue sur les noms dans l'ordre croissant, et si IgnoreCase est activ�, le fichier Zeta appara�tra apr�s le fichier alfa (Note : le fichier GAMMA appara�tra toujours avant le fichier gamma).
IgnoreClient
Si cette option est activ�e, mod_autoindex va ignorer toutes les variables de requ�te fournies par le client, y compris les informations de tri (ce qui implique l'activation de l'option SuppressColumnSorting).
NameWidth=[n | *]
Le mot-cl� NameWidth vous permet de sp�cifier la largeur en octets de la colonne correspondant au nom du fichier.
Avec -NameWidth (ou si l'option n'est pas d�finie), mod_autoindex va calculer la meilleure largeur possible, mais jusqu'� une largeur maximale de 20 octets.
NameWidth=n fixe la largeur de la colonne � n octets.
NameWidth=* d�finit la largeur de colonne � la valeur n�cessaire.
ScanHTMLTitles
L'activation de cette option permet d'extraire le titre des documents HTML dans le cas d'un affichage "am�lior�". Si le fichier ne poss�de aucune description d�finie par la directive AddDescription, httpd va lire le document pour tenter d'en extraire le titre. Ce processus est co�teux en ressources disque et CPU.
ShowForbidden
Si cette option est activ�e, Apache httpd affichera les fichiers normalement cach�s suite au retour des valeurs HTTP_UNAUTHORIZED ou HTTP_FORBIDDEN par la sous-requ�te.
SuppressColumnSorting
Si cette option est activ�e, Apache httpd supprimera les liens hyper-texte dans les en-t�tes de colonnes dans le cas d'un affichage "am�lior�". Par d�faut, ces en-t�tes constituent des liens hyper-texte, et la s�lection de l'un d'entre eux va trier l'index du r�pertoire en fonction des valeurs de la colonne correspondante. Cependant, les arguments de la cha�ne de param�tres de la requ�te ajout�s � l'URL seront toujours ignor�s. Ce comportement est contr�l� par l'option IndexOptions IgnoreClient.
SuppressDescription
L'activation de cette option va supprimer la description des fichiers dans le cas d'un affichage "am�lior�". Par d�faut aucune description de fichier n'est d�finie, et par cons�quent l'utilisation de cette option va permettre de r�cup�rer un espace � l'�cran de 23 caract�res pouvant �tre utilis� pour autre chose. Voir la directive AddDescription pour plus d'informations � propos de la d�finition des descriptions de fichiers. Voir aussi l'option d'index DescriptionWidth pour limiter la taille de la colonne description.
SuppressHTMLPreamble
Si le r�pertoire contient effectivement le fichier sp�cifi� par la directive HeaderName, le module inclut en g�n�ral le contenu du fichier apr�s avoir ins�r� un pr�ambule HTML standard (<html>, <head>, etc...). L'activation de l'option SuppressHTMLPreamble supprime l'insertion de ce pr�ambule, et le module va alors commencer l'affichage directement par le contenu du fichier d'en-t�te. Dans ce cas par contre, le fichier d'en-t�te doit contenir des instructions HTML appropri�es. S'il n'y a pas de fichier d'en-t�te, le pr�ambule est g�n�r� comme dans le cas g�n�ral. Si vous sp�cifiez aussi une directive ReadmeName, et si ce fichier existe, les balises de fermeture closing </body></html> seront aussi omises dans la sortie, en supposant que vous ayez plac� ces balises de fermeture dans ce fichier.
SuppressIcon
L'activation de cette option supprime l'affichage des ic�nes dans le cas d'un affichage "am�lior�". La combinaison de SuppressIcon et SuppressRules permet de g�n�rer une sortie au format HTML 3.2 qui, selon les derni�res sp�cifications, interdit les �l�ments img et hr dans les blocs pre (utilis�s pour formater les affichages "am�lior�s").
SuppressLastModified
L'activation de cette option supprime l'affichage de la date de derni�re modification dans le cas d'un affichage "am�lior�".
SuppressRules
L'activation de cette option supprime l'affichage des lignes horizontales (�l�ments hr) dans les index de r�pertoires. La combinaison de SuppressIcon et SuppressRules permet de g�n�rer une sortie au format HTML 3.2 qui, selon les derni�res sp�cifications, interdit les �l�ments img et hr dans les blocs pre (utilis�s pour formater les affichages "am�lior�s").
SuppressSize
L'activation de cette option supprime l'affichage de la taille du fichier dans le cas d'un affichage "am�lior�".
TrackModified
Cette option renvoie les valeurs Last-Modified et ETag pour le r�pertoire index� dans l'en-t�te HTTP. Elle n'est valide que si le syst�me d'exploitation et le syst�me de fichiers renvoient des r�sultats appropri�s pour la fonction stat(). C'est le cas de certains syst�mes Unix, ainsi que JFS sous OS/2 ou les volumes NTFS sous Win32. Ce n'est par contre pas le cas des volumes FAT Win32 et OS/2. Lorsque cette option est activ�e, le client ou le mandataire peuvent d�tecter les changements dans la liste des fichiers lorsqu'ils effectuent une requ�te HEAD. Notez que certains syst�mes d'exploitation d�tectent correctement les nouveaux fichiers et les fichiers supprim�s, mais ne d�tectent pas les modifications de tailles ou de dates des fichiers du r�pertoire. Les modifications de taille ou de date d'un fichier existant ne mettent pas � jour l'en-t�te Last-Modified sur toutes les plate-formes Unix. Si c'est le cas, laissez cette option d�sactiv�e.
Type=type MIME (Versions 2.0.61 et sup�rieures du serveur HTTP Apache)
Le mot-cl� Type vous permet de sp�cifier le type MIME de la page g�n�r�e. La valeur par d�faut est text/html.
        IndexOptions Type=text/plain
      
VersionSort (Versions 2.0a3 et sup�rieures du serveur HTTP Apache)
Le mot-cl� VersionSort permet de trier les fichiers contenant des num�ros de version d'une mani�re sp�cifique. Les cha�nes sont tri�es comme d'habitude, except� les sous-cha�nes de chiffres du nom de fichier et de sa description qui sont compar�es en fonction de leur valeur num�rique.

Exemple :

foo-1.7
foo-1.7.2
foo-1.7.12
foo-1.8.2
foo-1.8.2a
foo-1.12

Si le nombre commence par le chiffre 0, il est consid�r� comme la partie fractionnaire d'un nombre :

foo-1.001
foo-1.002
foo-1.030
foo-1.04

XHTML (Versions 2.0.49 et sup�rieures du serveur HTTP Apache)
Le mot-cl� XHTML enjoint mod_autoindex de g�n�rer du code XHTML 1.0 au lieu de HTML 3.2.
Options d'index incr�mentales

Vous devez porter une attention particuli�re � la mani�re dont les IndexOptions multiples sont trait�es.

  • Plusieurs directives IndexOptions apparaissant dans la m�me section directory sont maintenant fusionn�es. Le r�sultat de :
    <Directory /foo>
        IndexOptions HTMLTable
        IndexOptions SuppressColumnsorting
    </Directory>
         

    est �quivalent �

           IndexOptions HTMLTable SuppressColumnsorting
         
  • L'ajout de la syntaxe incr�mentale (en pr�fixant les mots-cl�s avec + ou -).

Chaque fois qu'un mot-cl� pr�fix� par '+' ou '-' est trouv�, il est appliqu� aux d�finitions des IndexOptions courantes (qui ont �t� �ventuellement h�rit�es d'un directory de niveau sup�rieur). Par contre, si un mot-cl� non pr�fix� est trouv�, il supprime toutes les definitions h�rit�es, ainsi que toute d�finition incr�mentale. Consid�rons l'exemple suivant :

IndexOptions +ScanHTMLTitles -IconsAreLinks FancyIndexing
IndexOptions +SuppressSize

L'effet global est �quivalent � l'effet qu'aurait provoqu� IndexOptions FancyIndexing +SuppressSize, car l'option non pr�fix�e FancyIndexing annule les mots-cl�s incr�mentaux situ�s avant elle, mais leur permet ensuite de s'incr�menter � nouveau.

Pour d�finir inconditionnellement les IndexOptions pour un r�pertoire particulier, tout en supprimant les d�finitions h�rit�es, sp�cifiez les mots-cl�s sans pr�fixe + ou -

top

IndexOrderDefault Directive

Description:D�finit l'ordre d'affichage par d�faut d'un index de r�pertoire
Syntaxe:IndexOrderDefault Ascending|Descending Name|Date|Size|Description
D�faut:IndexOrderDefault Ascending Name
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:Indexes
Statut:Base
Module:mod_autoindex

La directive IndexOrderDefault s'utilise en combinaison avec l'option d'index FancyIndexing. Par d�faut, les index de r�pertoires "am�lior�s" sont affich�s selon l'ordre croissant des noms de fichiers ; la directive IndexOrderDefault vous permet de modifier ce comportement.

La directive IndexOrderDefault accepte deux arguments. Le premier est soit Ascending, soit Descending, et indique l'ordre de tri. Le second doit prendre une des valeurs Name, Date, Size, ou Description, et permet d'identifier la cl� primaire. La cl� secondaire est toujours le nom du fichier selon un ordre croissant.

Si vous le d�sirez, vous pouvez emp�cher le client de modifier l'ordre de tri de la liste en ajoutant l'option d'index SuppressColumnSorting qui supprime le lien de d�finition du tri de l'en-t�te de la colonne, ainsi que l'option IgnoreClient qui emp�che ce m�me client de passer outre vos pr�f�rences de tri en ajoutant manuellement des options de tri � la cha�ne de param�tres de la requ�te.

top

IndexStyleSheet Directive

Description:Ajoute une feuille de style CSS � l'index du r�pertoire
Syntaxe:IndexStyleSheet chemin-url
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:Indexes
Statut:Base
Module:mod_autoindex

La directive IndexStyleSheet permet de d�finir le nom du fichier qui servira de feuille de style CSS pour l'index.

      IndexStyleSheet "/css/style.css"
    

L'utilisation de cette directive en conjonction avec IndexOptions HTMLTable ajoute plusieurs classes CSS au document HTML r�sultant. Un identifiant CSS indexlist est attribu� � l'ensemble de la table et les classes suivantes sont associ�es aux diff�rentes parties du listing :

ClasseD�finition
tr.indexheadLigne d'en-t�te du listing
th.indexcolicon and td.indexcolicon Colonne de l'ic�ne
th.indexcolname and td.indexcolname Colonne du nom du fichier
th.indexcollastmod and td.indexcollastmod Colonne de la date de derni�re modification
th.indexcolsize and td.indexcolsize Colonne de la taille du fichier
th.indexcoldesc and td.indexcoldesc Colonne de la description
tr.breakrow Pied de page
tr.odd and tr.even Alternance des lignes paires et impaires
top

ReadmeName Directive

Description:Nom du fichier dont le contenu sera ins�r� � la fin de l'index
Syntaxe:ReadmeName nom-fichier
Contexte:configuration du serveur, serveur virtuel, r�pertoire, .htaccess
AllowOverride:Indexes
Statut:Base
Module:mod_autoindex

La directive ReadmeName permet de d�finir le nom du fichier dont le contenu sera ajout� � la fin de l'index. nom-fichier est le nom du fichier � inclure, et est consid�r� comme relatif au r�pertoire faisant l'objet de l'index. Si nom-fichier commence par un slash '/', comme dans l'exemple 2, il sera consid�r� comme relatif au r�pertoire d�fini par la directive DocumentRoot.

# Example 1
ReadmeName FOOTER.html
    
# Example 2
ReadmeName /include/FOOTER.html
    

Voir aussi la directive HeaderName, o� cette fonctionnalit� est d�crite plus en d�tails.

Langues Disponibles:  en  |  fr  |  ja  |  ko  |  tr 

top

Commentaires

Notice:
This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our mailing lists.