Ground Sunlight

Windowsで作る - PHPプログラミングの開発環境

ユーザ用ツール

サイト用ツール


psr:psr15

差分

このページの2つのバージョン間の差分を表示します。

この比較画面にリンクする

両方とも前のリビジョン 前のリビジョン
次のリビジョン
前のリビジョン
psr:psr15 [2020/07/28 15:08]
y2sunlight [1.1 リクエストハンドラー]
psr:psr15 [2020/09/01 11:54] (現在)
tanaka [PSR-15: HTTP Server Request Handlers]
行 1: 行 1:
-> 編集中 
- 
 ====== PSR-15: HTTP Server Request Handlers ====== ====== PSR-15: HTTP Server Request Handlers ======
  
行 24: 行 22:
   * [[psr:psr17|PSR-17: HTTP Factories - HTTPファクトリー]]    * [[psr:psr17|PSR-17: HTTP Factories - HTTPファクトリー]] 
   * [[psr:psr18|PSR-18: HTTP Client - HTTPクライアント]]    * [[psr:psr18|PSR-18: HTTP Client - HTTPクライアント]] 
-  * [[psr:psr19|PSR-19: PHPDoc tags - PHPDocタグ]] +  * [[psr:psr19|PSR-19: PHPDoc tags(Draft) - PHPDocタグ]] 
  
 ----- -----
行 72: 行 70:
 ==== 1.2 ミドルウェア ==== ==== 1.2 ミドルウェア ====
  
-A middleware component is an individual component participating, often together with other middleware components, in the processing of an incoming request and the creation of a resulting response, as defined by PSR-7. +ミドルウェアコンポーネントは個別のコンポーネントですが、PSR-7で定義されているように、着信要求の処理と結果応答の作成に他のミドルウェアコンポーネントと一緒に参加することが多いです。
- +
-ミドルウェアコンポーネントは個別のコンポーネントですが、PSR-7で定義されているように、着信要求の処理と結果応答の作成に他のミドルウェアコンポーネントと一緒に参加することが多いです。 +
- +
-A middleware component MAY create and return a response without delegating to a request handler, if sufficient conditions are met.+
  
 ミドルウェアコンポーネントは、十分な条件が満たされている場合、リクエストハンドラーに委任することなく応答を作成して返すことができます( ''MAY'' )。 ミドルウェアコンポーネントは、十分な条件が満たされている場合、リクエストハンドラーに委任することなく応答を作成して返すことができます( ''MAY'' )。
- 
-Middleware using this standard MUST implement the following interface: 
  
 この規約を使用するミドルウェアは、次のインターフェースを実装する必要があります( ''MUST'' ): この規約を使用するミドルウェアは、次のインターフェースを実装する必要があります( ''MUST'' ):
行 90: 行 82:
 ==== 1.3 レスポンスの生成 ==== ==== 1.3 レスポンスの生成 ====
  
-It is RECOMMENDED that any middleware or request handler that generates a response will either compose a prototype of a PSR-7 ResponseInterface or a factory capable of generating a ResponseInterface instance in order to prevent dependence on a specific HTTP message implementation. +応答を生成するミドルウェアまたはリクエストハンドラーは、PSR-7の ''ResponseInterface'' プロトタイプ または ''ResponseInterface'' インスタンスを生成できるファクトリーを構成することをお勧めします( ''RECOMMENDED'' )。それは、特定のHTTPメッセージの実装への依存を防ぐためです。
- +
-応答を生成するミドルウェアまたはリクエストハンドラーは、PSR-7の ''ResponseInterface'' プロトタイプまたは ''ResponseInterface'' インスタンスを生成できるファクトリーを構成することをお勧めします( ''RECOMMENDED'' )。それは、特定のHTTPメッセージの実装への依存を防ぐためです。+
  
 \\ \\
行 98: 行 88:
 ==== 1.4 例外のハンドリング ==== ==== 1.4 例外のハンドリング ====
  
-It is RECOMMENDED that any application using middleware includes a component that catches exceptions and converts them into responses. This middleware SHOULD be the first component executed and wrap all further processing to ensure that a response is always generated. +ミドルウェアを使用するアプリケーションは、例外をキャッチしてそれらをレスポンスに変換するコンポーネントを含むことが推奨されます( ''RECOMMENDED'' )。このミドルウェアは、最初に実行されるコンポーネントであり、ての他の処理をラップすべきです( ''SHOULD'' )。それは、レスポンスが常に生成されることを保証するためです。
- +
-ミドルウェアを使用するアプリケーションは、例外をキャッチしてそれらをレスポンスに変換するコンポーネントを含むことが推奨されます( ''RECOMMENDED'' )。このミドルウェアは、最初に実行されるコンポーネントであり、すべての他の処理をラップすべきです( ''SHOULD'' )。それは、レスポンスが常に生成されることを保証するためです。+
  
 \\ \\
行 107: 行 95:
  
 ==== 2.1 Psr\Http\Server\RequestHandlerInterface ==== ==== 2.1 Psr\Http\Server\RequestHandlerInterface ====
- 
-The following interface MUST be implemented by request handlers. 
  
 リクエストハンドラーは次のインターフェースを実装する必要があります( ''MUST'' )。 リクエストハンドラーは次のインターフェースを実装する必要があります( ''MUST'' )。
行 119: 行 105:
  
 /** /**
- * Handles a server request and produces a response. 
  * サーバーリクエストを処理し、レスポンスを生成します。  * サーバーリクエストを処理し、レスポンスを生成します。
  *  *
- * An HTTP request handler process an HTTP request in order to produce an 
- * HTTP response. 
  * HTTPリクエストハンドラーは、HTTPレスポンスを生成するためにHTTPリクエストを処理します。  * HTTPリクエストハンドラーは、HTTPレスポンスを生成するためにHTTPリクエストを処理します。
  */  */
行 129: 行 112:
 { {
     /**     /**
-     * Handles a request and produces a response. 
      * リクエストを処理し、レスポンスを生成します。      * リクエストを処理し、レスポンスを生成します。
      *      *
-     * May call other collaborating code to generate the response. 
      * レスポンスを生成するために、他の協調するコードを呼び出すことができます。      * レスポンスを生成するために、他の協調するコードを呼び出すことができます。
      */      */
行 142: 行 123:
  
 ==== 2.2 Psr\Http\Server\MiddlewareInterface ==== ==== 2.2 Psr\Http\Server\MiddlewareInterface ====
- 
-The following interface MUST be implemented by compatible middleware components. 
  
 互換性のあるミドルウェアコンポーネントは次のインターフェースを実装する必要があります( ''MUST'' )。 互換性のあるミドルウェアコンポーネントは次のインターフェースを実装する必要があります( ''MUST'' )。
行 154: 行 133:
  
 /** /**
- * Participant in processing a server request and response. 
  * サーバーのリクエストとレスポンスを処理する参加者。  * サーバーのリクエストとレスポンスを処理する参加者。
  *  *
- * An HTTP middleware component participates in processing an HTTP message: 
- * by acting on the request, generating the response, or forwarding the 
- * request to a subsequent middleware and possibly acting on its response. 
  * HTTPミドルウェアコンポーネントは、HTTPメッセージの処理に参加します:  * HTTPミドルウェアコンポーネントは、HTTPメッセージの処理に参加します:
  * つまり、リクエストに基づいて動作するか、レスポンスを生成するか、  * つまり、リクエストに基づいて動作するか、レスポンスを生成するか、
- * またはリクエストを後続のミドルウェアに転送し場合によってはそのレスポンスに基づいて動作します。+ * または リクエストを後続のミドルウェアに転送し場合によってはそのレスポンスに基づいて動作します。
  */  */
 interface MiddlewareInterface interface MiddlewareInterface
 { {
     /**     /**
-     * Process an incoming server request. 
      * 着信サーバー要求を処理します。      * 着信サーバー要求を処理します。
      *      *
-     * Processes an incoming server request in order to produce a response. 
-     * If unable to produce the response itself, it may delegate to the provided 
-     * request handler to do so. 
      * レスポンスを生成するために、着信サーバーリクエストを処理します。      * レスポンスを生成するために、着信サーバーリクエストを処理します。
      * レスポンス自体を生成できない場合は、それをするのに提供されたリクエストハンドラーに委任します。      * レスポンス自体を生成できない場合は、それをするのに提供されたリクエストハンドラーに委任します。
psr/psr15.1595916532.txt.gz · 最終更新: 2020/07/28 15:08 by y2sunlight