- Главная
- Документация
- Конфигурация
Конфигурация
Конфигурация сайта — это один 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 перечислены в разделе Установка.
Настройки в базе данных
- «Настройки сайта»: название сайта, описание и ключевые слова для каждого языка, директивы для robots и ваши собственные параметры — см. Адрес и настройки сайта.
- Языки, пользователи, группы и права, а также почтовые шаблоны — настраиваются там же, в панели управления.
Если при обновлении в шаблоне появляются новые ключи, скопируйте их в свою конфигурацию вручную — см. Обновление.