hydrakit/kernel

Default composition root and HTTP plumbing for the Hydra PHP framework

v0.1.2 2026-07-07 19:02 UTC

Requires

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

Requires (Dev)

• phpunit/phpunit: ^11.0

MIT

• William Hleucka

Published on Packagist.org on 2026-07-07 19: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, $basePath) — builds the shared composition root: binds the container and Environment, 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);
    $routeCache = RouteConfig::fromEnvironment(new Environment($basePath))->cache;

    return Kernel::application($container, $basePath)
        ->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.