Конфигурация

Настройки сайта хранятся в двух местах: в конфигурационном файле — одном на всю установку — и в базе данных, где администратор управляет сайтами, их доменами, названиями и страницами.

Файл

Сайт читает только htdocs/system.config.php — PHP-файл, возвращающий массив. Он создаётся из шаблона на шаге 5 раздела Установка: cp configs/system.config.default.php htdocs/system.config.php, после чего нужно заменить заглушки 'PATH TO CORE', 'DB HOST NAME', 'DB NAME', 'DB LOGIN', 'DB PASSWORD' и 'PROJECT DOMAIN NAME'. Файл находится в корне документов и остаётся закрытым от внешнего доступа только при условии, что веб-сервер передаёт файлы .php интерпретатору PHP; см. раздел Известные риски.

Ключи шаблона

Ключ В шаблоне Назначение
setup_dir ROOT_DIR . '/setup' папка консольного инструмента
modules 11 модулей модули ядра; setup создаёт символические ссылки на каждый из них в core/modules/ проекта
database host, port, db, username, password подключение к MariaDB
site.domain заглушка основной хост: setup install записывает его как адрес сайта, а сессионный cookie устанавливается для него и его поддоменов
site.root / путь сайта, записываемый командой setup install вместе с адресом
site.debug 1 режим отладки; на рабочем сайте установите 0 — см. ниже
site.useTimer 1 добавляет заголовок X-Timer со временем формирования страницы
site.asXML 0 при значении 1 каждая страница возвращается в виде XML
site.aggressive_cleanup 1 очищает HTML текстов через PHP-расширение tidy, если оно загружено
site.action_log Energine\share\components\ActionLog журналирует сохранение и удаление записей в гридах и страницах административной панели; пустое значение — журнал не ведётся
site.vars, site.js-lib закомментированные примеры значения, передаваемые в XML каждой страницы; адреса jQuery и MooTools
document.transformer main.xslt главная XSLT-таблица стилей в site/modules/main/transformers/
document.xslcache 0 кэширование XSLT через PHP-расширение xslcache; релиз тестируется с отключённым кэшированием
thumbnails 8 размеров дополнительные изображения файла, по одному на каждый размер; см. Файлы и медиа
session.lifespan 108000 время жизни сессии в секундах: 30 часов
session.timeout, project, mail.feedback — не используются ни одним модулем
mail.from [email protected] отправитель всех писем
mail.manager [email protected] получает результаты конструктора форм, если в форме не указан адрес получателя
mail.subscriptions news, crm виды рассылок и их классы; см. Рассылки
repositories mapping, quick_upload_path, ftp файловые репозитории; см. Файлы и медиа
seo sitemapSegment, sitemapTemplate, maxVideosInMap карта сайта Google; без этих ключей robots.txt закрывает сайт от индексирования
wysiwyg.styles закомментированный пример дополнительные стили визуального редактора

Ключи вне шаблона

Ключ Назначение
site.static, site.media, site.resizer альтернативные базовые адреса для статических файлов, медиа и ресайзера изображений
site.compress сжимает ответы с помощью gzip, если браузер поддерживает сжатие и режим отладки выключен
site.cache кэширует структуру базы данных в папке cache/ проекта (../cache/ относительно htdocs/), при выключенном режиме отладки и наличии прав на запись; очищайте кэш после изменения таблиц — конструктор форм делает это автоматически
site.dev_domains при включённом режиме отладки — список доменов, используемых вместо доменов из базы данных
database.persistent постоянное соединение с базой данных
document.errorTransformer XSLT-таблица стилей для страниц ошибок 403 и 404; по умолчанию используется document.transformer
forms.database, forms.result_num_fields база данных таблиц конструктора форм; количество столбцов в результатах
repositories.watermark класс, накладывающий водяной знак на изображения, загружаемые в репозиторий

Зафиксировано в коде: часовой пояс Europe/Kyiv и сессионный cookie NRGNSID.

Режим отладки

site.debug равен 1 в шаблоне — для разработки. При включённом режиме:

  • параметр ?debug в адресе страницы возвращает XML этой страницы;
  • страницы ошибок показывают файл и номер строки;
  • рассылки не отправляются: каждое письмо дописывается в htdocs/uploads/tmp/mailout.txt, который отдаётся веб-сервером — письма о регистрации, восстановлении пароля и от форм по-прежнему доставляются;
  • setup linker создаёт символические ссылки на скрипты вместо копирования их минифицированных версий;
  • кэш базы данных и gzip отключены.

Режим отладки не управляет display_errors: ядро включает его самостоятельно. Отключите его в пуле PHP-FPM сайта с помощью php_admin_flag[display_errors] = off, как показано в разделе Установка.

В базе данных: сайты и домены

Одна установка может содержать несколько сайтов. «Редактор сайтов» (/admin/structure/sites/, или «Сайты» на панели инструментов страницы) хранит для каждого сайта «Название сайта», «Вариант дизайна» (папка внутри site/modules/), «Активный» и «Базовый», мета-теги на каждом языке, а на вкладке «Домены» — его адреса: «Протокол», «Хост», «Порт» и «Корень».

Energine сравнивает схему, хост, порт и путь каждого запроса с этими записями: соответствующий сайт отвечает на запрос, неизвестный адрес направляется к сайту по умолчанию, а отключённый сайт возвращает 403. Первый домен сайта используется как его адрес в ссылках. HTTPS-адрес или нестандартный порт — это отдельная запись; см. шаг 8 раздела Установка. Произвольные пары «имя — значение» для каждого сайта — «Свойства» в редакторе сайтов — доступны в PHP как $site-><name>.