pinecore/.claude/architecture/bootstrap.md

Ядро, Config, Environment, ContainerFactory

Kernel (src/Kernel.php)

Статический класс, хранит единственный инстанс контейнера.

Kernel::boot(string $basePath): Container  // ENV → Config → ContainerFactory
Kernel::container(): Container             // бросает RuntimeException если не вызван boot()

Environment (src/Environment.php)

Environment::detect(): self   // getenv('APP_ENV') ?: 'dev'
$env->name(): string
$env->is(string $name): bool
$env->isProd(): bool          // name === 'prod'

Config (src/Config.php)

Загрузка (Config::load($configDir, $env)):

1. Все $configDir/*.php — ключ = имя файла без расширения
2. Deep-merge $configDir/env/{envName}.php (если есть)
3. Deep-merge $configDir/env/local.php (если есть, всегда поверх)

Доступ:

$config->get('section.key', $default)   // dot-notation, deep lookup
$config->get('app.cors')                // возвращает array

Merge: рекурсивный для assoc-массивов, replace для списков (array_values === array).

ContainerFactory (src/ContainerFactory.php)

ContainerFactory::build(Environment $env, Config $config, string $basePath): Container

• Autowiring включён всегда
• В prod: $builder->enableCompilation($basePath . '/var/cache/prod/')
• Автоматически регистрирует Config::class, Environment::class и LoggerInterface::class в контейнере — любой класс может получить их через DI без ручного биндинга в services.php
• LoggerInterface по умолчанию резолвится в CompositeLogger([StdoutLogger]); если задан log.file — добавляется FileLogger
• Загружает $basePath/config/routes.php (если есть) — файл возвращает RouteDefinition[], фреймворк автоматически создаёт Router и регистрирует его в контейнере
• Загружает $basePath/config/services.php (если есть) — файл возвращает callable($builder, $config, $basePath); загружается после routes.php и может переопределить любые определения, включая Router::class

config/routes.php (конвенция, предпочтительный способ):

use Pronchev\Pinecore\Http\RouteDefinition;

return [
    new RouteDefinition('GET',  '/users/{id}', GetUserController::class, [AuthMiddleware::class]),
    new RouteDefinition('POST', '/users',      CreateUserController::class, [AuthMiddleware::class]),
];

config/services.php (для DI-биндингов и переопределений):

return function (ContainerBuilder $builder, Config $config, string $basePath): void {
    $builder->addDefinitions([
        UserProviderInterface::class => fn($c) => $c->get(UserRepository::class),
    ]);
};