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

Конфигурация сайта — это один PHP-файл, возвращающий массив. Установщик создаёт его единожды из шаблона configs/system.config.default.php; ни одна команда не меняет его в дальнейшем — редактируйте его вручную. Всё остальное — название сайта, языки, пользователи, почтовые шаблоны — хранится в базе данных и настраивается в панели управления.

Файл конфигурации

  • Сайт считывает только web/system.config.php. Установщик записывает конфигурацию в configs/system.config.<host>.php внутри репозитория — с правами на чтение только для владельца и добавленным в gitignore — и создаёт на него символическую ссылку 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 sitemap. Без блока 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 и имя сессионной куки NRGNSID.

Окружение

  • Во время работы сайт не считывает переменные окружения. Установщик использует ENERGINE_DB_PASSWORD и ENERGINE_ADMIN_PASSWORD.
  • Настройки PHP upload_max_filesize и post_max_size ограничивают объём загружаемых файлов. Модуль масштабирования хранит свой кэш в upload_tmp_dir или во временном системном каталоге и увеличивает memory_limit до 256M для обработки больших изображений.
  • Необходимые расширения PHP перечислены в разделе Установка.

Настройки в базе данных

Если при обновлении в шаблоне появляются новые ключи, скопируйте их в свою конфигурацию вручную — см. Обновление.