mirror of
https://github.com/Vateron-Media/XC_VM.git
synced 2026-10-02 04:02:09 +02:00
Divarion-D
76844fef11
Overhaul the Docsify documentation (English + Russian) so it matches the current codebase and follows one consistent pattern. Content accuracy (post-migration): - Rewrite development/autoloader.md to PSR-4 / Composer (the old XC_Autoloader scanner, igbinary tmp/cache/autoload_map and registerDirectories are gone). - PascalCase every source path (src/core -> src/Core, domain/Stream, cli/Commands, public/Controllers, Infrastructure/Redis, ...) across all docs. - Replace the removed autoload.php references with vendor/autoload.php (build_system, bootstrap-contexts, error-handling, modules). - ssl-generation: note that the installer now auto-generates a unique self-signed certificate before Nginx starts. Common pattern (Clean & uniform): - Strip emoji from headings; remove the in-page Navigation blocks (the Docsify sidebar already provides navigation). - One H1 + intro per doc; uniform "Related files" / "Связанные файлы" section, added to the code-centric docs that lacked it. Structure: - Remove the empty stray docs/api/; move updates_checklist.md into builds/; link the previously-orphaned ucs-integration.md. - Regroup the sidebars (split the oversized guides group into Developer Guides / Security & Access / Integrations; fold builds into Build & Release). Augment: - dev-workflow: Local Setup (make dev-tools) + Quality Checks (phpstan, cs, gates). - build_system: Composer Dependencies section (committed prod-only vendor, committed lock, dev tools via composer install, no build-time vendor step). en/ru parity: - Apply the same structure, fixes and pattern to docs/ru/ (translated), including a new Russian ucs-integration.md. The en and ru file sets are now identical.
111 lines
3.7 KiB
Markdown
111 lines
3.7 KiB
Markdown
# Иерархия исключений
|
|
|
|
Все исключения XC_VM расширяют `XcVmException`, что позволяет перехватывать
|
|
всё дерево одним `catch`-блоком или точечно таргетировать отдельную подсистему.
|
|
|
|
---
|
|
|
|
## Дерево
|
|
|
|
```
|
|
\Exception
|
|
└── XcVmException
|
|
├── Container
|
|
│ └── ContainerException (PSR-11 ContainerExceptionInterface)
|
|
│ ├── CircularDependencyException
|
|
│ ├── ServiceCreationException
|
|
│ └── NotFoundException (PSR-11 NotFoundExceptionInterface)
|
|
└── Module
|
|
└── ModuleException
|
|
├── ModuleNotFoundException
|
|
├── ModuleLoadException
|
|
├── ModuleManifestException
|
|
└── ModuleCycleException
|
|
```
|
|
|
|
---
|
|
|
|
## Исключения контейнера
|
|
|
|
| Класс | Когда бросается |
|
|
| ----- | --------------- |
|
|
| `ContainerException` | Базовый класс для всех сбоев контейнера |
|
|
| `CircularDependencyException` | В графе фабрик сервиса обнаружен цикл |
|
|
| `ServiceCreationException` | Фабричный callable выбросил исключение при создании сервиса |
|
|
| `NotFoundException` | `get($id)` вызван для незарегистрированного сервиса |
|
|
|
|
`NotFoundException` реализует оба PSR-11-интерфейса, обеспечивая совместимость:
|
|
|
|
```php
|
|
try {
|
|
$service = $container->get('unknown');
|
|
} catch (NotFoundException $e) {
|
|
// PSR-11 NotFoundExceptionInterface
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## Исключения модулей
|
|
|
|
| Класс | Когда бросается |
|
|
| ----- | --------------- |
|
|
| `ModuleException` | Базовый класс для всех сбоев модуля |
|
|
| `ModuleNotFoundException` | Обязательная зависимость-модуль отсутствует |
|
|
| `ModuleLoadException` | Файл модуля не может быть загружен или класс не найден |
|
|
| `ModuleManifestException` | `module.json` отсутствует, некорректен или не проходит валидацию |
|
|
| `ModuleCycleException` | Граф зависимостей содержит цикл |
|
|
|
|
---
|
|
|
|
## Перехват по подсистеме
|
|
|
|
```php
|
|
// Перехватить любое исключение XC_VM
|
|
try {
|
|
$loader->loadAll();
|
|
} catch (XcVmException $e) {
|
|
logger()->error($e->getMessage());
|
|
}
|
|
|
|
// Перехватить только ошибки модулей
|
|
try {
|
|
$loader->loadAll();
|
|
} catch (ModuleException $e) {
|
|
// ModuleNotFoundException | ModuleLoadException | ...
|
|
}
|
|
|
|
// Перехватить только ошибки контейнера
|
|
try {
|
|
$container->get('missing');
|
|
} catch (ContainerException $e) {
|
|
// CircularDependencyException | NotFoundException | ...
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## Расположение
|
|
|
|
```
|
|
src/Core/Exception/
|
|
├── XcVmException.php
|
|
├── Container/
|
|
│ ├── ContainerException.php
|
|
│ ├── CircularDependencyException.php
|
|
│ ├── ServiceCreationException.php
|
|
│ └── NotFoundException.php
|
|
└── Module/
|
|
├── ModuleException.php
|
|
├── ModuleNotFoundException.php
|
|
├── ModuleLoadException.php
|
|
├── ModuleManifestException.php
|
|
└── ModuleCycleException.php
|
|
```
|
|
|
|
## Связанные файлы
|
|
|
|
| Файл | Роль |
|
|
| --- | --- |
|
|
| `src/Core/Exception/` | Базовые классы исключений и иерархия проекта |
|