Online Documentation Server
 ПОИСК
ods.com.ua Web
 КАТЕГОРИИ
Home
Programming
Net technology
Unixes
Security
RFC, HOWTO
Web technology
Data bases
Other docs

 


 ПОДПИСКА

 О КОПИРАЙТАХ
Вся предоставленная на этом сервере информация собрана нами из разных источников. Если Вам кажется, что публикация каких-то документов нарушает чьи-либо авторские права, сообщите нам об этом.




Как настроить (версия PL18 и выше)

Все вышеперечисленные возможности сервера настраиваются через конфигурационные файлы. Ниже приведено описание используемых для этого директив. (Описание конфигурации старых версий (PL16 и старше) вынесено в отдельный документ)

Некоторые замечания

  • Все директивы, кроме CharsetDecl и CharsetRecodeTable могут быть записаны где угодно - в конфигурации сервера, виртуального сервера, в <Directory>, <Location>, .htaccess. Директивы CharsetDecl и CharsetRecodeTable могут быть указаны только в конфигурации сервера или виртуального сервера.
  • При использовании директив в <Directory>, <Location> или .htaccess действует следущее правило - если определена какая-то из директив (скажем, CharsetAgent), то все "вышележащие" директивы с этим именем не действуют. Это отличается от стандартного поведения Apache (когда содержимое директив "дописывается" (merge) т.е. определение в .htaccess работает абсолютно так же, как если бы эта директива стояла сразу после директивы с тем же именем в httpd.conf). Отклонение от стандарта объясняется очень просто - имея "перезаписывание" сделать эмуляцию "дописывания" очень просто (нужно просто скопировать нужные строчки из вышележащего .htaccess или из httpd.conf), тогда как обратное неверно.

Директивы, используемые для конфигурации

Объявления 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. Возможные значения:
  1. S - (от Suppress) - подавить выдачу charset=... для данного 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 Dirprefix Useragent
Синтаксис:
CharsetSelectionOrder Rule1 Rule2 Rule3 ...
Rule1, Rule2, Rule3
строка, определяющая порядок анализа различных параметров запроса на предмет определения клиентских предпочтений. В качестве имени Rule могут быть использованы:
  • Portnumber - определять charset по номеру порта к которому обратились. Соответствие кодировки и номера порта описывается директивой CharsetByPort. Возможность связать номер порта с кодировкой появилась начиная с версии PL20.2.
  • Hostname - определять charset по подстроке в hostname сервера. Т.е. если hostname (до первой точки) сервера начинается с имени charset или его alias, то в качестве клиентского charset будет выбран именно он (т.е. при обращении к хосту win-www.domain будет выбрана кодировка с именем/алиасом win).
  • Dirprefix - определять charset по Directory prefix. Т.е. если первая часть URI (между 1-м и 2-м '/' или между /~username/ и 3-м slash) совпадает с именем или алиасом какого-то charset, то в качестве клиентского charset будет выбран именно этот charset.
  • Useragent - определять charset по HTTP-заголовку User-Agent (см директиву CharsetAgent).

Замечания по использованию
При определении 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. Если кодировку хранения файла определить не удается (т.е. директивы 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/).

Пример:

CharsetProcessType image/jpeg application/
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) и выдаст документ как сможет.
CharsetMatchLanguage
Директива определяет случаи, в которых сервер будет выдавать charset=xxx в заголовке Content-Type:.
Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess
Default: CharsetMatchLanguage On
Синтаксис:
 CharsetMatchLanguage On|Off
    
При установке этого параметра в On (значение по умолчанию) сервер выдает charset=... в заголовке Content-Type при соблюдении всех трех условий:
  1. Броузер клиента не является "bad agent"
  2. Включена опция MultiViews
  3. Language, описанный для данного типа документа директивой AddLanguage совпадает с language, описанным для выдаваемого charset директивой CharsetDecl
При установке флага в Off сервер проверяет только первое условие (соответствие User-Agent/bad-agent list).
CharsetRecodeHeaders (работает начиная с PL20)
Директива включает перекодировку заголовков выдаваемых в HTTP-response.
Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess
Default: CharsetRecodeHeaders Off
Синтаксис:
 CharsetRecodeHeaders On|Off
    
При установке этого параметра в On будут перекодироваться выдаваемые сервером заголовки. По-умолчанию такой перекодировки не производится т.к. старые версии не перекодировали и возникают серьезные проблемы с совместимостью. Директиву нужно использовать, если в заголовках может быть русский текст (скажем, Location: /some.cgi?Вася)
CharsetTurnOff (работает начиная с PL20)
Директива выключает весь charset-processing module. Т.е. никакая перекодировка для данной <Directory>, <Location> и т.п. производиться не будет.
Context: сервер, виртуальный сервер, <Directory>, <Location>, .htaccess
Default: CharsetTurnOff Off
Синтаксис:
 CharsetTurnOff On|Off
    
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, который будет передан клиенту. Возможные значения:
  • permanent - Redirect возвращает статус 301 (permanent redirect)
  • temp - Redirect вернет статус 302 (temporary redirect) - это умолчание
  • seeother - статус 303 (See Other)
  • gone - статус 410 (Document removed) - указывает, что документа больше нет. В этом случае третий аргумент (new_url) должен отсутствовать.
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-скриптом.
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.

[Prev Page] [Server Home] [Next Page]



With any suggestions or questions please feel free to contact us