Автоматическая загрузка (PSR-4)¶

XC_VM автоматически загружает классы с помощью стандартного автозагрузчика Composer PSR-4; пространство имен кодирует путь к файлу, поэтому разрешение выполняется напрямую file_exists без сканирования и кэширования.

Обзор¶

Каждый сторонний класс находится в корневом пространстве имен XcVm\, сопоставленном с src/:

XcVm\Core\Auth\Authenticator   ->  src/Core/Auth/Authenticator.php
XcVm\Domain\Stream\StreamService ->  src/Domain/Stream/StreamService.php
XcVm\Public\Controllers\Admin\UserController -> src/Public/Controllers/Admin/UserController.php

Отображение объявлено в src/composer.json:

"autoload": {
    "psr-4": {
        "XcVm\\": "./"
    }
}

src/vendor/ (автозагрузчик Composer + производственные зависимости) зафиксирован и отправлено — путь развертывания не содержит Composer и никогда не выполняется composer install. Там is нет кэша карт классов (no optimize-autoloader): пропуск класса - это простой путь поиск, а не повторное сканирование каталога.

Добавление нового класса¶

Создайте файл по пути, соответствующему его пространству имен, — вот и все; Composer разрешает его по требованию:

// src/Domain/Billing/InvoiceService.php
namespace XcVm\Domain\Billing;

class InvoiceService {
    public static function generate(int $userId): string { /* ... */ }
}

Ссылайтесь на него из другого кода в пространстве имен с помощью импорта use или по его полному номеру:

use XcVm\Domain\Billing\InvoiceService;

Не нужно очищать кэш, редактировать реестр. Совершенно новое подпространство имен (например, XcVm\Domain\Billing) срабатывает немедленно, поскольку он отображается прямо на каталог.

Правила присвоения имен¶

Правило	Пример
Имя файла должен соответствует имени класса	`InvoiceService.php` → `class InvoiceService`
Один класс на файл	PSR-4 разрешает один класс для каждого пути; разбивает файлы нескольких классов
Пространство имен должен соответствует пути к каталогу (с учетом регистра).	`src/Domain/Billing/` → `namespace XcVm\Domain\Billing;`
Классы и каталоги PascalCase	`StreamService`, `DatabaseHandler`, `Core/Auth/`
Соглашение о проекте: нет `declare(strict_types=1)`	—

Поскольку пространство имен содержит местоположение, дублируйте короткие имена в разных пространства имен больше не конфликтуют — XcVm\Public\Controllers\Admin\PlexController и XcVm\Module\Plex\PlexController различны.

Процедурные файлы и файлы третьих лиц¶

Некоторые файлы намеренно разделены пространством имен нет и загружаются явным образом. require, а не автозагрузчик:

процедурные точки входа, представления и загрузочный клей (например, Public/index.php, Public/Views/**, Infrastructure/Bootstrap/*.php);
глобальные константы и функции (Core/Config/*, обработчик ошибок);
класс ioncube XC_VM и комплект поставки Infrastructure/Tmdb/lib/*.

Сторонние библиотеки (например, gemorroj/m3u-parser, chrisyue/php-m3u8, mobiledetect/mobiledetectlib, geoip2/geoip2) являются обычными Composer require зависимости, объявленные в src/composer.json; они находятся в src/vendor/ и autoload through the Composer vendor autoloader — they are not listed in the psr-4 блок выше.

Модули¶

Классы модулей используют пространство имен XcVm\Module\<Name>\…, но зарегистрированы в нет в composer.json (каталоги модулей/торговых площадок — plex, watch-d2bho — не соответствуют ни одному правилу PSR-4). Они разрешаются с помощью ModuleLoader собственных PSR-4 распознаватель: он удаляет базовое пространство имен модуля и отображает оставшееся в дополнительный путь в каталоге модуля. Смотрите Создание модуля.

Инструменты для разработки¶

Зафиксированное значение vendor/ доступно только для производства. PHPStan и phpcs являются require-dev пакеты — установите их локально с помощью:

make dev-tools   # = cd src && composer install

Они никогда не фиксируются (CI-шлюз обеспечивает фиксацию поставщика только для продукта). Видеть Рабочий процесс разработки.

Связанные файлы¶

Файл	Роль
`src/composer.json`	PSR-4 префиксная карта + зависимости
`src/composer.lock`	зафиксированная блокировка для воспроизводимого `composer install`
`src/vendor/`	зафиксированный Composer автозагрузчик + производственные удаления
`src/bootstrap.php`	определяет `MAIN_HOME`, требует `vendor/autoload.php`
`src/Core/Module/ModuleLoader.php`	PSR-4 преобразователь для классов модулей