Divarion-D
f4555e7943
Structure:
- Split development/ (20 files) into development/ (framework reference) and guides/ (how-to)
- Moved 13 how-to files into new guides/ category (auth, cli, error-handling, etc.)
- Moved navbar-rendering.md from system/ into development/
- Deleted empty system/README.md files
- Deleted documentation_gaps.md (all gaps resolved) and redundant info/update.md
Sidebar / navbar:
- Removed all emojis from _sidebar.md (EN + RU) — fixes tree hierarchy rendering
- Removed flag emojis from _navbar.md language switcher
- Removed duplicate entries from the old "System Documentation" section
- Renamed section headers: "Development" -> "Framework Reference" + "Developer Guides"
Content fixes (modules.md EN + RU):
- Updated "Class naming" section: now documents XcVm\Module\{Pascal} namespaces
(was "global PHP namespace — Until PHP namespaces are introduced")
- Updated main module class example to use namespace declaration + use statements
- Updated class naming in ModuleLoader description to FQN
- Replaced installCrontab() manual crontab instruction with getCronEntries() API
- Updated enable/disable section: added ModuleState enum table, updated config examples
- Fixed FAQ answer for disabling a module
Content fixes (bootstrap-contexts.md EN + RU):
- Replaced CONTEXT_* string constants with BootContext enum cases throughout
- Updated boot() signature: string $context -> BootContext $context
- Updated getContext() return type: ?string -> ?BootContext
New framework reference docs (EN + RU):
- docs/{en,ru}/development/event-system.md: EventDispatcher singleton bridge,
#[ListensTo] attribute, getEventSubscribers() array API, stoppable events,
built-in event catalog, custom event authoring, ListensTo attribute reference
- docs/{en,ru}/development/exception-hierarchy.md: full XcVmException tree,
container vs module subtrees, PSR-11 compliance notes, catch-by-subsystem examples
3.6 KiB
Флаги разработки
XC_VM использует константы и флаги из настроек для управления поведением системы.
Константы приложения хранятся в src/core/Config/AppConfig.php.
Активные runtime-флаги
PHP_ERRORS
define('PHP_ERRORS', $rShowErrors); // из $rSettings['debug_show_errors']
PHP_ERRORS используется для управления отображением ошибок PHP и уровнем debug-вывода в логгере:
Logger::init(PHP_ERRORS, LOGS_TMP_PATH . 'error_log.log');
При PHP_ERRORS=true логгер выводит расширенные сообщения на экран.
DB_ACCESS_ENABLED
define('DB_ACCESS_ENABLED', false); // включает вкладку/страницу phpMiniAdmin в админ-панели
DB_ACCESS_ENABLED управляет только доступом к phpMiniAdmin из admin UI.
Этот флаг не блокирует основные подключения приложения к базе данных.
Флаги из настроек ($rSettings)
Ряд поведенческих флагов хранится в настройках панели и загружается в $rSettings:
| Ключ | Тип | Описание |
|---|---|---|
debug_show_errors |
bool |
Показывать детальные ошибки вместо 404 (только dev) |
recaptcha_enable |
bool |
Включить reCAPTCHA v2 на форме входа |
verify_host |
bool |
Проверять домен из allowed_domains при каждом запросе |
save_login_logs |
bool |
Записывать все попытки входа в login_logs |
Эти настройки загружаются из файлового кеша (CACHE_TMP_PATH/settings) через RequestGuard.
Статические константы приложения
define('DB_ACCESS_ENABLED', false);
define('XC_VM_VERSION', '2.1.2');
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('MONITOR_CALLS', 3);
define('OPENSSL_EXTRA', '...');
Добавление нового флага
Для добавления флага уровня приложения — добавьте define() в AppConfig.php:
define('MY_FEATURE_FLAG', false);
Для флагов, которыми должен управлять администратор через UI — добавьте ключ в таблицу settings и используйте $rSettings['my_feature_flag'].
Не дублируйте одну и ту же настройку в обоих местах. Статические константы — для инфраструктурных значений.
$rSettings— для пользовательских настроек.
Связанные файлы
| Файл | Назначение |
|---|---|
src/core/Config/AppConfig.php |
Статические флаги и константы |
src/core/Http/RequestGuard.php |
Загружает $rSettings из кеша |
src/core/Error/ErrorHandler.php |
Использует debug_show_errors |
src/core/Logging/Logger.php |
Использует PHP_ERRORS |