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