【PHP】PSR-15 HTTP Handlers（HTTPハンドラ）~HTTPサーバーリクエストハンドラ~

リクエストハンドラ

リクエストハンドラは、PSR-7で定義されているように、リクエストを処理してレスポンスを生成する個々のコンポーネントです。

リクエスト条件がレスポンスを生成できない場合、リクエストハンドラは例外をスローする可能性があります。 例外のタイプは定義されていません。

この標準を使用するリクエストハンドラは、次のインタフェースを実装する必要があります。

Psr\Http\Server\RequestHandlerInterface

ミドルウェア

ミドルウェアコンポーネントは、PSR-7で定義されているように、受信したリクエストの処理と結果のレスポンスの作成に、他のミドルウェアコンポーネントと一緒に参加することが多い個々のコンポーネントです。

ミドルウェアコンポーネントは、十分な条件が満たされていればリクエストハンドラに委譲せずにレスポンスを作成して返すことができます。

この標準を使用するミドルウェアは、次のインタフェースを実装する必要があります。

Psr\Http\Server\MiddlewareInterface

レスポンスの生成

レスポンスを生成するミドルウェアまたはリクエストハンドラは、特定のHTTPメッセージ実装への依存を防ぐために、PSR-7 ResponseInterfaceのプロトタイプを作成するか、ResponseInterfaceインスタンスを生成できるファクトリを作成することをお勧めします。

例外の処理

ミドルウェアを使用するアプリケーションには、例外をキャッチしてレスポンスに変換するコンポーネントが含まれていることが推奨されます。 このミドルウェアは、実行される最初のコンポーネントであり、レスポンスが常に生成されるようにすべての処理をラップする必要があります。

RequestHandlerInterface

RequestHandlerInterfaceは、サーバーリクエストを処理し、レスポンスを生成します。

HTTPリクエストハンドラは、HTTPレスポンスを生成するためにHTTPリクエストを処理します。

Psr\Http\Server\RequestHandlerInterface

<?php

namespace Psr\Http\Server;

use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;

interface RequestHandlerInterface
{
    public function handle(ServerRequestInterface $request): ResponseInterface;
}

RequestHandlerInterfaceは、リクエストハンドラによって実装される必要があります。

MiddlewareInterface

MiddlewareInterfaceは、サーバーのリクエストとレスポンス処理に参与するインターフェイスです。

HTTPミドルウェアコンポーネントは、HTTPメッセージの処理に参加します。レスポンスを生成する、またはリクエストを後続のミドルウェアに転送し、そのレスポンスに作用することによって、リクエストを処理することができます。

Psr\Http\Server\MiddlewareInterface

<?php

namespace Psr\Http\Server;

use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;

interface MiddlewareInterface
{
    public function process(
        ServerRequestInterface $request, 
        RequestHandlerInterface $handler
    ): ResponseInterface;
}

MiddlewareInterfaceは、互換性のあるミドルウェアコンポーネントによって実装する必要があります。

public function process(ServerRequestInterface $request, RequestHandlerInterface $handler): ResponseInterface;

レスポンスを生成するために受信したサーバーリクエストを処理します。

レスポンス自体を生成できない場合は、提供されたリクエストハンドラに委譲してそのリクエストを行うことができます。