Хокинс С. - Администрирование Web-сервера Apache и руководст

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

Чтобы задать отображение пиктограммы, находящейся по адресу /icon/unknown.xbm при отсут ствии соответствующей директивы, воспользуйтесь следующей директивой:

DefaultIcon /icon/unknown.xbm

Б.12.9. Директива DirectoryIndex

Обычно эта директива задает имя первого файла, который будет отображаться при доступе к каталогу (например index.hmtl). Этим можно воспользоваться для задания альтернативного отображаемого или исполняемого файла.

Следующая директива будет выполнять CGI сценарий index.pl, если в каталоге не существует ни

файла index.html, НИ файла alt index, html:

DirectoryIndex index.html index.txt /cgi bin/index.pl

Б. 12.10. Директива FancyIndexing

Эта директива предназначена для включения/отключения режима FancyIndexing.

Пример

Чтобы включить режим FancyIndexing, воспользуйтесь следующей директивой:

FancyIndexing on

Б.12.11. Директива HeaderName

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

Чтобы вставить файл site banner.html в начало индексного листинга, воспользуйтесь следую щей директивой:

HeaderName site banner.html

Б.12.12. Директива IndexIgnore

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

Чтобы сервер Apache проигнорировал установки, сделанные в файле .htaccess и во всех файлах, завершающихся расширением . pi во время создания листингов каталогов, воспользуйтесь следующей директивой:

Indexlgnore README .htaccess .pl

Б.12.13. Директива IndexOptions

Эта директива предназначена для управления процессом индексирования. Пере чень опций можно найти в табл. Б.5.

Таблица Б.5. Опции директивы IndexOptions

По умолчанию опции неактивны.

Для активизации фиктивного индексирования и отключения описания документов в сгенерированном описании необходимо воспользоваться следующей директивой:

<Directory /home/site2/>

IndexOptions FancyIndexing SuppressDescription <Directory>

Б.12.14. Директива ReadmeName

в конец листинга каталога.

Чтобы добавить файл readme в конец каждого генерируемого листинга каталога, можно воспользо ваться следующей директивой:

ReadmeName README

Б.13. Модуль mod env

Директивы этого модуля используются в основном для передачи переменных ок ружения CGl сценариям, для получения значений переменных окружения отсистем ных процессов, которы е вызвали сервер Apache.

Б.13.1. Директива PassEnv

Этой директивой можно воспользоваться для установки переменных окружения сервера, которые будут переданы CGI сценариям прямо из окружения сервера.

Чтобы передать переменную окружения INFORMIXDIR порожденному процессу, воспользуйтесь сле дующей директивой:

PassEnv INFORMIXDIR

Б.13.2. Директива SetEnv

Эта директива предназначена для установки переменных окружения, которые бу дут переданы CGI сценариям.

Чтобы установить переменную окружения INFORMIXDIR с целью ее передачи порожденному процес су, воспользуйтесь следующей директивой:

SetEnv INFORMIXDIR /usr/local/informix

Б.13.3. Директива UnsetEnv

Этой директивой можно воспользоваться для удаления переменных окружения из набора переменных окружения, которые передаются CGI сценариям.

Чтобы удалить переменную INFORMIXDIR из набора переменных окружения, которые передаются порожденным процессам, воспользуйтесь следующей директивой:

UnsetEnv INFORMIXDIR

Б.14. Модуль mod_expires

Директивы из этого модуля используются для управления значением Expires за головка HTTP, которое передается клиенту.

Б.14.1. Директива ExpiresActive

Эта директива используется для включения или отключения режима установки значения Expires заголовка HTTP.

Чтобы включался заголовок HTTP Expires, воспользуйтесь следующей директивой:

ExpiresActive on

Б.14.2. Директива ExpiresByType

Эта директива используется для задания значения Expires в заголовке HTTP, воз вращаемого клиентскому процессу. Значением <код> может быть "М", которая пока зывает, что значение задано относительно времени последней модификации, или "А", что показывает, что значение задано относительно времени последнего доступа.

Чтобы указать, что срок хранения документов html истекает через неделю после последнего доступа к ним, воспользуйтесьдирективой:

ExpiresByType text/html A604800

Б.14.3. Директива ExpiresDefault

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

ExpiresByType.

Пример

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

ExpiresDefault M2592000

Б.15. Модуль mod_headers

Этот модуль имеет только одну директиву, директиву Header, которая может ис пользоваться для расшифровки стандартных заголовков HTTP.

Б.15.1. Директива Header

Эта директива предназначена для замены, слияния или удаления заголовков ответа HTTP. Допустимые действия перечислены в табл. Б.6.

Таблица Б.6. Действия директивы Header

Чтобы задать значение заголовка сервера "Fenris", перекрыв любое существующее значение, вос пользуемся директивой:

Header set Server "Fenris"

Б.16. Модуль mod_imap

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

Imagemaps это изображения с четко заданными компонентами, по которым можно щелкать, чтобы получить индивидуальную или покомпонентную реакцию.

Б.16.1. Директива ImapMenu

Этой директивой можно воспользоваться для определения предпринимаемой реак ции, когда imap файл вызывается без координат. Опции перечислены в табл. Б.7.

Таблица Б.7. Опции директивы ImapMenu

Б.16.2. Директива ImapDefault

Эту директиву необходимо использовать для задания стандартных установок в файлах imagemap. Если они остаются незаданными, то по умолчанию принимается nocontent, что означает: клиенту отсылается сообщение "204 No Content".

Чтобы по умолчанию файлом imagemap был mysite.html, воспользуемся директивой:

ImapDefault mysite.html

Б.16.3. Директива ImapBase

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

Чтобы задать каталог /images/ в качестве каталога базы image, можно воспользоваться следую щей директивой:

ImapBase /images/

Б.17. Модуль mod_include

Модуль mod_include обеспечивает динамическое изменение HTML документов на стороне сервера. Обсуждение этой темы можно найти в главе 9, "Динамические Web страницы.

Б.17.1.ДирективаXBitHack

При установке в on или full директива XBitHack позволяет обработку обычных HTML документов (имеющих MIME тип text/h tml). Значения, которые может принимать параметр статус, перечислены в табл. Б.8.

Таблица Б.8. Значение параметра статусдирективы XbitHack

Значение Действие параметра

Б.18. Модуль mod_info

Модуль mod_inf о позволяет администратору (а потенциально — всем желающим) получить доступ к информации о сервере в виде Web страницы. Подробно эта про блема обсуждается в главе 7, "Регистрация и мониторинг".

Б.18.1. Директива AddModuleInfo

Эта директива позволяет при выводе включить дополнительную информации об имени заданного модуля.

Чтобы задать гипертекстовую связь на информацию о модуле, когда отображается экран данных, mod_infо, воспользуйтесь следующей директивой:

AddModulelnfo mod_auth.c 'См. <А HREF="http://www.apache.org/docs/ mod/mod_info.html">http://www.apache.org/docs/mod/mod_info.html</A>'

Б.19. Модуль mod_isapi

Модуль mod_isapi обеспечивает поддержку расширений интерфейса программи рования приложений для интернет сервера (Internet Server Application Programming Interface — ISAPI) при работе сервера Apache в средах Win32. Чтобы запуститьработу

этого модуля, необходимо связать дескриптор isapi isa с файлами, имеющими расширение dll:

AddHandler isapi$isa dll

Б.20. Модуль mod_log_agent

Модуль mod_ log_agent обеспечивает регистрацию клиентских пользовательских агентов в соответствии с заголовками UserAgent поступающих запросов.

Б.20.1. Директива AgentLog

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

Чтобы переслать полученные заголовки user_Agent на локальную счетную программу countagent.pl, можно воспользоваться следующей директивой:

AgentLog | countagent.pl

Б.21. Модуль mod_log_common

Начиная с версии Apache 1.2, модуль mod_log_common был заменен модулем mod_log_config.

Б.22. Модуль mod_log_config

Модуль mod_log_config обеспечивает регистрацию запросов к серверу в формате Common Log Format. Кроме того, с помощью директивы LogFormat этот формат мо жет быть настроен любым образом. Более подробную информацию о модуле можно найти в главе 7, "Регистрация и мониторинг".

Б.22.1. Директива CookieLog

Эта директива используется для регистрации файлов cookies.

Для регистрации файлов cookies в файле /var/iog/cookies, можно воспользоваться следую щейдирективой:

CookieLog /var/log/cookies

Б.22.2. Директива Custom_Log

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

Чтобы зарегистрировать дату, узел, клиента и количество байт, возвращаемых в файл /var/log/bytelog, воспользуйтесь следующей директивой:

CustomLog /var/log/bytelog "date host ident byte"

Browser=netscape

Пример

Чтобы зарегистрировать дату, узел, клиента и количество байт, возвращаемых броузеру Netscape в файл /var/log/netscape, воспользуйтесь следующей директивой (здесь предполагается, что пе ременная окружения броузера устанавливается на основании типа броузера):

CustomLog /var/log/bytelog "date host ident byte"

Browser=netscape

Б.22.3. Директива LogFormat

Эта директива используется для задания формата журнала, созданного директивой TransferLog. Отметим, что при подключении псевдонима к формату, определенному с помощью этой директивы, псевдонимом можно будет пользоваться и в других ди рективах. Значения переменных, которые используются в этом формате, приводятся в главе 7, "Регистрация и мониторинг".

Директива LogFormat, задающая псевдоним, не несет никаких других нагрузок. Псевдоним можно указать в любом месте.