<-
Apache > HTTP Server > Documentation > Version 2.0 > Modules

Apache Модуль mod_autoindex

Description: производит директивные индексы, автоматически, подобный Unix ls командовать или Win32 dir команда снаряда
Status: основа
Module Identifier: autoindex_module
Source File: mod_autoindex.c

резюме

индекс справочника может прибыть от одного из двух источников:

две функции отделены так, чтобы Вы могли полностью удалить (или заменить), автоматическое поколение индекса должно Вы хотеть к.

автоматическому поколению индекса позволяют с использованием Options +Indexes . см. Options директива для большего количества деталей.

если FancyIndexing выбор дается с IndexOptions директива, удары головой колонки - связи, которые управляют заказом показа. Если Вы выберете связь удара головой, то внесение в список будет восстановлено, сортировано ценностями в той колонке. Отбор того же самого удара головой неоднократно пуговицы между возрастанием и спускающимся заказом. Эти связи удара головой колонки подавлены с IndexOptions директива SuppressColumnSorting выбор.

отметить, что, когда показ сортирован "Размером", это- фактический размер файлов, это используется, не показанная ценность - так 1010-байтовый файл, будет всегда показываться, перед 1011-байтовым файлом (если в порядке возрастания) даже при том, что их обоих показывают как "1 КБ".

директивы

темы

top

Autoindex Request Query Arguments

Apache 2.0.23 реорганизовал Аргументы Вопроса за Сортировку Колонки, и вводил всю группу новых вариантов вопроса. Эффективно устранять всего клиента управляют по продукции, IndexOptions IgnoreClient выбор был введен.

колонка, сортирующая сами удары головой самоссылается, осуществляет гиперссылку, которые добавляют варианты вопроса вида, показанные ниже. Любой выбор ниже может быть добавлен к любому запросу о директивном ресурсе.

отметить, что 'аргумент вопроса P'attern проверен после обычное IndexIgnore директивы обработаны, и все названия файла все еще подвергаются тем же самым критериям как любое другое внесение в список автоиндекса. Анализатор Аргументов Вопроса в mod_autoindex остановится резко, когда с непризнанным выбором сталкиваются. Аргументы Вопроса должны быть хорошо сформированы, согласно столу выше.

простой пример ниже, который может быть подрезанным и спасенным в header.html файл, иллюстрирует эти варианты вопроса. Отметьте, что неизвестное "X" аргумент, для представленной кнопки, перечислен последний, чтобы уверить, что аргументы все разобраны прежде, чем mod_autoindex сталкивается со входом X=Go.

<form action="" method="get">
Show me a <select name="F">
<option value="0"> Plain list</option>
<option value="1" selected="selected"> Fancy list</option>
<option value="2"> Table list</option>
</select>
Sorted by <select name="C">
<option value="N" selected="selected"> Name</option>
<option value="M"> Date Modified</option>
<option value="S"> Size</option>
<option value="D"> Description</option>
</select>
<select name="O">
<option value="A" selected="selected"> Ascending</option>
<option value="D"> Descending</option>
</select>
<select name="V">
<option value="0" selected="selected"> in Normal order</option>
<option value="1"> in Version order</option>
</select>
Matching <input type="text" name="P" value="*" />
<input type="submit" name="X" value="Go" />
</form>

top

AddAlt Directive

Description: дополнительный текст, чтобы показать для файла, вместо изображения, отобранного именем файла
Syntax: AddAlt string file [ file ] ...
Context: сервер config, действительный хозяин, справочник, .htaccess
Override: индексы
Status: основа
Module: mod_autoindex

AddAlt обеспечивает дополнительный текст, чтобы показать для файла, вместо изображения, для FancyIndexing . файл является расширением файла, частичным именем файла, выражением группового символа или полным именем файла для файлов, чтобы описать. Если вереница содержит любой whitespace, Вы должны приложить это в кавычках ( " или ' ). Этот дополнительный текст показан, если клиент неспособен к изображению, имеет изображение, загружающее инвалидов, или не в состоянии восстановить изображение.

Examples

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

top

AddAltByEncoding Directive

Description: дополнительный текст, чтобы показать для файла вместо изображения, отобранного ЗАШИФРОВЫВАНИЕМ ПАНТОМИМЫ
Syntax: AddAltByEncoding string MIME-encoding [ MIME-encoding ] ...
Context: сервер config, действительный хозяин, справочник, .htaccess
Override: индексы
Status: основа
Module: mod_autoindex

AddAltByEncoding обеспечивает дополнительный текст, чтобы показать для файла, вместо изображения, для FancyIndexing . ЗАШИФРОВЫВАНИЕ ПАНТОМИМЫ является действительным довольным зашифровыванием, типа x-compress . если вереница содержит любой whitespace, Вы должны приложить это в кавычках ( " или ' ). Этот дополнительный текст показан, если клиент неспособен к изображению, имеет изображение, загружающее инвалидов, или не в состоянии восстановить изображение.

Example

AddAltByEncoding gzip x-gzip

top

AddAltByType Directive

Description: дополнительный текст, чтобы показать для файла, вместо изображения, отобранного довольным типом MIME
Syntax: AddAltByType string MIME-type [ MIME-type ] ...
Context: сервер config, действительный хозяин, справочник, .htaccess
Override: индексы
Status: основа
Module: mod_autoindex

AddAltByType заставляет дополнительный текст показывать для файла, вместо изображения, для FancyIndexing . ТИП ПАНТОМИМЫ является действительным довольным типом, типа text/html . если вереница содержит любой whitespace, Вы должны приложить это в кавычках ( " или ' ). Этот дополнительный текст показан, если клиент неспособен к изображению, имеет изображение, загружающее инвалидов, или не в состоянии восстановить изображение.

Example

AddAltByType 'plain text' text/plain

top

AddDescription Directive

Description: описание, чтобы показать для файла
Syntax: AddDescription string file [ file ] ...
Context: сервер config, действительный хозяин, справочник, .htaccess
Override: индексы
Status: основа
Module: mod_autoindex

это заставляет описание показывать для файла, для FancyIndexing . файл является расширением файла, частичным именем файла, выражением группового символа или полным именем файла для файлов, чтобы описать. вереница приложен в двойных кавычках ( " ).

Example

AddDescription "The planet Mars" /web/pics/mars.gif

типичная, область описания по умолчанию 23 байта шириной. Еще 6 байтов добавлены IndexOptions SuppressIcon выбор, 7 байтов добавлены IndexOptions SuppressSize выбор, и 19 байтов добавлены IndexOptions SuppressLastModified выбор. Поэтому, самый широкий неплатеж, колонка описания когда-либо назначается, - 55 байтов.

см. DescriptionWidth IndexOptions ключевое слово для деталей относительно отвергания размера этой колонки, или позволения описаний неограниченной длины.

предостережение

описательный текст, определенный с AddDescription может содержать повышение HTML, типа объектов характера и признаков. Если ширина колонки описания, должный случиться, усекает теговый элемент (, типа отключения конца bolded фразы), результаты могут затронуть остальную часть директивного внесения в список.

top

AddIcon Directive

Description: изображение, чтобы показать для файла, отобранного по имени
Syntax: AddIcon icon name [ name ] ...
Context: сервер config, действительный хозяин, справочник, .htaccess
Override: индексы
Status: основа
Module: mod_autoindex

это заставляет изображение показывать рядом с файлом, заканчивающимся в название для FancyIndexing . изображение является любой (% - убежал), относительный URL к изображению, или формата ( alttext , url ) где alttext является признаком текста, данным для изображения для неграфических браузеров.

название является также ^^DIRECTORY^^ для справочников, ^^BLANKICON^^ для чистых линий (чтобы форматировать список правильно), расширение файла, выражение группового символа, частичное имя файла или полное имя файла.

Examples

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

AddIconByType должен использоваться в предпочтении к AddIcon , когда возможно.

top

AddIconByEncoding Directive

Description: изображение, чтобы показать рядом с файлами, отобранными довольным зашифровыванием ПАНТОМИМЫ
Syntax: AddIconByEncoding icon MIME-encoding [ MIME-encoding ] ...
Context: сервер config, действительный хозяин, справочник, .htaccess
Override: индексы
Status: основа
Module: mod_autoindex

это заставляет изображение показывать рядом с файлами с FancyIndexing . изображение является любой (% - убежал), относительный URL к изображению, или формата ( alttext , url ) где alttext является признаком текста, данным для изображения для неграфических браузеров.

ЗАШИФРОВЫВАНИЕ ПАНТОМИМЫ является соответствием выражения группового символа, требовал довольного зашифровывания.

Example

AddIconByEncoding /icons/compress.xbm x-compress

top

AddIconByType Directive

Description: изображение, чтобы показать рядом с файлами, отобранными довольным типом MIME
Syntax: AddIconByType icon MIME-type [ MIME-type ] ...
Context: сервер config, действительный хозяин, справочник, .htaccess
Override: индексы
Status: основа
Module: mod_autoindex

это заставляет изображение показывать рядом с файлами типа ТИП ПАНТОМИМЫ для FancyIndexing . изображение является любой (% - убежал), относительный URL к изображению, или формата ( alttext , url ) где alttext является признаком текста, данным для изображения для неграфических браузеров.

ТИП ПАНТОМИМЫ является соответствием выражения группового символа, требовал типов пантомимы.

Example

AddIconByType (IMG,/icons/image.xbm) image/*

top

DefaultIcon Directive

Description: изображение, чтобы показать для файлов, когда никакое определенное изображение не формируется
Syntax: DefaultIcon url-path
Context: сервер config, действительный хозяин, справочник, .htaccess
Override: индексы
Status: основа
Module: mod_autoindex

DefaultIcon директива заставляет изображение показывать для файлов, когда никакое определенное изображение не известно, FancyIndexing . дорожка URL является (% - убежал), относительный URL к изображению.

Example

DefaultIcon /icon/unknown.xbm

top

HeaderName Directive

Description: название файла, который будет вставлен наверху внесения в список индекса
Syntax: HeaderName filename
Context: сервер config, действительный хозяин, справочник, .htaccess
Override: индексы
Status: основа
Module: mod_autoindex

HeaderName директива устанавливает название файла, который будет вставлен наверху внесения в список индекса. имя файла является названием файла, чтобы включить.

Example

HeaderName HEADER.html

И HeaderName и ReadmeName теперь удовольствие имя файла поскольку дорожка ТУРОВ относительно того имела обыкновение получать доступ к внесенному в указатель справочнику. Если имя файла начинается с разреза, это будет взято, чтобы быть относительно DocumentRoot .

Example

HeaderName /include/HEADER.html

имя файла должен решить к документу с главным довольным типом text/* ( например. , text/html , text/plain , и т.д.). Это означает это имя файла может обратиться к подлиннику CGI, если фактический тип файла подлинника (в противоположность его продукции) отмечен как text/html , типа с директивой как:

AddType text/html .cgi

Content negotiation будет выполнен если Options MultiViews является в действительности. Если имя файла решения к статическому text/html документ (не подлинник CGI) и любой options Includes или IncludesNOEXEC позволяется, файл будет обработан для стороны сервера, включает (см. mod_include документация).

если файл, определенный HeaderName содержит начала документа HTML (<html>, <head>, и т.д.), тогда Вы будете вероятно хотеть установить IndexOptions +SuppressHTMLPreamble , так, чтобы эти признаки были не повторены.

top

IndexIgnore Directive

Description: добавляет к списку файлов, чтобы скрыться, перечисляя справочник
Syntax: IndexIgnore file [ file ] ...
Context: сервер config, действительный хозяин, справочник, .htaccess
Override: индексы
Status: основа
Module: mod_autoindex

IndexIgnore директива добавляет к списку файлов, чтобы скрыться, перечисляя справочник. файл является выражением группового символа стиля снаряда или полным именем файла. Многократные директивы IndexIgnore добавляют к списку, а не замене списка игнорируемых файлов. По умолчанию, список содержит . (текущий справочник).

IndexIgnore README .htaccess *.bak *~

top

IndexOptions Directive

Description: различные параметры настройки конфигурации для директивной индексации
Syntax: IndexOptions [+|-] option [[+|-] option ] ...
Context: сервер config, действительный хозяин, справочник, .htaccess
Override: индексы
Status: основа
Module: mod_autoindex

IndexOptions директива определяет поведение директивной индексации. выбор может быть один из

DescriptionWidth=[ n | *] ( Apache 2.0.23 и позже )
DescriptionWidth ключевое слово позволяет Вам определять ширину колонки описания в характерах.
-DescriptionWidth (или сброс), позволяет mod_autoindex вычислять лучшую ширину.
DescriptionWidth= n устанавливает ширину колонки к n широкие байты.
DescriptionWidth=* выращивает колонку к ширине, необходимой приспособить самую длинную вереницу описания.
см. секцию на AddDescription для опасностей, врожденных усечению описаний.
FancyIndexing
это поворачивается на причудливой индексации справочников.
FoldersFirst ( Apache 2.0.23 и позже )
если этот выбор будет позволяться, то поддирективные списки будут всегда кажьтесь первыми, сопровождаемыми нормальными файлами в справочнике. Внесение в список в основном сломано в два компонента, файлы и подсправочники, и каждый сортирован отдельно и затем показанные подсправочники сначала. Например, если заказ вида спускается по имени, и FoldersFirst позволяется, подсправочник Zed будет перечислен перед подсправочником Beta , который будет перечислен перед нормальными файлами Gamma и Alpha . этот выбор только имеет эффект если FancyIndexing также позволяется.
HTMLTable ( экспериментальный, Apache 2.0.23 и позже )
этот экспериментальный выбор с FancyIndexing строит простой стол для причудливого директивного внесения в список. Отметьте, что это будет путать старшие браузеры. Особенно необходимо, если названия файла или текст описания чередуются между слева направо, и право-к-левому, читая заказ, как может случайно встретить WinNT, или другой utf-8 позволил платформы.
IconsAreLinks
это делает часть изображений якоря для имени файла, для причудливой индексации.
IconHeight[= pixels ]
присутствие этого выбора, когда используется с IconWidth, заставит сервер включать height и width признаки в img признак для изображения файла. Это позволяет браузеру предвычислять расположение страницы, не имея необходимость ждать, пока все изображения не были загружены. Если никакая ценность не дается для выбора, это, неплатежи к стандартной высоте изображений снабжали Apacheским программным обеспечением.
IconWidth[= pixels ]
присутствие этого выбора, когда используется с IconHeight , заставит сервер включать height и width признаки в img признак для изображения файла. Это позволяет браузеру предвычислять расположение страницы, не имея необходимость ждать, пока все изображения не были загружены. Если никакая ценность не дается для выбора, это, неплатежи к стандартной ширине изображений снабжали Apacheским программным обеспечением.
IgnoreCase
если этот выбор позволяется, названия сортированы в нечувствительной к случаю манере. Например, если заказ вида будет подниматься по имени, и IgnoreCase позволяется, то Дзэта файла будет перечислена после травы альфа файла (Примечание: ГАММА файла будет всегда перечисляться перед гаммой файла).
IgnoreClient
эти причины выбора mod_autoindex игнорировать все переменные вопроса от клиента, включая заказ вида (подразумевает SuppressColumnSorting .)
NameWidth=[ n | *]
NameWidth ключевое слово позволяет Вам определять ширину колонки имени файла в байтах.
-NameWidth (или сброс), позволяет mod_autoindex вычислять лучшую ширину.
NameWidth= n устанавливает ширину колонки к n широкие байты.
NameWidth=* выращивает колонку к необходимой ширине.
ScanHTMLTitles
это позволяет извлечение названия из документов HTML для причудливой индексации. Если файлу не давали описание AddDescription тогда httpd прочитает документ за ценность title элемент. Это - центральный процессор и интенсивный диск.
SuppressColumnSorting
если определено, Apache не будет делать заголовки колонки в директивном внесении в список FancyIndexed в связи для сортировки. Поведение по умолчанию - для них, чтобы быть связями; отбор заголовка колонки сортирует директивное внесение в список ценностями в той колонке. до Apacheа 2.0.23, это также повреждало парсинг Аргументов Вопроса за вереницу вида. тем поведением теперь управляют IndexOptions IgnoreClient в Apacheе 2.0.23.
SuppressDescription
это подавит описание файла в причудливых списках индексации. По умолчанию, никакие описания файла не определены, и таким образом использование этого выбора восстановит 23 характера места экрана, чтобы использовать для чего - то еще. См. AddDescription для информации об урегулировании описания файла. См. также DescriptionWidth выбор индекса ограничивать размер колонки описания.
SuppressHTMLPreamble
если справочник фактически содержит файл, определенный HeaderName директива, модуль обычно включает содержание файла после стандартной преамбулы HTML ( <html> , <head> , и так далее ). SuppressHTMLPreamble выбор повреждает это поведение, заставляя модуль начать показ с содержания файла удара головой. Файл удара головой должен содержать соответствующие инструкции HTML в этом случае. Если нет никакого файла удара головой, преамбула произведена как обычно.
SuppressIcon ( Apache 2.0.23 и позже )
это подавит изображение в причудливых списках индексации. Объединение обоих SuppressIcon и SuppressRules приводит к надлежащему HTML 3.2 продукции, которые заключительной спецификацией запрещают img и hr элементы от pre блок (имел обыкновение форматировать списки FancyIndexed.)
SuppressLastModified
это подавит показ последней даты модификации, в причудливых списках индексации.
SuppressRules ( Apache 2.0.23 и позже )
это подавит горизонтальные линии правила ( hr элементы) в директивных списках. Объединение обоих SuppressIcon и SuppressRules приводит к надлежащему HTML 3.2 продукции, которые заключительной спецификацией запрещают img и hr элементы от pre блок (имел обыкновение форматировать списки FancyIndexed.)
SuppressSize
это подавит размер файла в причудливых списках индексации.
TrackModified ( Apache 2.0.23 и позже )
это возвращается Последнее-измененный и ценности ETag для перечисленного справочника в ударе головой HTTP. Только действительно, если операционная система и возвращение системы файла приспосабливают stat () результаты. Некоторые системы Unix делают так, также, как и OS2's JFS и Win32's NTFS объемы. OS2 и ЖИРНЫЕ объемы Win32, например, не делают. Как только эта особенность позволяется, клиент или полномочие могут отследить изменения к списку файлов, когда они выполняют a HEAD запрос. Отметьте, что некоторые операционные системы правильно отслеживают новые и удаленные файлы, но не отслеживают изменения к размерам или датам файлов в пределах справочника. изменения к размеру или печати даты существующего файла не будут обновлять Последнее-измененный удар головой на всех платформах Unix. если это - беспокойство, отпуск эти инвалиды выбора.
VersionSort ( Apache 2.0a3 и позже )
VersionSort ключевое слово вызывает файлы, содержащие числа версии к виду естественным способом. Вереницы сортированы как обычно, за исключением того, что подвереницы цифр на название и описание сравнены согласно их числовой ценности.

Example:

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

если число начинается с ноля, то это, как полагают, является фракцией:

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

XHTML ( Apache 2.0.49 и позже )
XHTML силы ключевого слова mod_autoindex испускать XHTML 1.0 кодекса вместо HTML 3.2.
Возрастающий IndexOptions

Apache 1.3.3 вводил некоторые существенные изменения в обработке IndexOptions директивы. В особенности:

  • многократный IndexOptions директивы для единственного справочника теперь слиты вместе. Результат:

    <Directory /foo> IndexOptions HTMLTable
    IndexOptions SuppressColumnsorting
    </Directory>

    будет эквивалент

    IndexOptions HTMLTable SuppressColumnsorting

  • дополнение возрастающего синтаксиса ( то есть. , предустановка ключевых слов с + или - ).

всякий раз, когда '+' или '-'предустановил ключевое слово, сталкивается, это применено к потоку IndexOptions параметры настройки (который, возможно, был унаследован от справочника верхнего уровня). Однако, всякий раз, когда unprefixed ключевое слово обработано, это очищает все унаследованные варианты и любые возрастающие параметры настройки, с которыми сталкиваются пока. Рассмотрите следующий пример:

IndexOptions +ScanHTMLTitles -IconsAreLinks FancyIndexing
IndexOptions +SuppressSize

результирующее влияние эквивалентно IndexOptions FancyIndexing +SuppressSize , потому что unprefixed FancyIndexing отказанный возрастающие ключевые слова прежде, чем это, но позволенный их, чтобы начать накапливаться снова позже.

безоговорочно установить IndexOptions для специфического справочника, очищая унаследованные параметры настройки, определяют ключевые слова без любого + или - приставки.

top

IndexOrderDefault Directive

Description: устанавливает заказ по умолчанию директивного индекса
Syntax: IndexOrderDefault Ascending|Descending Name|Date|Size|Description
Default: IndexOrderDefault Ascending Name
Context: сервер config, действительный хозяин, справочник, .htaccess
Override: индексы
Status: основа
Module: mod_autoindex

IndexOrderDefault директива используется в комбинации с FancyIndexing выбор индекса. По умолчанию, fancyindexed директивные списки показаны в порядке возрастания именем файла; IndexOrderDefault позволяете Вы изменять этот начальный заказ показа.

IndexOrderDefault берет два аргумента. Первое должно быть также Ascending или Descending , указывая руководство вида. Вторым аргументом должно быть одно из ключевых слов Name , Date , Size , или Description , и идентифицирует первичный ключ. Вторичный ключ всегда имя файла возрастания.

Вы можете вынудить внесение в список справочника только быть показанным в специфическом заказе, комбинируя эту директиву с SuppressColumnSorting выбор индекса; это будет препятствовать клиенту просить директивное внесение в список в различном заказе.

top

ReadmeName Directive

Description: название файла, который будет вставлен в конце внесения в список индекса
Syntax: ReadmeName filename
Context: сервер config, действительный хозяин, справочник, .htaccess
Override: индексы
Status: основа
Module: mod_autoindex

ReadmeName директива устанавливает название файла, который будет приложен до конца внесения в список индекса. имя файла является названием файла, чтобы включить, и взят, чтобы быть относительно внесенного в указатель местоположения. Если имя файла начинается с разреза, это будет взято, чтобы быть относительно DocumentRoot .

Example

ReadmeName FOOTER.html

Example 2

ReadmeName /include/FOOTER.html

см. также HeaderName , где это поведение описано в больших деталях.