The package provides Yii Hydrator attributes to get data from PSR-7 HTTP request and adds extra abilities to middlewares processed by Yii Middleware Dispatcher:
- maps data from PSR-7 HTTP request to PHP DTO representing user input;
- uses Yii Hydrator parameter attributes for resolving middleware parameters.
- PHP 8.1 or higher.
The package could be installed with composer:
composer require yiisoft/input-httpYii Input HTTP allows to have DTO with attributes like this:
use Yiisoft\Input\Http\AbstractInput;
use Yiisoft\Input\Http\Attribute\Data\FromBody;
#[FromBody]
final class UpdatePostInput extends AbstractInput
{
public int $id;
public string $title;
public string $description = '';
public string $content;
}and automatically resolve and hydrate it, for example, for arguments like that:
final class UpdatePostController
{
public function update(UpdatePostInput $post): ResponseInterface
{
// ...
/** @var ResponseInterface $response */
return $response;
}
}Basic steps:
- Configure storing request.
- Configure parameters resolver.
- Create DTO (request input).
- Mark DTO properties with hydrator attributes provided by this package.
- Add DTO class name as type hint to a class method argument where you want to it to be resolved.
For other available options, see the guide.
The Yii Input HTTP is free software. It is released under the terms of the BSD License.
Please see LICENSE for more information.
Maintained by Yii Software.
