- Головна
- Документація
- Конфігурація
Конфігурація
Конфігурація сайту — це один PHP-файл, що повертає масив. Інсталятор записує його один раз із шаблону configs/system.config.default.php; жодна команда не змінює його надалі — редагуйте вручну. Все інше — назва сайту, мови, користувачі, шаблони листів — зберігається в базі даних і редагується в адмінці.
Файл
- Сайт читає лише
web/system.config.php. Інсталятор записує конфігурацію доconfigs/system.config.<host>.phpу репозиторії — доступний лише його власнику та ігнорується git — і робитьweb/system.config.phpпосиланням на нього. - З параметром
--config=FILEінсталятор читає або записує вказаний файл і не створює посилання: зробіть посиланняweb/system.config.phpсамостійно. - Без файлу кожна сторінка показує
Configuration file … not found. - Кожна команда
setup, крімinstallіdemo, спочатку читає конфігурацію і зупиняється, якщо в ній відсутніsite.debugабоmodules.
Ключі шаблону
| Ключ | У шаблоні | Що робить |
|---|---|---|
modules |
share, user, seo |
Модулі ядра та їхні теки. Їхні назви також розв'язують скорочені імена класів компонентів. |
database.host, database.port, database.socket |
записує інсталятор | Адреса MariaDB: за замовчуванням localhost і 3306; сокет, якщо вказаний, замінює хост і порт. |
database.db, database.username, database.password |
записує інсталятор | База даних, її користувач і пароль. |
site.domain |
записує інсталятор | Хост сайту, із :port, якщо порт нестандартний — єдине джерело адреси сайту. Див. Адреса та налаштування сайту. |
site.root |
/ |
Шлях сайту. |
site.debug |
0 |
Режим налагодження: 1 — увімкнено, 0 — вимкнено. Див. Помилки та налагодження. |
site.aggressive_cleanup |
1 |
Очищає HTML текстів за допомогою PHP tidy перед збереженням; працює лише якщо завантажено розширення tidy. |
site.action_log |
Energine\share\components\ActionLog |
Веде «Журнал действий» (Журнал дій) за адресою /admin/action-log/; порожнє значення — записи не ведуться. |
document.transformer |
main.xslt |
Головний XSLT-вигляд, у теці site/modules/main/transformers/. Див. Тема. |
thumbnails |
[] |
Іменовані розміри попереднього перегляду зображень. Див. Файли. |
session.lifespan |
108000 |
Тривалість сесії після останнього запиту, у секундах: 30 годин. |
session.timeout |
6000 |
Не використовується. |
mail.from |
[email protected] |
Відправник кожного листа. Див. Пошта. |
mail.smtp |
закоментовано | SMTP-сервер; без host листи надсилаються через PHP mail(). |
repositories.mapping |
repo/local → FileRepositoryLocal |
Клас файлового репозиторію. |
repositories.quick_upload_path |
uploads/public |
Тека для швидкого завантаження з файлових полів. |
seo.sitemapSegment, seo.sitemapTemplate |
google-sitemap, google_sitemap |
Адреса та шаблон XML-карти сайту. Без блоку seo файл robots.txt закриває весь сайт. |
setup_dir |
ROOT_DIR . '/setup' |
Тека консольного інструменту. |
Ключі, вилучені з шаблону у 2026 році — project, site.useTimer, site.asXML, site.vars — не читаються; стара конфігурація, що їх містить, працює коректно.
Ключі поза шаблоном
| Ключ | Що робить |
|---|---|
site.static, site.media, site.resizer |
Альтернативні базові адреси для статичних файлів, медіа та ресайзера; за замовчуванням — власна адреса сайту. |
database.persistent |
Постійне з'єднання з базою даних; за замовчуванням вимкнено. |
document.errorTransformer |
XSLT-вигляд для сторінок 403 і 404; за замовчуванням — document.transformer. |
mail.smtp.helo |
Ім'я, яке SMTP-клієнт передає в EHLO; за замовчуванням — хост сайту. |
Зафіксовано в коді: часовий пояс — Europe/Kyiv, сесійна cookie — NRGNSID.
Середовище
- Під час роботи сайт не читає змінні середовища. Інсталятор читає
ENERGINE_DB_PASSWORDіENERGINE_ADMIN_PASSWORD. - PHP-параметри
upload_max_filesizeіpost_max_sizeобмежують завантаження файлів. Ресайзер зберігає кеш уupload_tmp_dirабо в системній тимчасовій теці та підвищуєmemory_limitдо 256M для великих зображень. - Необхідні PHP-розширення перелічені в розділі Встановлення.
Налаштування в базі даних
- «Настройки сайта» (Налаштування сайту): назва, опис і ключові слова сайту кожною мовою, прапорці robots і власні параметри — див. Адреса та налаштування сайту.
- Мови, користувачі, групи та права і шаблони листів — також в адмінці.
Коли оновлення додає нові ключі до шаблону, скопіюйте їх у свою конфігурацію — див. Оновлення.