Структура и формат конфигурационных файлов

Яndex.Server 3.1 настраивается с помощью размещения директив в одном или нескольких текстовых конфигурационных файлах. Основной конфигурационный файл обычно называется yandex.cfg и располагается в той же директории, в которой находится выполняемый модуль Яндекс-сервера для Windows, либо директории, из которой запущена программа, для Unix. Однако это поведение может быть переписано с помощью параметра командной строки. В некоторых директивах основного конфигурационного файла могут задаваться дополнительные конфигурационные файлы.

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

• Параметры, относящиеся к сервису в целом - только при старте сервиса.

• Параметры индексирования - при каждом запуске индексирования.

• Параметры поиска - при запуске поисковой сессии.

Каждая директива конфигурационного файла соответствует одному из параметров настройки. Директивы состоят из одного или нескольких слов, разделенных пробельными символами. Первое слово директивы является ключом, соответствующим настраиваемому параметру, остальные - аргументами, задающими значение параметра. Помимо пробельных символов, ключ директивы может отделяться от аргументов необязательными символами : (двоеточие) и = (равно), но не более, чем одним. Аргументы директивы могут отделяться друг от друга, помимо пробельных символов, символом , (запятая). Конфигурационные файлы включают одну директиву на строку. Для переноса аргументов директивы на следующую строку может быть использован обратный слеш (\), расположенный на конце строки. (То есть, если между символом обратного слеша и символом конца строки находятся только пробельные символы, то директива переносится на следующую строку, а символ \ игнорируется.) Ключи директив конфигурационного файла являются регистро-независимыми, но аргументы директив зависят от регистра символов.

Директивы конфигурационного файла могут быть сгруппированы в секции. Каждая секция начинается со строки <Имя_Секции> и кончается строкой </Имя_Секции>, где Имя_Секции соответствует параметру, который настраивается с помощью одной или нескольких директив, расположенных внутри секции.
Секции могут быть вложенными. Директивы конфигурационного файла, которые не лежат в какой-либо секции, считаются принадлежащими подразумеваемой главной секции, включающей весь конфигурационный файл.
Строки конфигурационного файла, расположенные внутри секции и начинающиеся с символов #, ! или ;, рассматриваются как комментарии и игнорируются. Однако, если указанные символы встречаются в середине или конце строки, они считаются значимыми. Пустые строки и пробельные символы в начале строки игнорируются, поэтому могут использоваться, чтобы сделать запись более ясной. Помимо этого, в любом месте конфигурационного файла могут быть расположены комментарии в XML/HTML-стиле, начинающиеся с символов <!-- и заканчивающиеся символами -->.
Пример 3-1. Формат конфигурационного файла
Ниже приведен отрывок некоторого конфигурационного файла правильного формата !Следующая строка содержит директиву главной секции с ключом Debug !и аргуметами config, base и error Debug : config, base, error <!-- Ниже определена секция IndexedArea, содержащая две директивы с ключами HttpPrefix и Options и комментарий, который также включает директиву правильного формата. --> <IndexedArea> HttpPrefix / Options reindex # FilePrefix = ./mydir </IndexedArea>
Copyright © 1997 ? 2004 «Яндекс»

Содержание раздела

---

---