hydrakit/nyholm

Nyholm PSR-7/PSR-17 adapter for the Hydra PHP framework

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

Requires

• php: >=8.2
• hydrakit/core: ^0.2
• hydrakit/http: ^0.2
• nyholm/psr7: ^1.8
• nyholm/psr7-server: ^1.0
• psr/http-message: ^2.0

Requires (Dev)

• phpunit/phpunit: ^11.0

MIT

• William Hleucka

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

README

The one place the framework names a concrete PSR-7/PSR-17 implementation.

hydrakit/http is deliberately free of any PSR-7 vendor — it depends only on the PSR interfaces and defines a ServerRequestProviderInterface seam for building the incoming request from the environment. This package is the default adapter that fills that seam with nyholm/psr7.

Usage

The app's composition root registers NyholmServiceProvider explicitly — this is the one line where an app names its PSR-7 vendor:

use Hydra\Nyholm\NyholmServiceProvider;

Kernel::application($container, $basePath)
    ->register(new NyholmServiceProvider)   // fills the PSR-7/17 seams
    ->register(new HttpServiceProvider(/* ... */))
    ->register(new AppServiceProvider);

The provider binds Psr17Factory (which implements every PSR-17 factory interface) as the ResponseFactoryInterface/StreamFactoryInterface the rest of the app resolves, and binds ServerRequestProviderInterface to the adapter:

use Hydra\Nyholm\NyholmRequestProvider;
use Nyholm\Psr7\Factory\Psr17Factory;

$factory  = new Psr17Factory;
$provider = NyholmRequestProvider::create($factory);

$request = $provider->fromGlobals(); // a PSR-7 ServerRequestInterface

Swapping it out

The kernel's HttpServiceProvider consumes only the PSR-17 factory interfaces and Hydra\Http\Contracts\ServerRequestProviderInterface — it binds no PSR-7 vendor. An app that prefers a different PSR-7 library simply doesn't require this package: it registers its own provider binding ResponseFactoryInterface, StreamFactoryInterface, and ServerRequestProviderInterface to its chosen implementation, in place of NyholmServiceProvider in the composition root. Nothing in the framework reaches for nyholm directly.