|
||||||||||||||
Время создания: 28.10.2022 11:09
Текстовые метки: apache, web, веб, сервер, настройка, кодировка, charset
Раздел: Компьютер - Linux - Сеть в Linux - Apache
Запись: xintrea/mytetra_syncro/master/base/1666944578vuw9as7n8q/text.html на raw.github.com
|
||||||||||||||
|
|
||||||||||||||
|
Здесь перечислены опции, которые помогают настроить кодировку текстов, отдаваемых из Apache в веб-браузер. Данные опции актуальны для 8-ми битных кодировок, и не имеют смысла для кодировки Unicode. Данная документация имеет больше историческое значение, так как перечисленные здесь опции на практике давно не используются. Все возможности сервера настраиваются через конфигурационные файлы. Ниже приведено описание используемых для этого директив. (Описание конфигурации старых версий (PL16 и старше) вынесено в отдельный документ ) Некоторые замечания
Директивы, используемые для конфигурации Объявления Charsets (кодировок) и таблиц перекодировки CharsetDecl Служит для объявления character set (charset, в русском языке утвердился термин "кодировка") и указания соответствующего ему Language. В дальнейших директивах в качестве имени charset можно указывать только одно из объявленных ранее имен. Context: сервер, виртуальный сервер. Default: никаких умолчаний нет Синтаксис: CharsetDecl CharsetName Language [Flags] CharsetName Официальное название кодировки (например windows-1251, koi8-r, ibm866, iso8859-5 и.т.д.). Используется в остальных директивах при ссылках на данную кодировку и при выдаче документа клиенту в заголовке Content-type: text/html; charset=CharsetName Language Название языка, к которому принадлежит данная кодировка. Это название должно быть определено в conf/srm.conf в директивах AddLanguage и LanguagePriority. Flags Поддерживается начиная с PL22. Необязательное поле, описывающее параметры данного charset. Возможные значения:
Примеры CharsetDecl iso-8859-5 ru CharsetDecl ibm866 ru CharsetDecl windows-1251 ru CharsetDecl koi8-r ru CharsetDecl koi7 ru S Каждая директива описывает только один charset. Если существует несколько виртуальных серверов то каждый виртуальный сервер "наследует" описания Charset от основного сервера только если в директиве <VirtualServer> не описано ни одного CharsetDecl и нет ни одной директивы CharsetRecodeTable . Директивы CharsetDecl должны находиться в конфигурационном файле раньше всех прочих директив модуля. CharsetRecodeTable Служит для описания правил перекодировки из одной кодировки в другую. Context: сервер, виртуальный сервер. Default: никаких умолчаний нет Синтаксис: CharsetRecodeTable Charset1 Charset2 table_from [table_to] Charset1, Charset2 Два названия Charset (описанных ранее директивой Charset), перекодировка между которыми описывается. table_from Имя файла с таблицей, описывающей перекодировку из Charset1 в Charset2. Имя файла указывается относительно корневой директории сервера ($SERVERROOT). table_to Имя файла с таблицей, описывающей перекодировку из Charset2 в Charset1. Может отсутствовать, тогда сервер сгенерирует таблицу, обратную table_from автоматически. Для каждой пары Charset возможно два описания CharsetRecodeTable, которые являются эквивалентными. Две нижеприведенные директивы полностью одинаковы по своему эффекту: CharsetRecodeTable koi8-r windows-1251 koi-win.tab win-koi.tab CharsetRecodeTable windows-1251 koi8-r win-koi.tab koi-win.tab Какую из них использовать - дело вкуса. Если в конфигурации сервера указано несколько эквивалентных директив, то в работе будет использована последняя из них. Если в конфигурации виртуального сервера есть хотя бы одна директива CharsetDecl или CharsetRecodeTable, то описания CharsetDecl/CharsetRecodeTable не наследуются от основного сервера. CharsetWideRecodeTable Служит для описания правил перекодировки в формате символ -> строка (например для поддержки транслитерации). Context: сервер, виртуальный сервер. Default: никаких умолчаний нет Синтаксис: CharsetWideRecodeTable CharsetFrom CharsetTo table CharsetFrom, CharsetTo Два названия Charset (описанных ранее директивой Charset), перекодировка между которыми описывается. table Имя файла с таблицей, описывающей перекодировку из Charset1 в Charset2. Имя файла указывается относительно корневой директории сервера ($SERVERROOT). Формат файла очень простой - на каждой строке записывается перекодируемая буква и через пробел соответствующая ей строка Например: CharsetWideRecodeTable koi8-r koi7 conf/koi-tran.tab Если в конфигурации сервера указано несколько эквивалентных директив, то в работе будет использована последняя из них. В отличия от директивы CharsetRecodeTable, таблица обратной перекодировки (из CharsetTo в CharsetFrom) не строится автоматически. CharsetAlias Служит для описания имен псевдонимов указанных charset. Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default: никаких умолчаний нет Синтаксис: CharsetAlias Oficial_Name Alias1 Alias2 Alias3 ... Oficial_Name Официальное имя описываемого charset. Должно быть определено до данной директивы директивой CharsetDecl . Alias1 Alias2 ... Имена псевдонимов для данного charset. Примеры: CharsetAlias iso_8859-5:1988 iso-ir-144 iso_8859-5 cyrillic iso-8859-5 CharsetAlias iso_8859-5:1988 iso8859-5 iso-8859.5 iso8859.5 iso CharsetAlias ibm866 csibm866 866 cp866 x-cp866 x-ibm866 cp-866 alt CharsetAlias windows-1251 win x-cp1251 cp1251 cp-1251 Псевдонимы используются при определении кодировки клиента по заголовкам Accept:, Accept-Charset:, по server-hostname prefix и по URI prefix (см. директиву CharsetSelectionOrder ). Директивы, отвечающие за определение клиентской кодировки CharsetSelectionOrder Директива определяет порядок применения правил определения charset, в котором документ будет отдан клиенту. Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default:CharsetSelectionOrder Portnumber Hostname URIHostname EnvVariable Dirprefix Useragent Синтаксис: CharsetSelectionOrder Rule1 Rule2 Rule3 ... Rule1, Rule2, Rule3 строка, определяющая порядок анализа различных параметров запроса на предмет определения клиентских предпочтений. В качестве имени Rule могут быть использованы:
Замечания по использованию При определении charset, в котором документ будет отдан пользователю сначала анализируются HTTP-заголовки Accept-Charset и Accept (второй - если эта возможность включена при компиляции сервера, см рекомендации по установке ). Если эти заголовки присутствуют и запрошенный charset известен (виртуальному) серверу, то документ будет отдан в соответствии с просьбой клиента. Если запрошенный charset серверу неизвестен и не запрашивается "любой" charset (Accept-Charset: *), то поведение сервера зависит от наличия флага CharsetErrReject - если он установлен, то сервер вернет пользователю ошибку. Если charset не может быть определен по Accept-Charset, то сервер делает попытку определить его в соответствии с директивой CharsetSelectionOrder в порядке, описанном этой директивой. Для определения (установки) по Hostname, первые символы hostname сервера (виртуального сервера) должны соответствовать имени или алиасу какого-то из известных серверу charset. Для установки по Directory prefix, название или алиас какого-то из charset должны совпасть с первым элементом path в URL (для запроса вида /~username/path/to/file.html - совпасть с первым элементом пути после ~username). Для определения клиентского charset по HTTP-заголовку User-Agent (т.е. по WWW-броузеру у пользователя) сервер ищет в заголовке User-Agent: одну из подстрок, указанных в директиве CharsetAgent . CharsetPriority Служит для определения приоритетов сконфигурированных charsets. Может иметь значение если в запросе клиента указаны равные весовые коэффициенты для различных charsets. Старший из описанных этой директивой charset будет использован как "charset по-умолчанию" в том случае, когда такой charset не задан директивой CharsetDefault . Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default: умолчаний нет Синтаксис: CharsetPriority Charset1 Charset2 Charset3 ... Charset1 Charset2 .. Имена charset в порядке убывания приоритета (самый левый имеет высший приоритет). Все имена Charset должны быть определены до этой директивы с помощью директивы CharsetDecl . Пример: CharsetPriority windows-1251 koi8-r ibm866 В именах charset должны использоваться только официальные имена, а не псевдонимы. CharsetDefault Определяет имя charset по-умолчанию для данного сервера. Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default:Если CharsetDefault не определен, но определен CharsetPriotity, то будет использоваться charset с наибольшим приоритетом из CharsetPriority Синтаксис: CharsetDefault Charset_Name Charset_Name Официальное имя charset по-умолчанию для данного сервера, определенное директивой CharsetDecl . Пример: CharsetDefault koi8-r Это тот charset, который будет выдаваться клиенту, если все другие способы определения не сработают. CharsetByPort (работает начиная с PL20.2) Директива позволяет связать номер TCP-порта с кодировкой. Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default: никакого Синтаксис: CharsetByPort Charset_Name port_number Charset_Name Имя charset, описанного директивой CharsetDecl port_number Номер порта Пример: CharsetByPort koi8-r 8101 - при обращении к порту 8101 использовать кодировку koi8-r. Эта директива тесно коррелирует с директивой CharsetSelectionOrder , будте внимательны. Например, если у вас написано CharsetSelectionOrder Hostname, то директива CharsetPort не оказывает никакого воздействия на поведение сервера (равно как и CharsetAgent и т.п.). CharsetAgent Определяет charset, который может быть использован при нахождении в запросе клиента подстроки, идентифицирующей данного клиента. Эта подстрока ищется в запросе клиента в поле User-Agent. Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default: умолчаний нет Синтаксис: CharsetAgent Charset_Name Pattern1 Pattern2 Pattern3 ... Charset_Name Официальное имя charset Pattern1 Pattern2 ... Шаблоны для поиска в запросе клиента в поле User-Agent. Примеры: CharsetAgent windows-1251 AIR_Mosaic IWENG/1 MSIE WinMosaic (Windows (WinNT; CharsetAgent windows-1251 (Win16; (Win95; (16-bit) CharsetAgent koi8-r Arena Ariadna Macintosh OmniWeb Sextant PRD (X11 CharsetAgent ibm866 DosLynx Все Pattern являются подстроками, а не regexp выражениями. Если в заголовке User-Agent: содержится несколько подстрок, объявленных директивой CharsetAgent, то "сработает" самое длинное совпадение. CharsetStrictURIMatch (работает начиная с Pl21.3) Определяет "строгость" правил, по которым hostname/directory name будут сравниваться с именами известных кодировок при выборе Charset по Hostname/Dirprefix. Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default:CharsetStrictURIMatch Off Синтаксис: CharsetStrictURIMatch On|Off Off В режиме Off, кодировка по Hostname/Directory name будет выбрана, если первые символы Hostname/dirname совпадают с именем/алиасом какой-либо кодировки. Например, если серверу известна кодировка "win", то при обращении к директории /winnuke/ будет выбрана именно эта кодировка (естественно, в соответствии с директивой CharsetSelectionOrder On В этом режиме поведение сервера более строгое. Он будет проверять соответствие имени кодировки и полной host part в имени сервера/ полное название директории. Т.е. при известной кодировке "win" и обращении к http://winnuke.somewhere.domain кодировка по hostname выбираться не будет. С именами директорий - аналогично. Правила обработки локальных файлов CharsetSourceEnc Определяет charset, в котором документы хранятся на диске. Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default: умолчаний нет Синтаксис: CharsetSourceEnc Charsetname Charsetname Имя charset, описанное ранее директивой CharsetDecl Эта директива позволяет указать в какой кодировке находятся HTML/CGI/SSI файлы на диске. Она может быть определена в том числе и в .htaccess, что позволяет хранить дерево документов в произвольной смеси кодировок. См. также директиву CharsetByExtension и описание переменной окружения FORCE_SOURCE_CHARSET . Если кодировку хранения файла определить не удается (т.е. директивы CharsetSourceEnc и CharsetByExtension для данного расширения не указаны), то сервер вернет клиенту сообщение об ошибке и отругается в error_log. CharsetByExtension Позволяет переопределить charset хранения для файлов с каким-либо расширением. Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default: умолчаний нет Синтаксис: CharsetByExtension Charsetname .ext1 .ext2 .... Charsetname Имя charset, описанное ранее директивой CharsetDecl ext1,ext2,... Список расширений файлов, кодировкой хранения которых будет считаться Charset. Начальную точку в расширении можно указывать, а можно не указывать. Эта директива позволяет указать в какой кодировке находятся файлы с определенным расширением. Директива имеет больший приоритет, чем CharsetSourceEnc. Если для данной директории она не определена, то используется (с тем же более высоким приоритетом) "вышележащее" определение (из .htaccess директории более высокого уровня или из httpd.conf). Чтобы отключить вышележащее определение нужно задать пустую директиву CharsetByExtension. Расширение файла может содержать в себе любые символы, включая точку. Использование символа '/' как части расширения лишено смысла т.к. Apache считает, что '/' не может быть частью имени файла. CharsetProcessType (работает начиная с PL21.2) Позволяет указать серверу, что перекодировке следует подвергать какие-то добавочные MIME-types, отличные от text/*. Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default: умолчаний нет, но сервер всегда будет перекодировать тип text/* Синтаксис: CharsetProcessType mime-type mime-type MIME-type в виде type/ или type/subtype, который тоже нужно перекодировать. В редких случаях перекодировать нужно не только файлы с mime-type text/*, но и что-то еще. В таком случае нужно перечислить mime-type таких файлов этой директивой. В директиве можно указать как конкретный тип (например, image/jpeg), так и целый класс (image/). Отрицание (тип, который не нужно обрабатывать) задается символом ! ( !type/). Параметры обрабатываются слева направо, поэтому все исключения из общего правила должны быть левее общего правила (как в примере ниже) Пример: CharsetProcessType image/jpeg application/ application/php !application/ !text/plain text/ CharsetBrokenAccept (работает начиная с PL21.2) Позволяет указать серверу комбинацию User-Agent/Accept-Charset, которую следует игнорировать при определении клиентской кодировки. Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default: умолчаний нет Синтаксис: CharsetBrokenAccept Agent-Substring accept_charset_string Agent-Substring Подстрока в заголовке User-Agent (т.е. типе клиентского software). accept_chaeset_string Полная строка из заголовка Accept-Charset от данного клиентского software. В случае когда в заголовке User-Agent находится подстрока Agent-Substring и заголовок Accept-Charset, полученный от клиента полностью совпадает с accept_charset_string, сервер будет игнорировать заголовок Accept-Charset полученный от клиента и будет определять кодировку по прочим признакам. Эта директива стала необходимой с появлением Netscape Communicator 4.x - по умолчанию эта программа посылает в заголовке Accept-Charset строку "iso-8859-1,*,utf-8". В случае, когда один из сконфигурированных Charset имеет имя iso-8859-1, сервер всегда будет показывать клиенту эту кодировку, что не всегда правильно. Пример: CharsetBrokenAccept "Mozilla/4." "iso-8859-1,*,utf-8" AddHandler strip-meta-http Директива позволяет включить режим удаления тега <META HTTP-EQUIV=..> из HTML-файлов при передаче их клиенту. Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default: умолчаний нет Синтаксис: AddHandler strip-meta-http .ext1 .ext2 ..... AddHandler strip-meta-http "магические слова". На самом деле AddHandler - это директива mime_module, а strip-meta-http - название обработчика. ext1, ext2 Список расширений файлов из которых нужно выкусывать <META HTTP-EQUIV...> Эти файлы будут обрабатываться как обычный plain HTML (т.е. не как CGI и не как .shtml, вне зависимости от расширений). Директива предназначена для того, чтобы включить режим удаления тегов <META HTTP-EQUIV...> из документов, показываемых клиентам. Эти теги вставляет, например, Microsoft FrontPage. Рассуждениям на тему почему эти теги нужно выкусывать посвящен отдельный документ ). Если для одного расширения указано несколько AddHandler обработчиков, то какой из них сработает - зависит от конфигурации сервера. CharsetBadAgent Некоторые клиентские программы не могут адекватно реагировать на MIME, например при получении заголовка Content-type: text/html; charset=koi8-r; level=3 Чтобы сервер не выдавал таким клиентским программам charset=... этих клиентов нужно описать директивой CharsetBadAgent. Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default: умолчаний нет Синтаксис: CharsetBadAgent Pattern1 Pattern2 Pattern3 ... Pattern1 Pattern2 ... Подстрока в поле User-agent запроса клиента, при нахождении которой сервер будет воздерживаться от выдачи charset=... Пример: BadAgent lynx/2.1 arena Все Pattern являются подстроками, а не regexp выражениями. Как справедливо заметил Andrey Chernov , указывать в этой директиве только название броузера, не указывая конкретной версии - значит нарываться на неприятности в будущем. К сожалению, до версии PL14 включительно, вместе с Apache-RUS распространялся "дистрибутивный" конфигурационный файл, в котором было сделано именно так (в BadAgent указаны lynx и MSIE). Начиная с версии PL15 это упущение исправлено. Правильная (на день написания этого текста) строка выглядит так: CharsetBadAgent arena Lynx/2.0 Lynx/2.1 Lynx/2.2 Lynx/2.3 Lynx/2.4 "MSIE 2.0;" CharsetErrReject Директива служит для определения сервером действий при получении в запросе клиента неизвестного charset. Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default:CharestErrReject Off Синтаксис: CharsetErrReject On|Off При установке этого параметра в On сервер не будет выдавать документ клиенту в случае невозможности удовлетворить запрос, полученный в заголовках Accept/Accept-Charset, а будет сообщать клиенту об ошибке в запросе. При установке в Off - попытается определить charset по другим параметрам (см директиву CharsetSelectionOrder ) и выдаст документ как сможет. CharsetUseMultiViews (старое название - CharsetMatchLanguage, переименована в PL25.6) Директива определяет случаи, в которых сервер будет выдавать charset=xxx в заголовке Content-Type:. Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default: CharsetUseMultiViews Off (в версиях младше PL25.6 - On) Синтаксис: CharsetUseMultiViews On|Off При установке этого параметра в On (значение по умолчанию) сервер выдает charset=... в заголовке Content-Type при соблюдении всех трех условий:
При установке флага в Off сервер проверяет только первое условие (соответствие User-Agent/bad-agent list). CharsetRecodeHeaders (работает начиная с PL20) Директива включает перекодировку заголовков выдаваемых в HTTP-response. Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default: CharsetRecodeHeaders Off Синтаксис: CharsetRecodeHeaders On|Off При установке этого параметра в On будут перекодироваться выдаваемые сервером заголовки. По-умолчанию такой перекодировки не производится т.к. старые версии не перекодировали и возникают серьезные проблемы с совместимостью. Директиву нужно использовать, если в заголовках может быть русский текст (скажем, Location: /some.cgi?Вася) CharsetDisable (старое название - CharsetTurnOff, переименована в PL25.0) (работает начиная с PL20) Директива выключает весь charset-processing module. Т.е. никакая перекодировка для данной <Directory>, <Location> и т.п. производиться не будет. Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default: CharsetDisable Off Синтаксис: CharsetDisable On|Off Эта директива выключает перекодировки и AutoRedirect. При этом продолжают работать директивы CharsetSoftRedirect* и установка переменных CHARSET_HTTP_METHOD,CHARSET_SERVER_PORT, CHARSET_SERVER_NAME. CharsetRecodeFilenames (работает начиная с PL21) Директива включает перекодировку имен файлов в HTTP-запросе. Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default: CharsetRecodeFilenames On (для совместимости с прошлыми версиями) Синтаксис: CharsetRecodeFilenames On|Off При установке этого параметра в On будут перекодироваться имена файлов в URL. По умолчанию эта перекодировка производится (для совместимости с предыдущими версиями), однако эта перекодировка потенциально очень вредна и "странно" работает (все директивы класса Alias, Redirect и так далее получают неперекодированное имя, проверка прав тоже производится для неперекодированного имени, а потом оно перекодируется), поэтому поведение по-умолчанию может быть изменено после переходного периода. Использование перекодировки имен файлов не рекомендуется. См. также некоторые замечания на эту тему . CharsetSoftRedirect (работает начиная с PL21.1) Директива предназначена для замены директивы Redirect (из mod_alias) в случае работы с "перекодировкой по портам". Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default: никакого Синтаксис: CharsetSoftRedirect [status] old-url new-url Параметры: status (необязательный параметр) - описывает HTTP status code, который будет передан клиенту. Возможные значения:
old-url "старый" URL - который должен быть перенаправлен. Указывается относительно Server-Root new-url "новый" URL - тот, который должен быть указан вместо старого. Эта директива предназначена для замены стандартной директивы Redirect в случае использования "перекодировки по портам". Проблема стандартного Redirect заключается в том, что в качестве new-url нужно указывать URL полностью - с указанием протокола, имени сервера и порта. В то же время, при редиректах "в пределах текущего сервера" ни протокол, ни имя сервера, ни порт обычно не меняются для одного клиента, но могут быть разными для разных. CharsetSoftRedirect подставляет при редиректе текущие порт и hostname сервера. Пример: CharsetSoftRedirect temp /index.html /new-index.html CharsetSoftRedirectPermanent (работает начиная с PL21.1) Директива предназначена для замены директивы RedirectPermanent (из mod_alias) в случае работы с "перекодировкой по портам". Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default: никакого Синтаксис: CharsetSoftRedirectPermanent old-url new-url Параметры: old-url "старый" URL - который должен быть заредиректен. Указывается относительно Server-Root new-url "новый" URL - тот, который должен быть указан вместо старого. Директива аналогична CharsetSoftRedirect permanent old-url new-url Пример: CharsetSoftRedirectPermanent /index.html /new-index.html CharsetSoftRedirectTemp (работает начиная с PL21.1) Директива предназначена для замены директивы RedirectTemp (из mod_alias) в случае работы с "перекодировкой по портам". Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default: никакого Синтаксис: CharsetSoftRedirectTemp old-url new-url Параметры: old-url "старый" URL - который должен быть заредиректен. Указывается относительно Server-Root new-url "новый" URL - тот, который должен быть указан вместо старого. Директива аналогична CharsetSoftRedirect temp old-url new-url Пример: CharsetSoftRedirectTemp /index.html /new-index.html CharsetOverrideExpires (работает начиная с PL21.2) Директива определяет поведение сервера в случае, когда документ должен быть сделать некэшируемым с помощью выдачи заголовка Expires:, но этот заголовок уже поставлен каким-то другим модулем. Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default:On Синтаксис: CharsetOverrideExpires On|Off В режиме On сервер будет заменять значение заголовка Expires своим (обычно, 01 Jan 1970) в том случае, когда выдаваемый документ нужно сделать некэшируемым. В режиме Off будет оставаться значение, поставленное другими модулями или CGI-скриптом. Если никакого заголовка Expires другими модулями не поставлено и не включена директива CharsetDisableForcedExpires On, то сервер выдаст заголовок Expires: CharsetDisableForcedExpires (работает начиная с PL24.0) Директива запрещает выдачу заголовка Expires: 1 Jan 1970 модулем русификации. Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default:Off Синтаксис: CharsetDisableForcedExpires On|Off В режиме Off (умолчание) сервер будет выдавать заголовок Expires: 1 Jan 1970 для всех документов, которые должны быть сделаны некэшируемыми (т.е. тех, в определении кодировки которых принимали участие данные, полученные от клиента - User-Agent или Accept-Charset не совпадающий с кодировкой, определенной по URL). Это - нормальное поведение сервера, если оно не устраивает для сервера в целом, то разумное решение проблемы описано в FAQ . Однако Expires: бывает нужно запретить для отдельных документов, к ним относятся формы и framesets (в противном случае при reload или back пользователю будет показан начальный frameset или пустая форма). Только для этого режима работы и предназначена данная директива - если она включена для данного File/Location/etc, то Expires не выдается. Использование CharsetDisableForcedExpires для сервера/директории в целом потенциально весьма разрушительно. CharsetRecodeMethodsIn & CharsetRecodeMethodsOut (работает начиная с PL23) Директивы включает/выключает перекодировку для индивидуальных типов запросов (GET, POST, PUT) соответственно в направлении клиент->сервер и обратно. Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default:CharsetRecodeMethods* ALL Синтаксис: CharsetRecodeMethodsIn method1 [method2 [method3 [..]]] CharsetRecodeMethodsOut method1 [method2 [method3 [..]]] methodN - одно из ключевых слов GET, POST, PUT, ALL, NONE. Вне зависимости от того, производятся ли реальные перекодировки или нет, в запросе (CGI-скрипте) доступны переменные CHARSET - кодировка клиента и SOURCE_CHARSET - "кодировка сервера" CharsetRecodeMultipartForms (работает начиная с PL23) Директива включает/выключает перекодировку для запросов типа POST с Content-Type: multipart/form-data. К таким запросам относится FileUpload, который нельзя перекодировать, если клиент передает двоичные данные. Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default:On Синтаксис: CharsetRecodeMultipartForms On|Off В режиме On сервер будет перекодировать все запросы, в режиме Off - только запросы, Content-Type которых отличается от multipart/form-data. CharsetDisableAcceptCharset (работает начиная с PL27.0) Директива запрещает обработку заголовка Accept-Charset и выдачу заголовка Vary: accept-charset Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default:Off Синтаксис: CharsetDisableAcceptCharset On|Off В режиме Off (умолчание) сервер будет обрабатывать получаемый от пользователя заголовок Accept-Charset и выдавать документы в соответствии с ним. Одновременно выдается заголовок Vary: accept-charset, что отвечает стандарту HTTP/1.1. В режиме On заголовок Accept-Charset не обрабатывается, Vary не выдается. Назначение. Директива предназначена для обхода ошибки в Microsoft Internet Explorer 4.0x. Этот броузер считает некэшируемыми все документы в которых есть Vary: accept-charset (что приемлемо, но слишком жестоко - документ не должен кэшироваться если Accept-Charset сменился между запросами). Как следствие, если заполнить форму, а потом нажать Back, то форма будет перезапрошена с сервера и пользователь увидит ее пустой. Использование CharsetDisableAcceptCharset для сервера с автоматическим выбором кодировки по броузеру клиента нарушает стандарты. Владельцы правильных броузеров (с Accept-Charset) не будут видеть правильной кодировки. Автоматическое перенаправление (redirect) клиентов на URL без автоматического выбора кодировки Автоматическое определение клиентской кодировки "по броузеру" удобно в эксплуатациии, но порождает проблему - выдаваемые документы не кэшируются ни транзитными proxy-серверами (почему нельзя кэшировать документы с определением кодировки по клиентскому броузеру написано здесь ). Очевидно, что решением проблемы будет - определить клиентскую кодировку (по заданным директивой CharsetSelectionOrder правилам) и выдать HTTP-Redirect на документ в той же кодировке, но с правильным URL (например, с http://www.server.ru/ -> http://www.server.ru/koi8-r/). Эта возможность появилась в Russian Apache начиная с версии PL28.0, для настройки такого поведения сервера используются следущие директивы: CharsetAutoRedirect (работает начиная с PL28) Директивы включает выдачу Redirect на URL, кодировка которых не зависит от пользовательских броузеров. Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default:нету Синтаксис: CharsetAutoRedirect charset urlprefix charset - одна из кодировок, известных серверу. urlprefix - то, что подставляется в начало запрошенного пользователем URL. Может иметь вид:
Редирект можно запретить, установив переменную окружения CHARSET_NOREDIRECT (например через BrowserMatch). Пример: CharsetAutoRedirect koi8-r http://server:8100/koi8-r/ CharsetAutoRedirect windows-1251 http://server:8101 CharsetAutoRedirect iso-8859-5 :8102 CharsetAutoRedirect ibm866 /ibm866 Представим, что пришел запрос на http://server2/file.html. В этом случае, в зависимости от кодировки клиента, сервер выдаст запрос на один из следующих URL:
Редирект выдается после определения клиентской кодировки, причем правила определения кодировки не меняются (и задаются через CharsetSelectionOrder ). Поэтому такая вот конфигурация: CharsetSelectionOrder Portnumber Useragent CharsetByPort koi8-r 8101 CharsetByPort windows-1251 8100 CharsetAutoRedirect koi8-r :8100 CharsetAutoRedirect windows-1251 :8101 приведет к бесконечному зацикливанию. Если порт не указан, то он сохраняется при редиректе, поэтому если подразумевается порт по-умолчанию (80), то нужно явно писать http://server:80/. CharsetNormalizeToURL (работает начиная с PL28) Директива предназначена для "нормализации" URL объектов, содержащих бинарные (т.е. неперекодируемые) данные. Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default:нет Синтаксис: CharsetNormalizeToURL urlprefix [minimal-size] urlprefix - URL с которого должен начинаться канонический URL бинарного документа.
minimal-size - минимальный размер документа, для которого нужно производить "нормализацию" URL. По-умолчанию, 0 байт. Редирект можно запретить, установив переменную окружения CHARSET_NOREDIRECT (например через BrowserMatch). Пример: CharsetNormalizeToURL :80 200 Данная директива заставляет сервер выдавать редирект на все запросы к бинарным (неперекодируемым) данным, размер которых больше 200 байт. Скажем, если был запрос к http://server:8100/bigimage.gif, то будет выдан редирект на http://server:80/bigimage.gif. Это нужно для того, чтобы бинарные данные не оседали в кэшах во многих экземплярах. Если порт не указан, то он сохраняется при редиректе, поэтому если подразумевается порт по-умолчанию (80), то нужно явно писать http://server:80/. С помощью этой директивы легко реализовать отдельный "сервер картинок" т.е. перенаправить все запросы к картинкам на другую машину: CharsetNormalizeToURL http://images.mydomain.ru Редиректы выдаются только для MIME-types, описанных директивой CharsetNormalizeTypes . CharsetNormalizeTypes (работает начиная с PL28) Определяет MIME-types, для которых будет выполняться нормализация URL (см. CharsetNormalizeToURL ). Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default:нет Синтаксис: CharsetNormalizeTypes type1/ type2/subtype type3/ !type4/subtype type4/ type5/subtype !type5/ Синтаксис и логика перечисления mime-types аналогичны директиве CharsetProcessType . Пример: CharsetNormalizeTypes application/zip video/mpeg image/ CharsetRedirectFromOriginalURL (работает начиная с PL28.7) Определяет URL относительно которого будет производиться redirect. Директива имеет смысл, если URL поменялся в процессе обработки каким-либо модулем Apache (например, mod_rewrite), если URL не менялся, то никакого влияния не будет. Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default:Off Синтаксис: CharsetRedirectFromOriginalURL On|Off Эта директива имеет значение, если в процессе обработки запроса сервером оригинальный был изменен на какой-либо еще (например, через RewriteRule с флагом PT). Если флаг CharsetRedirectFromOriginalURL имеет значение Off, то редирект, определенный директивой CharsetAutoRedirect будет производится относительно нового (измененного) URL, если On, то относительно оригинального (введенного пользователем) URL. CharsetNoAutoRedirectForDefaultCharset (работает начиная с PL28.16) Определяет, производить ли AutoRedirect, если кодировка клиента определена не по содержимому запроса (т.е. не по URL/AcceptCharset/UserAgent, а по CharsetDefault/CharsetPriority). Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess Default:Off Синтаксис: CharsetNoAutoRedirectForDefaultCharset On|Off Назначение этой директивы - не производить редиректа, если клиент пришел на URL c автоматическим выбором кодировки без заголовка Accept-Charset и с неизвестным (не описанным директивой CharsetAgent ) User-Agent. Наиболее типичный пример - поисковая система. Если эта директива включена, то такой клиент получит требуемый документ. Если выключена - редирект на "кэшируемый" URL с этим документом. Управление перекодировками из других модулей. При необходимости явно задать кодировку хранения документа (из которой производится перекодирование), либо кодировку клиента (в которую производится перекодирование) другие модули могут использовать такие переменные окружения (в r-<subprocess_env): FORCE_CHARSET Устанавливает кодировку клиента, если это разрешено директивой конфигурации CharsetSelectionOrder . FORCE_SOURCE_CHARSET Устанавливает исходную ("на диске") кодировку документа. Имеет больший приоритет, чем CharsetSourceEnc и CharsetByExtension . Дополнительные переменные окружения CGI-скриптов Для удобства написания нетривиальных CGI-скриптов, сервер добавляет несколько дополнительных переменных окружения, доступных как для CGI, так и для модулей. CHARSET в этой переменной содержится "официальное" название кодировки клиента т.е. той, в которой документ будет отдан после перекодировки. SOURCE_CHARSET Кодировка исходного документа (по мнению сервера). Для CGI-скриптов это означает, что их вывод должен быть в этом charset. CHARSET_SERVER_NAME Имя сервера и номер порта в формате www.domain:1234 Эту переменную пришлось добавить т.к. в переменной HTTP_HOST содержится то, что сервер получил в заголовке Host:, а в переменной SERVER_PORT - номер порта, сконфигурированный директивой Port. Что никак не может устроить. CHARSET_SERVER_PORT Номер порта к которому был текущий запрос CHARSET_HTTP_METHOD http:// или https://. Т.е. полный URL запроса восстанавливается как ${CHARSET_HTTP_METHOD}${CHARSET_SERVER_NAME}${REQUEST_URI} CHARSET_SAVED_QUERY_STRING значение переменной QUERY_STRING до перекодировки CHARSET_SAVED_PATH_INFO значение переменной PATH_INFO до перекодировки Переменные CHARSET и SOURCE_CHARSET ставятся сервером только если mod_charset "включен" (CharsetDisable Off), остальные три переменные ставятся всегда. |
||||||||||||||
|
Так же в этом разделе:
|
||||||||||||||
|
||||||||||||||
|
||||||||||||||
|
||||||||||||||
