Данный файл описывает настройки для различных хостов. Хост определяется следующими параметрами:

• hostname – имя хоста, например mysites.ru или mysite;
• webroot – путь до сайта. Если ваш сайт находится не в корне, а в какой-либо папке, например http://localhost/mysite/, то для того, чтобы сайт определился, в webroot нужно добавить mysite, а hostname указать как localhost;
• port – текущий порт, на котором развернут сайт, по умолчанию – 80;
• protocol – http или https;

В sites.xml вы можете описать сразу несколько сайтов, например обычную и мобильную версию. Соответственно в pages.xml для разных сайтов будет применятся свой набор правил.

Сайт определяется путем xpath запроса к скомпилированному файлу sites.xml (с учетом наследований и переопределений), в котором указаны текущие hostname, webroot, port и protocol. Если сайт не определился, то на экране вы увидите ошибку 501 Not Implemented. Если сайт определился, то происходит инициализация pages.xml и обработка текущего url.