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

Apache Модуль mod_headers

Description: настройка HTTP просит и удары головой ответа
Status: расширение
Module Identifier: headers_module
Source File: mod_headers.c
Compatibility: RequestHeader является доступным только в Apacheе 2.0

резюме

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

директивы

темы

top

Order of Processing

директивы, обеспеченные mod_headers может произойти почти где-нибудь в пределах конфигурации сервера. Они действительны в основном сервер config и действительные секции хозяина, внутри <Directory> , <Location> и <Files> секции, и в пределах .htaccess файлы.

директивы обработаны в следующем заказе:

  1. главный сервер
  2. действительный хозяин
  3. <Directory> секции и .htaccess
  4. <Files>
  5. <Location>

заказ важен. Эти два удара головой имеют различный эффект если полностью изменено:

RequestHeader append MirrorID "mirror 12"
RequestHeader unset MirrorID

этот путь вокруг, MirrorID удар головой не установлен. Если полностью изменено, удар головой MirrorID собирается, "отражают 12".

top

Examples

  1. скопировать все удары головой запроса, которые начинаются с "TS" к ударам головой ответа:

    Header echo ^TS

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

    Header add MyHeader "%D %t"

    приводит к этому удару головой, добавляемому к ответу:

    MyHeader: D=3775428 t=991424704447256

  3. сказать привет Джо

    Header add MyHeader "Hello Joe. It took %D microseconds \
    for Apache to serve this request."

    приводит к этому удару головой, добавляемому к ответу:

    MyHeader: Hello Joe. It took D=3775428 microseconds for Apache to serve this request.

  4. условно пошлите MyHeader на ответе, если и только если удар головой "MyRequestHeader" присутствует на запросе. Это полезно для того, чтобы строить удары головой в ответ на некоторый стимул клиента. Отметьте, что этот пример требует услуг mod_setenvif модуль.

    SetEnvIf MyRequestHeader value HAVE_MyRequestHeader
    Header add MyHeader "%D %t mytext" env=HAVE_MyRequestHeader

    если удар головой MyRequestHeader: value присутствует на запросе HTTP, ответ будет содержать следующий удар головой:

    MyHeader: D=3775428 t=991424704447256 mytext

top

Header Directive

Description: Формировать удары головой ответа HTTP
Syntax: Header [ condition ] set|append|add|unset|echo header [ value ] [env=[!] variable ]
Context: сервер config, действительный хозяин, справочник, .htaccess
Override: FileInfo
Status: расширение
Module: mod_headers
Compatibility: условие является доступным в версии 2.0.51 и позже

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

дополнительное условие может быть также onsuccess или always . это определяет, на котором нужно управлять внутренним столом удара головой. onsuccess поддерживает 2 xx статус закодировал и always для всех кодексов статуса (включая 2 xx ). Особенно, если Вы хотите сбросить удары головой, установленные определенными модулями, Вы должны испытать, какой стол затронут.

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

set
удар головой ответа установлен, заменяя любой предыдущий удар головой с этим названием. ценность может быть вереница формата.
append
удар головой ответа приложен к любому существующему удару головой того же самого названия. Когда новая ценность слита на существующий удар головой, это отделено от существующего удара головой с запятой. Это - стандартный способ HTTP дать удару головой многократные ценности.
add
удар головой ответа добавлен к существующему набору ударов головой, даже если этот удар головой уже существует. Это может привести два (или больше) удары головой, имеющие то же самое название. Это может привести к непредвиденным последствиям, и вообще "приложить", должен использоваться вместо этого.
unset
удар головой ответа этого названия удален, если это существует. Если будут многократные удары головой того же самого названия, то все будут удалены.
echo
на удары головой запроса с этим названием реагируют в ударах головой ответа. удар головой может быть регулярное выражение.

этот аргумент сопровождается a удар головой название, которое может включить заключительное двоеточие, но это не требуется. Случай игнорируется для set , append , add и unset . удар головой название для echo является чувствительным случаем и может быть регулярное выражение.

для add , append и set a ценность определен как третий аргумент. Если ценность содержит места, это должно быть окружено doublequotes. ценность может быть строка символов, вереница, содержащая спецификаторы формата или комбинацию обоих. Следующие спецификаторы формата поддержаны в ценность :

%t время запрос было получено в Универсальное Скоординированное Время начиная с эпохи (1 января 1970), измеренной в микросекундах. Ценностью предшествуют t= .
%D время от того, когда запрос был получен ко времени удары головой, посылают на проводе. Это - мера продолжительности запроса. Ценностью предшествуют D= .
%{FOOBAR}e содержание environment variable FOOBAR .

когда Header директива используется с add , append , или set аргумент, четвертый аргумент может использоваться, чтобы определить условия, при которых будет предпринято действие. Если environment variable определенный в env=... аргумент существует (или если переменная окружающей среды не существует и env=!... определен), тогда действие, определенное Header директива вступит в силу. Иначе, директива не будет иметь никакого эффекта на запрос.

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

top

RequestHeader Directive

Description: Формировать удары головой запроса HTTP
Syntax: RequestHeader set|append|add|unset header [ value ]
Context: сервер config, действительный хозяин, справочник, .htaccess
Override: FileInfo
Status: расширение
Module: mod_headers

эта директива может заменить, слить или удалить удары головой запроса HTTP. Удар головой изменен непосредственно перед тем, как довольным тренером управляют, позволяя поступающие удары головой быть измененным. Действие, которое это выполняет, определено первым аргументом. Это может быть одной из следующих ценностей:

set
удар головой запроса установлен, заменяя любой предыдущий удар головой с этим названием
append
удар головой запроса приложен к любому существующему удару головой того же самого названия. Когда новая ценность слита на существующий удар головой, это отделено от существующего удара головой с запятой. Это - стандартный способ HTTP дать удару головой многократные ценности.
add
удар головой запроса добавлен к существующему набору ударов головой, даже если этот удар головой уже существует. Это может привести два (или больше) удары головой, имеющие то же самое название. Это может привести к непредвиденным последствиям, и вообще append должен использоваться вместо этого.
unset
удар головой запроса этого названия удален, если это существует. Если будут многократные удары головой того же самого названия, то все будут удалены.

этот аргумент сопровождается названием удара головой, которое может включить заключительное двоеточие, но это не требуется. Случай игнорируется. Для add , append и set a ценность дается как третий аргумент. Если ценность содержит места, это должно быть окружено двойными кавычками. Для сброса, нет ценность нужно дать.

RequestHeader директива обработана непосредственно перед тем, как запросом управляет его тренер в fixup фазе. Это должно позволить удары головой, произведенные браузером, или Apacheскими фильтрами входа быть отвергнутыми или изменен.