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

Налаштування сайту зберігаються у двох місцях: у файлі конфігурації — по одному на кожну інсталяцію — та в базі даних, де адміністратор керує сайтами, їхніми доменами, назвами і сторінками.

Файл

Сайт читає лише 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>.