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

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

Константы приложения хранятся в виде src/Core/Config/AppConfig.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.php) устанавливает пароль, защищающий эту страницу — оставьте его пустым, чтобы сохранить отключите вкладку, устанавливайте строгое значение только тогда, когда оно вам нужно.

`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`

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

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

Из src/Core/Config/AppConfig.php:

define('DB_ACCESS_ENABLED', false);
define('DB_ACCESS_PWD', '');       // password for the phpMiniAdmin tab (empty = off)
define('DEV_MODE', false);         // master development-mode switch
define('XC_VM_VERSION', '2.4.1');  // bumped every release — treat as illustrative
define('GIT_OWNER', 'Vateron-Media');
define('GIT_REPO_MAIN', 'XC_VM');
define('GIT_REPO_UPDATE', 'XC_VM_Update');
define('GIT_REPO_BIN', 'XC_VM_Binaries');
define('GIT_REPO_FANOUT', 'XC_VM_Fanout'); // xc_fanout daemon source + binaries
define('GIT_REPO_PROXY', 'XC_VM_Proxy');
define('MONITOR_CALLS', 3);
define('OPENSSL_EXTRA', '...');

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

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

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

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

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

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

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

PHP_ERRORS¶

DB_ACCESS_ENABLED¶

DEV_MODE¶

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