- Головна
- Документація
- Конфігурація
Конфігурація
Налаштування сайту зберігаються у двох місцях: у файлі конфігурації — по одному на кожну інсталяцію — та в базі даних, де адміністратор керує сайтами, їхніми доменами, назвами і сторінками.
Файл
Сайт читає лише 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>.