Флаги функций разработки

XC_VM использует константы и флаги, управляемые настройками, для управления поведением среды.

Константы приложения определяются отображением appConfig() в src/Core/Config/ConstantsInitializer.php.

Активный флаг времени выполнения

`PHP_ERRORS`

define('PHP_ERRORS', $rShowErrors); // derived from $rSettings['debug_show_errors']

PHP_ERRORS управляет PHP/подробностью отладки и выводом на экран регистратора:

Logger::init(PHP_ERRORS, LOGS_TMP_PATH . 'error_log.log');

`DB_ACCESS_ENABLED`

define('DB_ACCESS_ENABLED', false); // enables phpMiniAdmin tab/page in admin panel

DB_ACCESS_ENABLED управляет доступом к phpMiniAdmin только из пользовательского интерфейса администратора. Это не блокирует подключения к базе данных основного приложения. Его спутник DB_ACCESS_PWD (также на карте appConfig()) устанавливает пароль, защищающий эту страницу — оставьте его пустым, чтобы сохранить отключите вкладку, устанавливайте строгое значение только тогда, когда оно вам нужно.

`DEV_MODE`

define('DEV_MODE', false); // master development-mode flag

DEV_MODE - это переключатель разработки во время компиляции (bootstrap.php считывает его в self::$devMode). Когда true включается PHP_ERRORS (подробные ошибки на экране), запускается диагностика повторной проверки, и обеспечивает другие удобства для разработчиков.

⚠️ Никогда не включайте DEV_MODE или debug_show_errors в рабочей среде — оба раскрывают внутренние ошибки/пути к посетителям. PHP_ERRORS заканчивается на true, если любой константа DEV_MODE равна установлено (путь начальной загрузки) или значение debug_show_errors включено (путь защиты запроса); это правило разрешения, когда они накладываются друг на друга.

Флаги, зависящие от настроек (`$rSettings`)

Загружается из кэша настроек и используется в точках принятия решений во время выполнения.

Ключ	Тип	Значение
`debug_show_errors`	`bool`	показывать подробные результаты ошибок/отладки
`recaptcha_enable`	`bool`	включите reCAPTCHA v2 при входе в систему
`verify_host`	`bool`	принудительная проверка списка разрешений хоста
`save_login_logs`	`bool`	постоянные попытки входа в систему в `login_logs`
`fanout_supervise`	`bool`	передача прямых трансляций супервизору xc_fanout вместо монитора PHP (по умолчанию включен)
`fanout_source_backend`	`auto` / `ffmpeg` / `native`	как преобразуются исходные тексты в MPEG-TS; под наблюдением, будут ли потоки, предназначенные только для копирования, запускать собственный ремиксер (`auto`: с резервным копированием ffmpeg)

Эти значения загружаются из CACHE_TMP_PATH/settings защитниками запросов.

Статические константы приложения

Из карты appConfig() в src/Core/Config/ConstantsInitializer.php (каждая запись является define()заменено на ConstantsInitializer::init()):

'DB_ACCESS_ENABLED' => false,
'DB_ACCESS_PWD'     => '',       // password for the phpMiniAdmin tab (empty = off)
'DEV_MODE'          => false,    // master development-mode switch
'XC_VM_VERSION'     => '2.4.1',  // bumped every release — treat as illustrative
'GIT_OWNER'         => 'Vateron-Media',
'GIT_REPO_MAIN'     => 'XC_VM',
'GIT_REPO_UPDATE'   => 'XC_VM_Update',
'GIT_REPO_BIN'      => 'XC_VM_Binaries',
'GIT_REPO_FANOUT'   => 'XC_VM_Fanout', // xc_fanout daemon source + binaries
'GIT_REPO_PROXY'    => 'XC_VM_Proxy',
'MONITOR_CALLS'     => 3,
'OPENSSL_EXTRA'     => '...',    // literal fallback; the real per-install secret is read
                                 // from the config/openssl_extra file by init()

Добавление новых флагов

Используйте статические константы в карте appConfig() (ConstantsInitializer.php) для фиксированных констант инфраструктуры/среды выполнения (отредактированных в код, вступающий в силу при следующем запросе). Используйте настройки ($rSettings) для значений, которые оператор переключает из панели администратора (страница Настройки) — они сохраняются в таблице settings базы данных и считывается с CACHE_TMP_PATH/settings.

Избегайте определения одного и того же поведения в обоих местах. Когда они неизбежно пересекаются (как в случае DEV_MODE против debug_show_errors → PHP_ERRORS), эффективным значением является операционная из двух — выигрывает любой из вариантов, включающий его.

Связанные файлы

Файл	Цель
`src/Core/Config/ConstantsInitializer.php`	статические константы приложения (`appConfig()` map)
`src/Core/Http/RequestGuard.php`	загружает `$rSettings`, устанавливает `PHP_ERRORS`
`src/Core/Error/ErrorHandler.php`	использует поведение `debug_show_errors`
`src/Core/Logging/Logger.php`	поведение при отладке/детализации

6.8 KiB Raw Blame History

Флаги функций разработки

Активный флаг времени выполнения

PHP_ERRORS

DB_ACCESS_ENABLED

DEV_MODE

Флаги, зависящие от настроек ($rSettings)