hydrakit/kernel

Default composition root and HTTP plumbing for the Hydra PHP framework

v0.2.0 2026-07-09 20:02 UTC

Requires

• php: >=8.2
• hydrakit/auth: ^0.2
• hydrakit/authorization: ^0.2
• hydrakit/core: ^0.2
• hydrakit/event: ^0.2
• hydrakit/http: ^0.2
• hydrakit/session: ^0.2
• hydrakit/view: ^0.2
• psr/http-message: ^2.0
• psr/http-server-handler: ^1.0
• psr/http-server-middleware: ^1.0

Requires (Dev)

• nyholm/psr7: ^1.8
• phpunit/phpunit: ^11.0

MIT

• William Hleucka

Published on Packagist.org on 2026-07-09 20:02 UTC

README

The framework's default composition root and HTTP plumbing. It exists to keep the wiring that is identical across every Hydra app in one place, so a consumer's AppServiceProvider holds only policy — not the boilerplate that used to be copied into each app and drift.

What it ships

• Kernel::application($container, $environment) — builds the shared composition root: binds the container and the app-constructed Environment (constructed once in the bootstrap, so .env is parsed exactly once per request), then registers the standard provider stack in the correct order (Session → Event → Auth → Authorization). Returns the Application so the app chains its own providers. Adding a framework package to the stack is now a one-line edit here that every consumer picks up on composer update.
• HttpServiceProvider — binds the invariant HTTP plumbing: the PSR-17 factories, the request provider, the emitter, the responder, the route cache, the router, the middleware pipeline, and the HTTP kernel. It takes the app's policy — the controller list, the middleware stack, the route-cache toggle and path — as plain constructor data, so it never needs to know an app's config types.

Using it

A consumer's bootstrap collapses to composing these with its own provider:

public static function application(string $basePath): Application
{
    $container = new Container(new \DI\Container);
    $environment = new Environment($basePath); // .env parsed once, shared by all
    $routeCache = RouteConfig::fromEnvironment($environment)->cache;

    return Kernel::application($container, $environment)
        ->register(new HttpServiceProvider(
            controllers: AppServiceProvider::CONTROLLERS,
            middleware:  AppServiceProvider::MIDDLEWARE,
            routeCacheEnabled: $routeCache,
            routeCachePath: $basePath . '/bootstrap/cache/routes.php',
        ))
        ->register(new AppServiceProvider);
}

The app's AppServiceProvider then binds only what is genuinely its own: config value objects, the data layer, the user provider, the view, the logger, the two config-needing middleware (ForceHttps, ErrorHandler), and its event listeners.

The DI engine stays the app's choice

Kernel::application() takes an already-built ContainerInterface rather than constructing one, so the app keeps ownership of its php-di (or other) container. The kernel wires providers into it; it does not pick it.