Модуль Apache mod_mime

Директива AddCharset

AddCharset charset extension [extension] ...

Директива AddCharset сопоставляет заданные расширения имён файлов с указанным набором символов содержимого (зарегистрированным в Интернете названием заданной кодировки символов). charset — это параметр charset типа носителя для ресурсов, имена файлов которых содержат extension. Это сопоставление добавляется к уже действующим и переопределяет существующие сопоставления для того же extension.

AddLanguage ja .ja
AddCharset EUC-JP .euc
AddCharset ISO-2022-JP .jis
AddCharset SHIFT_JIS .sjis

В таком случае документ xxxx.ja.jis будет считаться японским документом с набором символов ISO-2022-JP (как и документ xxxx.jis.ja). Директива AddCharset полезна как для информирования клиента о кодировке символов документа, чтобы его можно было правильно интерпретировать и отобразить, так и для согласования содержимого, когда сервер возвращает один из нескольких документов в соответствии с предпочтениями клиента относительно набора символов.

Аргумент extension не чувствителен к регистру; его можно указывать как с точкой в начале, так и без неё. Имена файлов могут иметь несколько расширений, и аргумент extension будет проверен для каждого из них.

См. также

• mod_negotiation
• AddDefaultCharset

Директива AddEncoding

AddEncoding encoding extension [extension] ...

Директива AddEncoding сопоставляет заданные расширения имён файлов с указанной кодировкой содержимого HTTP. encoding — это схема кодирования содержимого HTTP, добавляемая к значению поля заголовка Content-Encoding для документов с именами, содержащими extension. Это сопоставление добавляется к уже действующим и переопределяет существующие сопоставления для того же extension.

AddEncoding x-gzip .gz
AddEncoding x-compress .Z

В результате имена файлов с расширением .gz будут помечены как закодированные с помощью x-gzip, а имена файлов с расширением .Z — как закодированные с помощью x-compress.

Старые клиенты ожидают x-gzip и x-compress, однако стандарт предписывает считать их эквивалентными соответственно gzip и compress. Apache сравнивает кодировки содержимого, игнорируя начальный x-. При ответе с кодировкой Apache использует ту форму (то есть x-foo или foo), которую запросил клиент. Если клиент не запрашивал конкретную форму, Apache использует форму, заданную директивой AddEncoding. Если коротко, всегда следует использовать x-gzip и x-compress для этих двух конкретных кодировок. Более новые кодировки, например deflate, следует указывать без x-.

Аргумент extension не чувствителен к регистру; его можно указывать как с точкой в начале, так и без неё. Имена файлов могут иметь несколько расширений, и аргумент extension будет проверен для каждого из них.

Директива AddHandler

AddHandler handler-name extension [extension] ...

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

AddHandler cgi-script .cgi

После добавления этого параметра в файл httpd.conf все файлы с расширением .cgi будут обрабатываться как программы CGI.

Аргумент extension не чувствителен к регистру; его можно указывать как с точкой в начале, так и без неё. Имена файлов могут иметь несколько расширений, и аргумент extension будет проверен для каждого из них.

См. также

• SetHandler

Директива AddInputFilter

AddInputFilter filter[;filter...] extension [extension] ...

Директива AddInputFilter сопоставляет расширение имени файла extension с фильтрами, которые будут обрабатывать запросы клиентов и входные данные POST при их получении сервером. Это дополняет любые фильтры, определённые в других местах, включая директиву SetInputFilter. Это сопоставление объединяется с уже действующими и переопределяет существующие сопоставления для того же extension.

Если указано несколько значений filter, их необходимо разделить точками с запятой в порядке обработки содержимого. Аргумент filter не чувствителен к регистру.

Аргумент extension не чувствителен к регистру; его можно указывать как с точкой в начале, так и без неё. Имена файлов могут иметь несколько расширений, и аргумент extension будет проверен для каждого из них.

См. также

• RemoveInputFilter
• SetInputFilter

Директива AddLanguage

AddLanguage language-tag extension [extension] ...

Директива AddLanguage сопоставляет заданное расширение имени файла с указанным языком содержимого. Файлам с расширением extension назначается значение HTTP Content-Language language-tag, соответствующее идентификаторам языков, определённым в RFC 3066. Эта директива переопределяет существующие сопоставления для того же extension.

AddEncoding x-compress .Z
AddLanguage en .en
AddLanguage fr .fr

В таком случае документ xxxx.en.Z будет считаться сжатым документом на английском языке (как и документ xxxx.Z.en). Хотя язык содержимого сообщается клиенту, браузер вряд ли использует эту информацию. Директива AddLanguage полезнее для согласования содержимого, когда сервер возвращает один из нескольких документов в соответствии с языковыми предпочтениями клиента.

Если одному расширению назначено несколько языков, используется последнее встретившееся назначение. То есть в следующем случае:

AddLanguage en .en
AddLanguage en-gb .en
AddLanguage en-us .en

документы с расширением .en будут считаться документами на en-us.

Аргумент extension не чувствителен к регистру; его можно указывать как с точкой в начале, так и без неё. Имена файлов могут иметь несколько расширений, и аргумент extension будет проверен для каждого из них.

См. также

• mod_negotiation

Директива AddOutputFilter

AddOutputFilter filter[;filter...] extension [extension] ...

Директива AddOutputFilter сопоставляет расширение имени файла extension с фильтрами, которые будут обрабатывать ответы сервера перед их отправкой клиенту. Это дополняет любые фильтры, определённые в других местах, включая директивы SetOutputFilter и AddOutputFilterByType. Это сопоставление объединяется с уже действующими и переопределяет существующие сопоставления для того же extension.

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

AddOutputFilter INCLUDES;DEFLATE shtml

Если указано несколько фильтров, их необходимо разделить точками с запятой в порядке обработки содержимого. Аргумент filter не чувствителен к регистру.

Аргумент extension не чувствителен к регистру; его можно указывать как с точкой в начале, так и без неё. Имена файлов могут иметь несколько расширений, и аргумент extension будет проверен для каждого из них.

Обратите внимание: при определении набора фильтров с помощью директивы AddOutputFilter любое заданное определение заменяет предыдущее определение, сделанное директивой AddOutputFilter.

# Effective filter "DEFLATE"
AddOutputFilter DEFLATE shtml
<Location "/foo">
  # Effective filter "INCLUDES", replacing "DEFLATE"
  AddOutputFilter INCLUDES shtml
</Location>
<Location "/bar">
  # Effective filter "INCLUDES;DEFLATE", replacing "DEFLATE"
  AddOutputFilter INCLUDES;DEFLATE shtml
</Location>
<Location "/bar/baz">
  # Effective filter "BUFFER", replacing "INCLUDES;DEFLATE"
  AddOutputFilter BUFFER shtml
</Location>
<Location "/bar/baz/buz">
  # No effective filter, replacing "BUFFER"
  RemoveOutputFilter shtml
</Location>

См. также

• RemoveOutputFilter
• SetOutputFilter

Директива AddType

AddType media-type extension [extension] ...

Директива AddType сопоставляет заданные расширения имён файлов с указанным типом содержимого. media-type — это тип носителя, используемый для имён файлов, содержащих extension. Это сопоставление добавляется к уже действующим и переопределяет существующие сопоставления для того же extension.

AddType image/gif .gif

Или можно указать несколько расширений файлов в одной директиве:

AddType image/jpeg jpeg jpg jpe

Аргумент extension не чувствителен к регистру; его можно указывать как с точкой в начале, так и без неё. Имена файлов могут иметь несколько расширений, и аргумент extension будет проверен для каждого из них.

Аналогичного эффекта, что и LanguagePriority в mod_negotiation, можно добиться, указав qs для media-type:

AddType application/rss+xml;qs=0.8 .xml

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

Эта директива в первую очередь настраивает типы содержимого, создаваемые для статических файлов, обслуживаемых из файловой системы. Для ресурсов, отличных от статических файлов, генератор ответа которых обычно сам указывает Content-Type, эта директива не действует.

См. также

• ForceType
• mod_negotiation

Директива DefaultLanguage

DefaultLanguage language-tag

Директива DefaultLanguage указывает Apache, что всем ресурсам в области действия директивы (например, всем ресурсам, охватываемым текущим контейнером <Directory>), у которых нет явного языкового расширения (например, .fr или .de, заданных с помощью AddLanguage), следует назначить Content-Language со значением language-tag. Это позволяет пометить целые деревья каталогов как содержащие, например, содержимое на нидерландском языке, не переименовывая каждый файл. Обратите внимание: в отличие от указания языков с помощью расширений, DefaultLanguage позволяет задать только один язык.

Если директива DefaultLanguage не действует и у файла нет языковых расширений, настроенных с помощью AddLanguage, поле заголовка Content-Language не создаётся.

DefaultLanguage en

См. также

• mod_negotiation

Директива ModMimeUsePathInfo

ModMimeUsePathInfo On|Off

ModMimeUsePathInfo Off

Директива ModMimeUsePathInfo используется для объединения имени файла с компонентом URL path_info, чтобы применить директивы mod_mime к запросу. Значение по умолчанию — Off, поэтому компонент path_info игнорируется.

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

ModMimeUsePathInfo On

Если поступит запрос /index.php/foo.shtml, mod_mime будет рассматривать его как /index.php/foo.shtml, а директивы вроде AddOutputFilter INCLUDES .shtml добавят к запросу фильтр INCLUDES. Если ModMimeUsePathInfo не задано, фильтр INCLUDES добавлен не будет. Аналогично это работает для виртуальных путей, например определённых с помощью <Location>

См. также

• AcceptPathInfo

Директива MultiviewsMatch

MultiviewsMatch Any|NegotiatedOnly|Filters|Handlers [Handlers|Filters]

MultiviewsMatch NegotiatedOnly

Директива MultiviewsMatch задаёт три разных варианта поведения функции Multiviews модуля mod_negotiation. Multiviews позволяет запросу файла, например index.html, соответствовать любым согласованным расширениям, следующим за базовым запросом, например index.html.en, index.html.fr или index.html.gz.

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

Чтобы включить расширения, связанные с обработчиками и/или фильтрами, задайте директиве MultiviewsMatch значение Handlers, Filters или оба ключевых слова параметров. При прочих равных будет передан файл меньшего размера. Например, при выборе между index.html.cgi размером 500 байт и index.html.pl размером 1000 байт в этом примере будет выбран файл .cgi. Пользователям файлов .asis может быть предпочтительнее параметр Handler, если файлы .asis связаны с asis-handler.

Наконец, можно разрешить совпадения с расширениями Any, даже если mod_mime не распознаёт это расширение. Это может привести к непредсказуемым результатам, например к отправке файлов .old или .bak, которые веб-мастер не собирался публиковать.

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

MultiviewsMatch Handlers Filters

Использовать MultiviewsMatch в разделе <Location> или <LocationMatch> нельзя.

См. также

• Options
• mod_negotiation

Директива RemoveCharset

RemoveCharset extension [extension] ...

Директива RemoveCharset удаляет все связи набора символов для файлов с заданными расширениями. Это позволяет файлам .htaccess во вложенных каталогах отменять связи, унаследованные от родительских каталогов или файлов конфигурации сервера.

Аргумент extension не чувствителен к регистру; его можно указывать как с точкой в начале, так и без неё.

RemoveCharset .html .shtml

Директива RemoveEncoding

RemoveEncoding extension [extension] ...

Директива RemoveEncoding удаляет все связи кодировок для файлов с указанными расширениями. Это позволяет файлам .htaccess во вложенных каталогах отменять любые связи, унаследованные от родительских каталогов или файлов конфигурации сервера. Пример использования:

AddEncoding x-gzip .gz
AddType text/plain .asc
<Files "*.gz.asc">
    RemoveEncoding .gz
</Files>

В результате foo.gz будет помечен как закодированный методом gzip, а foo.gz.asc — как незакодированный текстовый файл.

Аргумент extension не чувствителен к регистру и может указываться с начальной точкой или без неё.

Директива RemoveHandler

RemoveHandler extension [extension] ...

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

AddHandler server-parsed .html

RemoveHandler .html

В результате файлы .html в каталоге /foo/bar снова будут обрабатываться как обычные файлы, а не как кандидаты на разбор (см. модуль mod_include).

Аргумент extension не чувствителен к регистру и может указываться с начальной точкой или без неё.

Директива RemoveInputFilter

RemoveInputFilter extension [extension] ...

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

Аргумент extension не чувствителен к регистру и может указываться с начальной точкой или без неё.

См. также

• AddInputFilter
• SetInputFilter

Директива RemoveLanguage

RemoveLanguage extension [extension] ...

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

Аргумент extension не чувствителен к регистру и может указываться с начальной точкой или без неё.

Директива RemoveOutputFilter

RemoveOutputFilter extension [extension] ...

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

Аргумент extension не чувствителен к регистру и может указываться с начальной точкой или без неё.

RemoveOutputFilter shtml

См. также

• AddOutputFilter

Директива RemoveType

RemoveType extension [extension] ...

Директива RemoveType удаляет все связи медиатипов для файлов с указанными расширениями. Это позволяет файлам .htaccess во вложенных каталогах отменять любые связи, унаследованные от родительских каталогов или файлов конфигурации сервера. Пример использования:

RemoveType .cgi

В результате будет удалена специальная обработка файлов .cgi в каталоге /foo/ и всех его вложенных каталогах, поэтому ответы, содержащие эти файлы, не будут включать поле HTTP-заголовка Content-Type.

Аргумент extension не чувствителен к регистру и может указываться с начальной точкой или без неё.

Директива TypesConfig

TypesConfig file-path

TypesConfig conf/mime.types

Директива TypesConfig задаёт расположение файла конфигурации медиатипов. File-path задаётся относительно ServerRoot. Этот файл содержит список сопоставлений расширений файлов типам содержимого по умолчанию. Большинство администраторов используют файл mime.types, предоставляемый их операционной системой. В нём распространённые расширения файлов сопоставлены с официальным списком зарегистрированных IANA медиатипов, который поддерживается по адресу http://www.iana.org/assignments/media-types/index.html, а также с большим количеством неофициальных типов. Это упрощает файл httpd.conf, поскольку в нём уже содержится большинство определений медиатипов; при необходимости их можно переопределить директивами AddType. Не следует редактировать файл mime.types, поскольку он может быть заменён при обновлении сервера.

Файл содержит строки в формате аргументов директивы AddType:

media-type [extension] ...

Регистр символов в расширении не имеет значения. Пустые строки и строки, начинающиеся с символа решётки (#), игнорируются. Пустые строки включены для полноты файла mime.types. Apache httpd по-прежнему может определять эти типы с помощью mod_mime_magic.

См. также

• mod_mime_magic