mirror of
https://github.com/Vateron-Media/XC_VM.git
synced 2026-10-31 03:03:24 +01:00
Divarion-D
788ec37637
- Remove DEVELOPMENT constant from AppConfig.php; introduce DB_ACCESS_ENABLED (controls phpMiniAdmin access in admin panel only, not core DB connections) - Detach bootstrap.php from www/constants.php: load core/Config/* and core/Logging/Logger directly; define PHP_ERRORS fallback - Switch Logger::init() to PHP_ERRORS in bootstrap.php, stream/init.php, RequestGuard.php; remove leftover TODO comment - Logger: always set error_reporting(E_ALL); UI visibility controlled separately via display_errors; rename $development -> $showErrors - MigrationRunner: track applied/failed counts separately; failed migrations are not marked as applied - Replace DEVELOPMENT with DB_ACCESS_ENABLED in admin settings.php and database.php (phpMiniAdmin gate) - Replace DEVELOPMENT with PHP_ERRORS in CertbotCronJob - Docs (en/ru): add DB_ACCESS_ENABLED flag description; update feature-flags, updates_checklist, http-request-handling; remove DEVELOPMENT references - MIGRATION.md: mark L-1 as done, remove from backlog and wave A; unblock L-2; renumber steps
83 lines
2.1 KiB
Markdown
83 lines
2.1 KiB
Markdown
# Development Feature Flags
|
|
|
|
XC_VM uses constants and settings-driven flags to control environment behavior.
|
|
|
|
Application constants are stored in `src/core/Config/AppConfig.php`.
|
|
|
|
---
|
|
|
|
## Active Runtime Flag
|
|
|
|
### `PHP_ERRORS`
|
|
|
|
```php
|
|
define('PHP_ERRORS', $rShowErrors); // derived from $rSettings['debug_show_errors']
|
|
```
|
|
|
|
`PHP_ERRORS` controls PHP/debug verbosity and logger screen output:
|
|
|
|
```php
|
|
Logger::init(PHP_ERRORS, LOGS_TMP_PATH . 'error_log.log');
|
|
```
|
|
|
|
### `DB_ACCESS_ENABLED`
|
|
|
|
```php
|
|
define('DB_ACCESS_ENABLED', false); // enables phpMiniAdmin tab/page in admin panel
|
|
```
|
|
|
|
`DB_ACCESS_ENABLED` controls access to phpMiniAdmin from admin UI only.
|
|
It does not block core application database connections.
|
|
|
|
---
|
|
|
|
## Settings-driven Flags (`$rSettings`)
|
|
|
|
Loaded from settings cache and used in runtime decision points.
|
|
|
|
| Key | Type | Meaning |
|
|
| --- | --- | --- |
|
|
| `debug_show_errors` | `bool` | show detailed errors/debug output |
|
|
| `recaptcha_enable` | `bool` | enable reCAPTCHA v2 on login |
|
|
| `verify_host` | `bool` | enforce host allowlist validation |
|
|
| `save_login_logs` | `bool` | persist login attempts in `login_logs` |
|
|
|
|
These values are loaded from `CACHE_TMP_PATH/settings` by request guards.
|
|
|
|
---
|
|
|
|
## Static App Constants
|
|
|
|
From `src/core/Config/AppConfig.php`:
|
|
|
|
```php
|
|
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', '...');
|
|
```
|
|
|
|
---
|
|
|
|
## Adding New Flags
|
|
|
|
Use static constants in `AppConfig.php` for fixed infrastructure/runtime constants.
|
|
Use settings (`$rSettings`) for values that must be managed from panel UI.
|
|
|
|
Avoid defining the same behavior in both places.
|
|
|
|
---
|
|
|
|
## Related Files
|
|
|
|
| File | Purpose |
|
|
| --- | --- |
|
|
| `src/core/Config/AppConfig.php` | static app constants |
|
|
| `src/core/Http/RequestGuard.php` | loads `$rSettings`, sets `PHP_ERRORS` |
|
|
| `src/core/Error/ErrorHandler.php` | uses `debug_show_errors` behavior |
|
|
| `src/core/Logging/Logger.php` | debug/verbosity behavior |
|