Модуль Apache mod_mime

Директива AddCharset

AddCharset charset extension [extension] ...

Директива AddCharset сопоставляет заданные расширения имен файлов с указанной кодовой страницей содержимого (зарегистрированное в Интернете имя для данной кодировки символов). 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 будет сравниваться с каждым из них.

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

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 используется для объединения имени файла с компонентом path_info URL для применения директив 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 расширению для согласования контента, например Charset, Content-Type, Language или Encoding. Это самая строгая реализация с наименьшим количеством непредвиденных последствий, и это поведение по умолчанию.

Чтобы включить расширения, связанные с обработчиками и/или фильтрами, установите директиву 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 устанавливает расположение файла конфигурации типов содержимого. Путь к файлу является относительным к 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