mirror of https://github.com/Vateron-Media/XC_VM.git synced 2026-10-18 20:03:17 +02:00

Files

T

Divarion_D d4da90f37b fix(docs): translate bold spans atomically and auto-prune orphaned ru pages

The line-by-line web translator reordered words inside `**bold**` spans and
misplaced/dropped the markers, producing `**LB` or `****` (empty bold). Mask
each `**...**` as ONE atomic sentinel: translate the inner text on its own,
then store the whole balanced `**inner**` — the engine never sees the markers
and cannot reorder or collapse them. Also harden the anthropic prompt to keep
emphasis balanced.

Auto-prune: after translating, delete generated docs/ru files whose docs/en
source no longer exists (renamed/removed) and drop now-empty dirs, so the tree
mirrors docs/en 1:1 (removes the stale development/modules.md and
guides/geoip-and-device-detection.md).

Bump PROMPT_VERSION to 6 to invalidate the contaminated cache and regenerate
docs/ru (0 broken bold spans remaining, aside from pre-existing multi-line
bold that spans a soft line break).

2026-08-27 18:07:43 +03:00

5.8 KiB

Raw Blame History

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

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`	поведение при отладке/детализации

5.8 KiB Raw Blame History