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

Конфігурація сайту — це один 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-розширення перелічені в розділі Встановлення.

Налаштування в базі даних

Коли оновлення додає нові ключі до шаблону, скопіюйте їх у свою конфігурацію — див. Оновлення.