Apache: Модуль Apache mod

RU EN

Пункт 213. Модуль Apache mod_xml2enc

Этот модуль обеспечивает расширенную поддержку интернационализации для модулей фильтров с учетом разметки, таких как файлы mod_proxy_html . Он может автоматически определять кодировку входных данных и обеспечивать их правильную обработку синтаксическим анализатором libxml2, включая преобразование в Unicode (UTF-8), где это необходимо. Он также может преобразовывать данные в выбранную кодировку после обработки разметки и гарантирует, что в заголовке HTTP Content-Type установлено правильное значение набора символов .

Применение

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

Модули фильтрации включены для mod_xml2enc

Такие модули, как mod_proxy_html версия 3.1 и выше, используют xml2enc_charset необязательную функцию для извлечения аргумента charset для передачи анализатору libxml2 и могут использовать необязательную xml2enc_filter функцию для постобработки в другую кодировку. При использовании mod_xml2enc с включенным модулем настройка не требуется: другой модуль настроит mod_xml2enc за вас (хотя вы все равно можете настроить его, используя приведенные ниже директивы конфигурации).

Неактивные модули

Чтобы использовать его с модулем на основе libxml2, который явно не включен для mod_xml2enc, вам придется настроить цепочку фильтров самостоятельно. Таким образом, чтобы использовать его с фильтром foo , предоставляемым модулем mod_foo , для улучшения поддержки последнего i18n с помощью HTML и XML, вы можете использовать

      
 FilterProvider iconv xml2enc Content-Type $text/html
 FilterProvider iconv xml2enc Content-Type $xml
 FilterProvider markup foo Content-Type $text/html
 FilterProvider markup foo Content-Type $xml
 FilterChain iconv markup

mod_foo теперь будет поддерживать любой набор символов, поддерживаемый одним (или обоими) из libxml2 или apr_xlate/iconv.

API программирования

Программистам, пишущим модули фильтров на основе libxml2, рекомендуется включать их для mod_xml2enc, чтобы обеспечить сильную поддержку i18n для ваших пользователей, не изобретая велосипед. Программный API представлен в mod_xml2enc.h , а пример использования — mod_proxy_html .

Обнаружение кодировки

В отличие от mod_charset_lite , mod_xml2enc предназначен для работы с данными, кодировка которых не может быть известна заранее и поэтому не может быть настроена. Поэтому он использует методы «обнюхивания» для обнаружения кодировки данных HTTP следующим образом:

Если заголовок HTTP Content-Type включает параметр charset , он используется.
Если данные начинаются с метки порядка байтов XML (BOM) или объявления кодировки XML, они используются.
Если кодировка объявлена в <META> элементе HTML, она используется.
Если ничего из вышеперечисленного не соответствует, xml2EncDefault используется значение по умолчанию, установленное.

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

Выходное кодирование

libxml2 всегда использует внутри кодировку UTF-8 (Unicode), и модули фильтрации на основе libxml2 выводят это по умолчанию. mod_xml2enc может изменить кодировку вывода через API, но в настоящее время нет возможности настроить это напрямую.

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

Неподдерживаемые кодировки

Если вы работаете с кодировками, которые не поддерживаются ни одним из методов преобразования, доступных на вашей платформе, вы все равно можете привязать их к поддерживаемой кодировке, используя xml2EncAlias .

директива xml2EncAlias

Описание:	Распознавание псевдонимов для значений кодирования
Синтаксис:	`xml2EncAlias charset alias [alias ...]`
Контекст:	конфигурация сервера
Положение дел:	База
Модуль:	mod_xml2enc

Эта общесерверная директива применяет одну или несколько кодировок к другой кодировке. Это позволяет кодировкам, не распознаваемым libxml2, обрабатываться внутренней поддержкой кодирования libxml2 с использованием таблицы перевода для распознаваемой кодировки. Это служит двум целям: поддерживать наборы символов (или имена), не распознаваемые ни libxml2, ни iconv, и пропускать преобразование для кодировки, где известно, что оно не нужно.

Директива xml2EncDefault

Описание:	Устанавливает кодировку по умолчанию, которая принимается, когда абсолютно никакая информация не может быть обнаружена автоматически.
Синтаксис:	`xml2EncDefault name`
Контекст:	конфигурация сервера, виртуальный хост, каталог, .htaccess
Положение дел:	База
Модуль:	mod_xml2enc
Совместимость:	Версия 2.4.0 и выше; доступен как сторонний модуль для более ранних версий.

Если вы обрабатываете данные с известной кодировкой, но без информации о кодировке, вы можете установить это значение по умолчанию, чтобы помочь mod_xml2enc правильно обрабатывать данные. Например, чтобы работать со значением по умолчанию Latin1 ( iso-8859-1, указанным в HTTP/1.0, используйте

 xml2EncDefault iso-8859-1

директива xml2StartParse

Описание:	Посоветуйте синтаксическому анализатору пропустить ведущий мусор.
Синтаксис:	`xml2StartParse element [element ...]`
Контекст:	конфигурация сервера, виртуальный хост, каталог, .htaccess
Положение дел:	База
Модуль:	mod_xml2enc

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

Его никогда не следует использовать для XML или правильно сформированного HTML.