Немного теории
Редактирование конфигурационных файлов
Никогда не редактируйте файлы настроек платформы, если у вас нет SSH или FTP-доступа к серверу! Если допустите ошибку в файле конфигурации, исправить ее через веб-интерфейс панели администратора уже не получится.
/bitrix/.settings.php
Основной файл настроек платформы. Важные для первого знакомства ключи массива:
connections. Содержит данные для подключения к БД сайта.exception_handling. Позволяет настраивать отображение и сохранение ошибок PHP. Чтобы включить режим отладки, необходимо установить значениеexception_handling->value->debug = true. Однако стоит помнить, что данный режим следует использовать только при разработке, или когда публичная часть сайта закрыта для неавторизованных пользователей, иначе каждый посетитель сможет увидеть путь к исходным файлам, если зайдёт на страницу с ошибкой.- Намного безопаснее логировать ошибки, указав им путь до файла в блоке
exception_handling->value->log->settings, тут можно указать имя файла (file), а также максимальный размер (log_size).
/bitrix/.settings_extra.php
Дополнительный файл пользовательских настроек платформы. Служит для расширения возможностей настроек конфигурации системы, обычно именно он добавляется в систему контроля версий. В данном файле находятся динамично изменяемые настройки системы.
/bitrix/php_interface/dbconn.php
Устаревший файл настроек. В нем хранится определение директив настроек кеширования и уровня доступа для файлов и директорий.
Важная настройка: глобальная переменная-флаг $DBDebugToFile. Если установлена, платформа будет логировать все SQL-запросы в файл mysql_debug.sql в корне сайта. Должна быть выключена (false).
after_connect_d7.php
Файл может быть расположен в папке /local/php_interface/ или /bitrix/php_interface/. Содержит в себе настройки базы данных, выполняемых после подключения. В этом файле можно определить параметры базы данных, такие как кодировка, настройка локали и другие.
Полезно
after_connect.php
Раньше существовал файл /bitrix/php_interface/after_connect.php (аналогичный по назначению after_connect_d7.php), теперь он не используется, но вы можете встретить его в проектах, которые долгое время не обновлялись.
/bitrix/php_interface/dbquery_error.php
Настройка внешнего вида сообщения об ошибке в запросе к БД. В файл можно добавить, например, логику отправки письма администратору сайта в случае возникновения ошибки.
Практика
Настроим установленную ранее платформу и решение.
В этом уроке познакомимся с настройками конфигурации:
- /bitrix/php_interface/dbconn.php;
- /bitrix/.settings.php;
- данные для подключения к БД сайта;
- настройки логирования ошибок, отображение PHP ошибок в браузере;
- логирование ошибок работы с базой данных.
Конфигурационные файлы
6 мин
Полезные ссылки и материалы