Apache: Модуль Apache mod_charset

RU EN

Пункт 127. Модуль Apache mod_charset_lite

mod_charset_lite позволяет серверу изменять набор символов ответов перед их отправкой клиенту. В среде EBCDIC Apache всегда переводит содержимое протокола HTTP (например, заголовки ответов) из кодовой страницы локали процесса Apache в ISO-8859-1, но не тело ответов. В любой среде mod_charset_lite может использоваться для указания того, что тело ответа должно быть переведено. Например, если файлы хранятся в формате EBCDIC, то mod_charset_lite можно перевести их в ISO-8859-1 перед отправкой клиенту.

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

Общие проблемы

Недопустимые имена наборов символов

Параметры имени набора символов CharsetSourceEnc и CharsetDefault должны быть приемлемы для механизма перевода, используемого APR в системе, в которой mod_charset_lite он развернут. Эти имена наборов символов не стандартизированы и обычно не совпадают с соответствующими значениями, используемыми в заголовках http. В настоящее время APR может использовать только iconv(3), поэтому вы можете легко проверить имена наборов символов с помощью программы iconv(1) следующим образом:

iconv -f charsetsourceenc-value -t charsetdefault-value

Несоответствие между набором символов содержимого и правилами перевода

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

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

Директива CharsetDefault

Описание:	Набор символов для перевода
Синтаксис:	`CharsetDefault charset`
Контекст:	конфигурация сервера, виртуальный хост, каталог, .htaccess
Переопределить:	Информация о файле
Положение дел:	Расширение
Модуль:	mod_charset_lite

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

Значение аргумента charset должно быть принято в качестве допустимого имени набора символов поддержкой набора символов в APR . Как правило, это означает, что он должен поддерживаться iconv.

Пример

 <Каталог "/export/home/trawick/apacheinst/htdocs/convert">
 CharsetSourceEnc UTF-16BE
 Набор символов по умолчанию ISO-8859-1
</Каталог>

Указание одной и той же кодировки для обоих CharsetSourceEnc и CharsetDefault отключает перевод. Набор символов не обязательно должен совпадать с набором символов ответа, но он должен быть действительным набором символов в системе.

Директива CharsetOptions

Описание:	Настраивает поведение перевода набора символов
Синтаксис:	`CharsetOptions option [option] ...`
По умолчанию:	`CharsetOptions ImplicitAdd`
Контекст:	конфигурация сервера, виртуальный хост, каталог, .htaccess
Переопределить:	Информация о файле
Положение дел:	Расширение
Модуль:	mod_charset_lite

Директива CharsetOptions настраивает определенное поведение mod_charset_lite . Вариант может быть одним из

ImplicitAdd | NoImplicitAdd: Ключевое ImplicitAdd слово указывает, что mod_charset_lite должен неявно вставлять свой фильтр, когда конфигурация указывает, что набор символов содержимого должен быть переведен. Если цепочка фильтров явно настроена с помощью AddOutputFilter директивы, NoImplicitAdd следует указать, чтобы mod_charset_lite не добавлять свой фильтр.
TranslateAllMimeTypes | NoTranslateAllMimeTypes: Обычно mod_charset_lite выполняется перевод только небольшого подмножества возможных MIME-типов. Когда TranslateAllMimeTypes ключевое слово указано для данного раздела конфигурации, перевод выполняется без учета MIME-типа.

Директива CharsetSourceEnc

Описание:	Исходная кодировка файлов
Синтаксис:	`CharsetSourceEnc charset`
Контекст:	конфигурация сервера, виртуальный хост, каталог, .htaccess
Переопределить:	Информация о файле
Положение дел:	Расширение
Модуль:	mod_charset_lite

Директива CharsetSourceEnc указывает исходную кодировку файлов в связанном контейнере.

Пример

 <Каталог "/export/home/trawick/apacheinst/htdocs/convert">
 CharsetSourceEnc UTF-16BE
 Набор символов по умолчанию ISO-8859-1
</Каталог>

Имена наборов символов в этом примере работают с поддержкой перевода iconv в Solaris 8.