- Главная
- Документация
- Конфигурация
Конфигурация
Настройки сайта хранятся в двух местах: в конфигурационном файле — одном на всю установку — и в базе данных, где администратор управляет сайтами, их доменами, названиями и страницами.
Файл
Сайт читает только 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>.