mirror of
https://github.com/Vateron-Media/XC_VM.git
synced 2026-10-05 20:02:41 +02:00
Divarion_D
d4da90f37b
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).
135 lines
6.5 KiB
Markdown
135 lines
6.5 KiB
Markdown
# Иерархия исключений
|
|
|
|
XC_VM исключения фреймворка расширяют `XcVmException` — пустую базу **маркер**
|
|
(`class XcVmException extends \RuntimeException {}`, это не добавляет никаких дополнительных данных) — таким образом, вызывающие абоненты могут
|
|
охватите все семейство одним `catch (XcVmException)` или нацелитесь на определенную подсистему.
|
|
|
|
> **Масштаб.** Эта типизированная иерархия охватывает только **Контейнер DI** и **модульная система**.
|
|
> Это не вся панель целиком: конечные точки потоковой передачи/аутентификации сообщают о сбоях через
|
|
> `generateError()` (без исключений), и большая часть кода домена/CLI выдает простой
|
|
> исключения `\RuntimeException` или SPL — они по-прежнему совпадают с `catch (XcVmException)` только тогда, когда
|
|
> класс фактически расширяет его.
|
|
|
|
---
|
|
|
|
## Дерево
|
|
|
|
```
|
|
\Exception
|
|
└── \RuntimeException
|
|
└── XcVmException
|
|
├── Container
|
|
│ └── ContainerException (PSR-11 ContainerExceptionInterface)
|
|
│ ├── CircularDependencyException
|
|
│ ├── ServiceCreationException
|
|
│ └── NotFoundException (PSR-11 NotFoundExceptionInterface) *
|
|
└── Module
|
|
└── ModuleException
|
|
├── ModuleNotFoundException
|
|
├── ModuleLoadException
|
|
├── ModuleManifestException
|
|
└── ModuleCycleException
|
|
```
|
|
|
|
> \* `NotFoundException` расширяет `ContainerException` (таким образом, он принадлежит этому дереву), но он
|
|
> физически находится в `src/Core/Container/Psr/NotFoundException.php` под пространством имен
|
|
> `XcVm\Core\Container\Psr` — **нет** в `Core/Exception/Container/`.
|
|
|
|
---
|
|
|
|
## Исключения для контейнеров
|
|
|
|
|Класс|Когда его бросают|
|
|
| ----- | ----------- |
|
|
| `ContainerException` |База данных обо всех неисправностях контейнеров|
|
|
| `CircularDependencyException` |Заводской график службы содержит цикл|
|
|
| `ServiceCreationException` |Заводской вызов был произведен при создании сервиса|
|
|
| `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` |Граф зависимостей имеет топологическую сортировку, генерируемую циклом `ModuleLoader`, с циклическим путем (`a -> b -> a`) в сообщении. (В некоторых `@throws` блоках документации указано `\RuntimeException`; это просто базовый тип — `ModuleCycleException` расширяет его с помощью `XcVmException`.)|
|
|
|
|
---
|
|
|
|
## Перехват по подсистемам
|
|
|
|
```php
|
|
// Catch any XC_VM exception
|
|
try {
|
|
$loader->loadAll();
|
|
} catch (XcVmException $e) {
|
|
logger()->error($e->getMessage());
|
|
}
|
|
|
|
// Catch only module-related failures
|
|
try {
|
|
$loader->loadAll();
|
|
} catch (ModuleException $e) {
|
|
// ModuleNotFoundException | ModuleLoadException | ...
|
|
}
|
|
|
|
// Catch container-specific failures
|
|
try {
|
|
$container->get('missing');
|
|
} catch (ContainerException $e) {
|
|
// CircularDependencyException | NotFoundException | ...
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## Добавление или выбор исключения
|
|
|
|
- **Который нужно выбросить:** используйте наиболее конкретный существующий тип (например, `ModuleManifestException`
|
|
для неудачного `module.json`). Если ничего не подходит и это сбой на уровне фреймворка, выбросьте
|
|
`XcVmException` (или новый подкласс), чтобы его можно было отслеживать как одно семейство. Домен/бизнес
|
|
ошибки, не связанные с работой фреймворка, могут привести к появлению простого сообщения `\RuntimeException` /
|
|
`\InvalidArgumentException`.
|
|
- **Добавление категории:** создайте класс в соответствии с `src/Core/Exception/<Subsystem>/`, расширьте
|
|
база подсистемы (`ContainerException` / `ModuleException`) — или `XcVmException` для нового
|
|
подсистема — и добавьте ее в дерево выше. Регистрация не требуется, все просто PHP.
|
|
|
|
---
|
|
|
|
## Местоположение
|
|
|
|
```
|
|
src/Core/Exception/
|
|
├── XcVmException.php
|
|
├── Container/
|
|
│ ├── ContainerException.php
|
|
│ ├── CircularDependencyException.php
|
|
│ └── ServiceCreationException.php
|
|
└── Module/
|
|
├── ModuleException.php
|
|
├── ModuleNotFoundException.php
|
|
├── ModuleLoadException.php
|
|
├── ModuleManifestException.php
|
|
└── ModuleCycleException.php
|
|
```
|
|
|
|
## Связанные файлы
|
|
|
|
|Файл|Роль|
|
|
| --- | --- |
|
|
| `src/Core/Exception/` |Базовые классы исключений и иерархия проекта|
|