Документация/Установка и настройка/3. Конфигурация

Настройка конфигурации

Настройки фреймворка HLEB2 хранятся в конфигурационных файлах папки /config/.
В начале некоторых из них вы можете найти строчку вроде этой:

if (file_exists(__DIR__ '/common-local.php')) { return (require __DIR__ '/common-local.php');}

Этот код означает, что при существовании файла common-local.php в этой папке его настройки будут использованы вместо текущих (файла common.php).

Таким образом, можно создать копии этих файлов с добавлением '-local' к названиям и использовать для локальной разработки, не добавляя их в систему контроля версий (т.е. без передачи на целевой сервер). Только в скопированных файлах нужно убрать эту строчку с кодом, она уже не нужна.

Раздельные настройки для локального устройства и конечного сервера дают удобство для их конфигурирования.

Во фреймворке можно получить любое значение из конфигурации по его названию, таким образом эти настройки могут быть использованы и для инициализации сторонних библиотек.


#Режим отладки

В DEBUG-режиме фреймворк работает немного иначе, чем обычно, он отображает отладочную информацию и ошибки, которые не должны быть доступны на публичном ресурсе.

Режим отладки фреймворка должен использоваться только для внутренней разработки.

Чтобы отключить/включить режим отладки, измените значение debug в файле /config/common.php на необходимое.

Подобным образом меняются значения остальных конфигурационных настроек.


#Кеширование

В режиме отладки также будет полезным отключить кеширование, которое производится средствами фреймворка. За это отвечает настройка app.cache.on в файле /config/common.php.


#Автообновление кеша маршрутов

Во фреймворке по умолчанию встроено автоматическое обновление кеша маршрутов при внесении в них изменений разработчиком приложения.
Это удобно для локальной работы с фреймворком, но в дальнейшем, когда запросов будет много, на production-сервере можно отключить автообновление и использовать вместо него специальную консольную команду при каждом внесении изменений. Режим автообновления изменяется параметром routes.auto-update в файле /config/common.php.


#Вывод ошибок в лог

По умолчанию информация о возникших ошибках сохраняется в файлы папки /storage/logs/. Если включен режим DEBUG, то дополнительно ошибки могут выводиться пользователю (в браузере или через API).
Уровень ошибок может регулироваться в настройке error.reporting файла /config/common.php. Изначально выводятся все уровни ошибок PHP (рекомендованное значение).


#Часовой пояс

За указание часового пояса для функций даты/времени отвечает настройка timezone файла /config/common.php.
По умолчанию: 'Europe/Moscow'.


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

Файл /config/database.php содержит настройки для используемых баз данных. Изначально там несколько различных примеров.
В файле настроек перечнем конфигураций является вложенный массив с ключом 'db.settings.list', из него выбирается блок настроек по умолчанию, указанный в опции 'base.db.type'.

Настройка фреймворка Структура проекта

Страница создана: @fomiash
К началу страницы