Apache: Определения терминов, используемых для описания директив Apache

RU EN

Пункт 86. Определения терминов, используемых для описания директив Apache

В этом документе описываются термины, используемые для описания каждой директивы конфигурации Apache.

Описание

Краткое описание цели директивы.

Синтаксис

Это указывает на формат директивы, как она будет отображаться в файле конфигурации. Этот синтаксис чрезвычайно специфичен для директивы и подробно описан в определении директивы. Как правило, за именем директивы следует ряд из одного или нескольких аргументов, разделенных пробелами. Если аргумент содержит пробел, он должен быть заключен в двойные кавычки. Необязательные аргументы заключены в квадратные скобки. Если аргумент может принимать более одного возможного значения, возможные значения разделяются вертикальными чертами «|». Буквенный текст представлен шрифтом по умолчанию, а типы аргументов, для которых необходима замена, выделены . Директивы, которые могут принимать переменное количество аргументов, заканчиваются на "...", указывая на то, что последний аргумент повторяется.

Директивы используют большое количество различных типов аргументов. Несколько общих из них определены ниже.

URL-адрес: Полный унифицированный указатель ресурсов, включая схему, имя хоста и необязательное имя пути, как в http://www.example.com/path/to/file.html
URL-путь: Часть URL-адреса , которая соответствует схеме и имени хоста, как в /path/to/file.html . URL -адрес представляет веб-представление ресурса, а не представление файловой системы.
Путь к файлу: Путь к файлу в локальной файловой системе, начинающийся с корневого каталога, как в /usr/local/apache/htdocs/path/to/file.html . Если не указано иное, путь к файлу , который не начинается с косой черты, будет рассматриваться как относящийся к ServerRoot.
путь к каталогу: Путь к каталогу в локальной файловой системе, начинающийся с корневого каталога, как в /usr/local/apache/htdocs/path/to/ .
имя файла: Имя файла без сопутствующей информации о пути, как в file.html .
регулярное выражение: Perl-совместимое регулярное выражение . В определении директивы будет указано, с чем сопоставляется регулярное выражение .
расширение: Как правило, это часть имени файла , следующая за последней точкой. Однако Apache распознает несколько расширений имен файлов, поэтому, если имя файла содержит более одной точки, каждая разделенная точками часть имени файла, следующая за первой точкой, является расширением . Например, имя файла file.html.en содержит два расширения: .html и .en . Для директив Apache вы можете указать расширение s с точкой в начале или без нее. Кроме того, расширения не чувствительны к регистру.
MIME-тип: Метод описания формата файла, состоящий из основного типа формата и дополнительного типа формата, разделенных косой чертой, как в text/html .
env-переменная: Имя переменной среды, определенной в процессе настройки Apache. Обратите внимание, что это не обязательно то же самое, что и переменная среды операционной системы. Дополнительные сведения см. в документации по переменным среды.

По умолчанию

Если директива имеет значение по умолчанию ( то есть , если вы полностью исключите ее из своей конфигурации, веб-сервер Apache будет вести себя так, как если бы вы установили ей определенное значение), она описана здесь. Если значение по умолчанию отсутствует, в этом разделе должно быть указано « Нет ». Обратите внимание, что указанное здесь значение по умолчанию не обязательно совпадает со значением, которое директива принимает в файле apache2.conf по умолчанию, распространяемом вместе с сервером.

Контекст

Это указывает, где в файлах конфигурации сервера директива допустима. Это список, разделенный запятыми, состоящий из одного или нескольких следующих значений:

конфигурация сервера: Это означает, что директиву можно использовать в файлах конфигурации сервера ( например , apache2.conf ), но не в каких <VirtualHost> -либо <Directory> контейнерах. .htaccess Это вообще запрещено в файлах.
виртуальный хост: Этот контекст означает, что директива может появляться внутри <VirtualHost> контейнеров в файлах конфигурации сервера.
каталог: Директива, помеченная как допустимая в этом контексте, может использоваться внутри контейнеров <Directory> , <Location> , <Files> , <If> и <Proxy> в файлах конфигурации сервера с учетом ограничений, изложенных в разделах конфигурации.
.htaccess: Если директива действительна в этом контексте, это означает, что она может появляться внутри файлов для каждого каталога .htaccess . Это может быть не обработано, хотя это зависит от активных в данный момент переопределений.

Директива разрешена только в указанном контексте; если вы попытаетесь использовать его в другом месте, вы получите ошибку конфигурации, которая либо не позволит серверу правильно обрабатывать запросы в этом контексте, либо вообще не позволит ему работать, т. е. сервер даже не запустится .

Допустимые местоположения для директивы на самом деле являются результатом логического ИЛИ всех перечисленных контекстов. Другими словами, директива, помеченная как действующая в " server config, .htaccess ", может использоваться в apache2.conf файле и в .htaccess файлах, но не в каких- <Directory> либо <VirtualHost> контейнерах.

Переопределить

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

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

Положение дел

Это указывает, насколько тесно директива связана с веб-сервером Apache; другими словами, вам может понадобиться перекомпилировать сервер с расширенным набором модулей, чтобы получить доступ к директиве и ее функционалу. Возможные значения этого атрибута:

Основной: Если директива указана как имеющая статус «Основной», это означает, что она является частью самых внутренних частей веб-сервера Apache и всегда доступна.
МПМ: Директива, помеченная как имеющая статус «MPM», предоставляется многопроцессорным модулем. Этот тип директивы будет доступен тогда и только тогда, когда вы используете один из MPM, перечисленных в строке «Модуль» определения директивы.
База: Директива, помеченная как имеющая статус «Base», поддерживается одним из стандартных модулей Apache, который компилируется в сервер по умолчанию, и поэтому обычно доступен, если вы не предприняли шаги по удалению модуля из своей конфигурации.
Расширение: Директива со статусом «Расширение» предоставляется одним из модулей, включенных в комплект сервера Apache, но этот модуль обычно не компилируется в сервер. Чтобы включить директиву и ее функциональные возможности, вам потребуется изменить файлы конфигурации сборки сервера и перекомпилировать Apache.
Экспериментальный: Статус «Экспериментальный» указывает на то, что директива доступна как часть комплекта Apache, но вы можете самостоятельно ее использовать. Директива документируется для полноты и не обязательно поддерживается. Модуль, предоставляющий директиву, может быть скомпилирован или не скомпилирован по умолчанию; проверьте верхнюю часть страницы, которая описывает директиву и ее модуль, чтобы увидеть, упоминается ли она о доступности.

Модуль

Это довольно просто перечисляет имя исходного модуля, который определяет директиву.

Совместимость

Если директива не была частью исходного дистрибутива Apache версии 2, здесь должна быть указана версия, в которой она была представлена. Кроме того, если директива доступна только на определенных платформах, это будет отмечено здесь.