Anna: Created page with "Навигация: Главная страница/Система ejudge/Использование/Конфигурационные файлы/[[regis..."

2012-02-22T10:08:30Z

Created page with "Навигация: Главная страница/Система ejudge/Использование/Конфигурационные файлы/[[regis..."

New page

Навигация: [[Main Page|Главная страница]]/[[Система ejudge]]/[[Использование]]/[[Конфигурационные файлы]]/[[register.xml]]/[[register.xml:info|Общая информация]]

Данный конфигурационный файл используется CGI-программой <tt>[[register]]</tt>. Содержимое
файла прочитывается один раз при старте CGI-программы, то есть каждый раз, когда ктолибо посылает HTTP/HTTPS-запрос к серверу, приводящий к запуску программы register.

Местоположение конфигурационного файла определяется на этапе компиляции системы
ejudge с помощью опции <tt>--enable-cgi-conf-dir</tt> скрипта <tt>[[configure]]</tt>. Эта опция позволяет установить каталог, в котором находятся конфигурационные файлы всех CGI-программ.

Если опция не была указана в командной строке configure, предполагается значение по
умолчанию, равное <tt>../cgi-data</tt>. Местоположение каталога конфигурационных файлов,
задаваемого опцией <tt>--enable-cgi-conf-dir</tt> может быть как абсолютным, так и относительным путём. В случае относительного пути точкой отсчёта является каталог, в котором находится сама CGI-программа <tt>[[register]]</tt>. Для этого используется переменная окружения
<tt>SCRIPT_FILENAME</tt>, устанавливаемая веб-сервером при запуске CGI-программы.

Таким образом, если, например, CGI-программы располагаются в каталоге
<tt>/home/httpd/cgi-bin</tt>, то при значении пути к конфигурационным файлам
<tt>../cgi-data</tt>, конфигурационные файлы CGI-программ должны располагаться в каталоге
<tt>/home/httpd/cgi-data</tt>.

Конфигурационный файл программы <tt>register</tt> может называться <tt>register.xml</tt> или
<tt>register-</tt>''N''<tt>.xml</tt>, где ''N'' — номер турнира (см. ниже), но и конфигурационный файл вообще
может отсутствовать. Для этого необходимо, чтобы все настройки, которые считываются из
конфигурационного файла, были установлены при компиляции системы с помощью опций
скрипта <tt>[[configure]]</tt>.

Чтобы конфигурационный файл программы <tt>register</tt> был необязательным, необходимо,
чтобы программа <tt>register</tt> была открыта для доступа со всех IP-адресов (дополнительные
ограничения, конечно, могут задаваться для каждого турнира в конфигурационном файле турнира). Кроме того, при компиляции системы <tt>ejudge</tt> необходимо указание опций <tt>--enable-charset</tt>, <tt>--enable-socket-path</tt> и <tt>--enable-conf-dir</tt>.
Если конфигурационный файл не найден или не может быть открыт, используется следующий встроенный конфигурационный файл по умолчанию:
<?xml version="1.0" ?>
<register_config>
<access default="allow"/>
</register_config>
Опции <tt>--enable-charset</tt>, <tt>--enable-socket-path</tt> и <tt>--enable-conf-dir</tt>
скрипта <tt>[[configure]]</tt> позволяют в этом случае установить значения по умолчанию для
остальных необходимых элементов конфигурационного файла.

При запуске программы <tt>register</tt> вначале определяется идентификатор турнира. Идентификатор турнира определяется либо по параметру запроса <tt>contest_id</tt>, либо по имени,
под которым вызывается программа register, причем параметр запроса <tt>contest_id</tt> имеет
приоритет. В случае, когда идентификатор турнира не определен или определен по параметру
запроса <tt>contest_id</tt>, всегда используется конфигурационный файл <tt>register.xml</tt>. Если
конфигурационный файл не существует, то будут использоваться значения по умолчанию.

Определение идентификатора турнира по имени программы является устаревшим механизмом и не рекомендуется для использования. В этом случае программа <tt>register</tt> должна называться <tt>register-</tt>''N'', где ''N'' — десятичное число-идентификатор турнира. Этого можно добиться созданием символических или жестких ссылок в каталоге CGI-программ веб-сервера.Тогда сначала будет сделана попытка считать конфигурационный файл <tt>register-</tt>''N''<tt>.xml</tt>,
затем, если эта попытка завершилась неудачно, будет сделана попытка считать конфигурационный файл <tt>register-</tt>''N′''<tt>.xml</tt>, где ''N′'' — это число, напечатанное с 6 десятичными
знаками, включая незначащие нули, например, <tt>register-000001.xml</tt>. Если это попытка
завершилась неудачно, будет сделана попытка считать конфигурационный файл <tt>register-</tt>''N′′''<tt>.xml</tt>, где ''N′′'' — число, напечатанное без ведущих незначащих нулей. Наконец, будет
сделана попытка считать конфигурационный файл <tt>register.xml</tt>, и в случае неуспеха
будут использоваться значения по умолчанию.

Register.xml:info - Revision history

Anna: Created page with "Навигация: Главная страница/Система ejudge/Использование/Конфигурационные файлы/[[regis..."