Настройки могут задаваться в файле .settings.php и .settings_extra.php. Базовый файл настроек содержит неизменные настройки,
к которым есть API. Файл .settings_extra.php может содержать произвольный код, который меняет настройки динамически.
Соответственно к нему нет API.
Пример:
/*Отвечает за кодиорвку*/
'utf_mode' =>
array (
'value' => true,
'readonly' => true,
),readonly- ключ означает, что нельзя изменить значение через API.value-true, если используетсяutfиfalseв обратном случае.
/*Отвечает за кодиорвку*/
'utf_mode' =>
array (
'value' => false,
'readonly' => true,
),value-false, то есть не используется UTF-8
/*Отвечает за кодиорвку по умолчанию*/
'default_charset' =>
array (
'value' => 'cp866',
'readonly' => false,
),value- указание кодировки по умолчанию
Пример:
/*Отвечает за кэширование*/
'cache' =>
array (
'value' =>
array (
'type' => 'memcache', /*memcache, apc, xcache, files, none*/
'sid' => '',
'memcache' =>
array (
'host' => '127.0.0.1',
),
),
'readonly' => false,
),Так же доступных специальные флаги для кэширования опций модулей:
/*Время кэширования в секундах*/
'cache_flags' =>
array (
'value' =>
array (
'config_options' => 3600,
'site_domain' => 3600,
),
'readonly' => false,
),readonly- ключ означает, что нельзя изменить значение через API.site_domain- Время кэширования куки в секундахconfig_options- Время кэширования опций модулей в секундах
Пример:
'exception_handling' => array (
'value' => array (
'debug' => false,
'handled_errors_types' => E_ALL & ~E_NOTICE & ~E_STRICT & ~E_USER_NOTICE,
'exception_errors_types' => E_ALL & ~E_NOTICE & ~E_WARNING & ~E_STRICT & ~E_USER_WARNING & ~E_USER_NOTICE & ~E_COMPILE_WARNING & ~E_DEPRECATED,
'ignore_silence' => false,
'assertion_throws_exception' => true,
'assertion_error_type' => 256,
'log' => array (
'settings' => array (
'file' => 'bitrix/modules/error.log',
'log_size' => 1000000,
),
),
),
'readonly' => false,
),readonlyключ означает, что нельзя изменить значение через API.debug- Ключ отвечает за то, будет ли выведена ошибка на страницу в браузере.handled_errors_types- Tипы ошибок, которые система отлавливает.exception_errors_types- Типы ошибок, при которых система выбрасывает исключение.ignore_silence- Ключ отменяет действие оператора управления ошибками (@).log- В ключе задаются параметры логирования ошибок.assertion_throws_exception- Включить поддержку assertassertion_error_type- Какие типы ошибок обрабатывать для assert
Если в корне сайта лежит файл error.php и выключен вывод ошибок на экран, то этот файл будет подключен в случае возникновения необработанного исключения.
Пример:
'log' => array (
'settings' => array (
'file' => 'bitrix/modules/error.log',
'log_size' => 1000000,
),
),readonlyключ означает, что нельзя изменить значение через API.file- Путь к файлу лога относительно корневой папки сайта.log_size- Максимальный размер файла лога в байтах.
Пример:
'log' => array(
'class_name' => 'MyLog',
'extension' => 'MyLogExt',
'required_file' => 'modules/mylog.module/mylog.php'
'settings' => array(
),
),class_name- Имя класса (с указанием namespace).extension- PHP расширение необходимое для исползования.required_file- Файл, который необходим дляиспользования (например автозагрузка).settings- массив настроек.
Пример использования своего собственного логера (в качестве примера взят monolog-adapter):
return array(
'exception_handling' => array(
'value' => array(
'log' => array(
'class_name' => '\Bex\Monolog\ExceptionHandlerLog',
'settings' => array(
'logger' => 'app'
),
),
),
'readonly' => false
),
'monolog' => array(
'value' => array(
'handlers' => array(
'default' => array(
'class' => '\Monolog\Handler\StreamHandler',
'level' => 'DEBUG',
'stream' => '/path/to/logs/app.log'
),
'feedback_event_log' => array(
'class' => '\Bex\Monolog\Handler\BitrixHandler',
'level' => 'DEBUG',
'event' => 'TYPE_FOR_EVENT_LOG',
'module' => 'vendor.module'
),
),
'loggers' => array(
'app' => array(
'handlers'=> array('default'),
),
'feedback' => array(
'handlers'=> array('feedback_event_log'),
)
)
),
'readonly' => false
)
);- Подробнее об адаптере для одной из самых мощных и популярных библиотек для логирования (для 1С-Битрикс)
- Подробнее библиотеке Monolog
/*Отвечает за соединения с базами данных*/
'connections' =>
array (
'value' =>
array (
'default' =>
array (
'className' => '\\Bitrix\\Main\\DB\\MysqlConnection',
'host' => '',
'database' => '',
'login' => '',
'password' => '',
'options' => 2,
'handlersocket' => array (
'read' => 'fast'
),
),
),
'fast' => array (
'className' => '\Bitrix\Name\Data\HsphpReadConnection',
'host' => 'localhost:31006',
),
'readonly' => true,
),readonlyключ означает, что нельзя изменить значение через API.className- имя класса, которое отвечает за работу с базой данных.host- хост, для соединения с базой данныхdatabase- имя базы данныхpassword- пароль к базе данныхhandlersocket- указывается какое соединение использовать. Необходимо создать подключение, где будут указаны класс и хостoptions- параметры соединения, например 1 - постоянное соединение, 2 - простое соединение, 3 - это оба:
'options' => ((!defined("DBPersistent") || DBPersistent) ? 1 : 0) | ((defined("DELAY_DB_CONNECT") && DELAY_DB_CONNECT === true) ? 2 : 0)Обычное соединение устанавливается каждый раз во время выполнения страницы при первом обращении к базе данных. Установленное соединение освобождается (в большинстве случаев и закрывается) после завершения страницы.
Постоянное соединение (функции PHP обычно называются *_pconnect) устанавливается один раз при первом обращении к базе данных и при повторных обращениях, даже из других страниц, используются уже открытые соединения к базе данных.
default - база данных используемая по умолчанию, можно задать несколько соединений с базами данных, затем использовать в проекте разные соединения.
Рекомендуется вместо \\Bitrix\\Main\\DB\\MysqlConnection использовать \\Bitrix\\Main\\DB\\MysqliConnection
Обращение к другим соединениям с базами данных:
/* connection_name - имя соединения, указанное в .settings.php.
/* Bitrix использует соединение по умолчанию default
*/
$connection = Bitrix\Main\Application::getConnection('connection_name');Подробнее о базах данных в 1С - Битрикс
/*Отключение сброса кэша, для решения некоторых проблем с php Zend Optimizer+*/
'no_accelerator_reset' =>
array (
'value' => false,
'readonly' => false,
),Применение данной настрйоки я не нашёл за исключением решения проблем с php Zend Optimizer+
/*Установка константы BX_HTTP_STATUS используется в Configuration::wnc*/
'http_status' =>
array (
'value' => true,
'readonly' => false,
),
Применение данной настройки находится в методе, который формирует файл .settings.php (Configuration::wnc), так же в фигуриует в методе CHTTP:SetStatus()