Модуль Apache mod_autoindex

Директива IndexOptions

IndexOptions [+|-]option [[+|-]option] ...

By default, no options are enabled.

Директива IndexOptions задаёт поведение индексирования каталогов. Параметр может быть одним из

AddAltClass

Добавляет дополнительное объявление класса CSS для каждой строки таблицы списка каталога, когда IndexOptions HTMLTable активен и определён IndexStyleSheet. Вместо стандартных классов even и odd, которые в противном случае применялись бы к каждой строке таблицы, применяется класс even-ALT или odd-ALT, где ALT — это либо стандартный альтернативный текст, связанный со стилем файла (например, snd, txt, img и т. д.), либо альтернативный текст, определённый одним из различных AddAlt* директив.

Charset=character-set

Ключевое слово Charset позволяет указать кодовую страницу сгенерированной страницы. По умолчанию это UTF-8 в Windows и Mac OS X и ISO-8859-1 в других системах. (Это зависит от того, использует ли файловая система имена файлов Unicode или нет.)

IndexOptions Charset=UTF-8

DescriptionWidth=[n | *]

Ключевое слово DescriptionWidth позволяет указать ширину столбца описания в символах.

-DescriptionWidth (или не задано) позволяет mod_autoindex рассчитать оптимальную ширину.

DescriptionWidth=n фиксирует ширину столбца в n байтах.

DescriptionWidth=* увеличивает ширину столбца до необходимой, чтобы вместить самую длинную строку описания. См. раздел по AddDescription для опасностей, связанных с обрезкой описаний.

FancyIndexing

Включает расширенный вывод списка каталогов.

FoldersFirst

Если этот параметр включен, списки подкаталогов всегда будут отображаться первыми, а затем обычные файлы в каталоге. Вывод разделен на две части: файлы и подкаталоги, каждый из которых сортируется отдельно, а затем отображается в порядке подкаталоги-сначала. Например, если порядок сортировки — убывание по имени, и FoldersFirst включён, подкаталог Zed будет отображаться перед подкаталогом Beta, который будет отображаться перед обычными файлами Gamma и Alpha. Этот параметр действует только при включенном FancyIndexing.

HTMLTable

Этот параметр с FancyIndexing создаёт простую таблицу для расширенного вывода каталогов. Он необходим для платформ с поддержкой utf-8 или если имена файлов или тексты описаний чередуются между порядком чтения слева направо и справа налево.

IconsAreLinks

Делает значки частью якоря для имени файла, для расширенного вывода каталогов.

IconHeight[=pixels]

Наличие этого параметра при использовании с IconWidth, заставит сервер включить атрибуты height и width в теге img для значка файла. Это позволяет браузеру предварительно рассчитать макет страницы без ожидания загрузки всех изображений. Если для параметра не указано значение, оно устанавливается по умолчанию — стандартная высота значков, поставляемых с программным обеспечением Apache httpd. Этот параметр действует только при включенном FancyIndexing.

IconWidth[=pixels]

Наличие этого параметра при использовании с IconHeight, заставит сервер включить атрибуты height и width в теге img для значка файла. Это позволяет браузеру предварительно рассчитать макет страницы без ожидания загрузки всех изображений. Если для параметра не указано значение, оно устанавливается по умолчанию — стандартная ширина значков, поставляемых с программным обеспечением Apache httpd.

IgnoreCase

Если этот параметр включён, имена сортируются без учёта регистра. Например, если порядок сортировки — возрастание по имени, и IgnoreCase включен, файл Zeta будет отображаться после файла alfa (Примечание: файл GAMMA всегда будет отображаться до файла gamma).

IgnoreClient

Этот параметр заставляет mod_autoindex игнорировать все переменные запроса от клиента, включая порядок сортировки (подразумевает SuppressColumnSorting).

NameWidth=[n | *]

Ключевое слово NameWidth позволяет указать ширину столбца имени файла в байтах.

-NameWidth (или не задано) позволяет mod_autoindex рассчитать оптимальную ширину, но не более 20 байт.

NameWidth=n фиксирует ширину столбца в n байтах.

NameWidth=* увеличивает ширину столбца до необходимой.

ScanHTMLTitles

Включает извлечение заголовка из HTML-документов для расширенного вывода каталогов. Если файл не имеет описания, заданного AddDescription, то httpd будет читать документ для значения элемента title. Это ресурсоёмкая операция для ЦП и диска.

ShowForbidden

Если указано, Apache httpd покажет файлы, обычно скрытые, потому что подзапрос вернул HTTP_UNAUTHORIZED или HTTP_FORBIDDEN

SuppressColumnSorting

При указании Apache httpd не сделает заголовки столбцов в расширенном списке каталогов ссылками для сортировки. По умолчанию они являются ссылками; выбор заголовка столбца отсортирует список каталогов по значениям в этом столбце. Однако аргументы строки запроса, присоединённые к URL, всё ещё будут учитываться. Это поведение контролируется IndexOptions IgnoreClient.

SuppressDescription

Это подавляет отображение описания файла в расширенных списках каталогов. По умолчанию описания файлов не определены, поэтому использование этого параметра высвободит 23 символа экрана для других целей. См. AddDescription для получения информации о настройке описания файла. См. также параметр DescriptionWidth индекса для ограничения размера столбца описания. Этот параметр действует только при включенном FancyIndexing.

SuppressHTMLPreamble

Если каталог фактически содержит файл, указанный директивой HeaderName, модуль обычно включает содержимое файла после стандартного HTML-преамбулы (<html>, <head>, и так далее). Параметр SuppressHTMLPreamble отключает это поведение, заставляя модуль начать вывод с содержимого файла заголовка. В этом случае файл заголовка должен содержать соответствующие HTML-инструкции. Если файла заголовка нет, преамбула генерируется как обычно. Если вы также укажете ReadmeName, и если этот файл существует, закрывающие теги </body></html> также будут опущены из вывода, исходя из предположения, что вы, скорее всего, поместите эти закрывающие теги в этот файл.

SuppressIcon

Это подавляет отображение значка в расширенных списках каталогов. Сочетание SuppressIcon и SuppressRules даёт правильный вывод HTML 3.2, который по окончательной спецификации запрещает элементы img и hr из блока pre (используемого для форматирования расширенных списков каталогов).

SuppressLastModified

Это подавляет отображение даты последнего изменения в расширенных списках каталогов. Этот параметр действует только при включенном FancyIndexing.

SuppressRules

Это подавляет отображение горизонтальных линий (элементы hr) в списках каталогов. Сочетание SuppressIcon и SuppressRules даёт правильный вывод HTML 3.2, который по окончательной спецификации запрещает элементы img и hr из блока pre (используемого для форматирования расширенных списков каталогов). Этот параметр действует только при включенном FancyIndexing.

SuppressSize

Это подавляет отображение размера файла в расширенных списках каталогов. Этот параметр действует только при включенном FancyIndexing.

TrackModified

Возвращает значения Last-Modified и ETag для указанного каталога в заголовке HTTP. Действительно только если операционная система и файловая система возвращают соответствующие результаты stat(). Некоторые Unix-системы делают это, как и OS2's JFS и Win32's NTFS. OS2 и Win32 FAT, например, нет. После активации этой функции клиент или прокси-сервер может отслеживать изменения в списке файлов при выполнении запроса HEAD. Обратите внимание, что некоторые операционные системы правильно отслеживают новые и удалённые файлы, но не отслеживают изменения размера или даты файлов внутри каталога. Изменения размера или даты отметки существующего файла не обновят заголовок Last-Modified на всех платформах Unix. Если это вызывает беспокойство, оставьте этот параметр отключённым.

Type=MIME content-type

Ключевое слово Type позволяет указать MIME-тип содержимого сгенерированной страницы. По умолчанию text/html.

IndexOptions Type=text/plain

UseOldDateFormat (Apache HTTP Server 2.4.26 и более поздние версии)

Формат даты, используемый для поля Last Modified, был непреднамеренно изменён на "%Y-%m-%d %H:%M" с "%d-%b-%Y %H:%M" в версии 2.4.0. Установка этого параметра восстанавливает формат даты с версии 2.2 и более ранних.

VersionSort

Ключевое слово VersionSort заставляет файлы, содержащие номера версий, сортироваться естественным образом. Строки сортируются обычным образом, за исключением того, что подстроки цифр в имени и описании сравниваются по их числовому значению.

Пример:

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

Ключевое слово XHTML заставляет mod_autoindex выводить код XHTML 1.0 вместо HTML 3.2. Эта опция действует только при включённом FancyIndexing.

Incremental IndexOptions

Обратите внимание на то, как обрабатываются несколько IndexOptions.

• Несколько директив IndexOptions для одного каталога теперь объединяются вместе. Результат:

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

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

  IndexOptions HTMLTable SuppressColumnsorting

• Добавление инкрементной синтаксической конструкции (т.е., префикса ключевых слов с + или -).

Всякий раз, когда встречается ключевое слово с префиксом «+» или «-», оно применяется к текущим настройкам IndexOptions (которые могут быть унаследованы от родительского каталога). Однако при обработке ключевого слова без префикса, все унаследованные опции и все инкрементные настройки, встреченные до этого, сбрасываются. Рассмотрим следующий пример:

IndexOptions +ScanHTMLTitles -IconsAreLinks FancyIndexing
IndexOptions +SuppressSize

Результат эквивалентен IndexOptions FancyIndexing +SuppressSize, потому что ключевое слово FancyIndexing без префикса отбросило инкрементные ключевые слова перед ним, но позволило им снова начать накапливаться после него.

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