merge from yiisoft/yii2

docs/guide-ja/rest-error-handling.md

@@ -1,11 +1,13 @@
 エラー処理
 ==========
 
-RESTful API リクエストを処理していて、ユーザのリクエストにエラーがあったり、何か予期しないことがサーバ上で起ったりしたときには、単に例外を投げて、ユーザに何かがうまく行かなかったことを知らせることも出来ます。
-しかし、エラーの原因 (例えば、リクエストされたリソースが存在しない、など) を特定することが出来るなら、適切な HTTP ステータス・コード (例えば、404 ステータス・コードを表わす [[yii\web\NotFoundHttpException]]) と一緒に例外を投げることを検討すべきです。
+RESTful API リクエストを処理していて、ユーザのリクエストにエラーがあったり、何か予期しないことがサーバ上で起ったりしたときには、
+単に例外を投げて、ユーザに何かがうまく行かなかったことを知らせることも出来ます。
+しかし、エラーの原因 (例えば、リクエストされたリソースが存在しない、など) を特定することが出来るなら、
+適切な HTTP ステータス・コード (例えば、404 ステータス・コードを表わす [[yii\web\NotFoundHttpException]])
+と一緒に例外を投げることを検討すべきです。
 そうすれば、Yii は対応する HTTP ステータスのコードとテキストをレスポンスとともに送信します。
-Yii はまた、レスポンス・ボディにも、シリアライズされた表現形式の例外を含めます。
-例えば、
+Yii はまた、レスポンス・ボディにも、シリアライズされた表現形式の例外を含めます。例えば、
 
 ```
 HTTP/1.1 404 Not Found
@@ -29,14 +31,14 @@ Content-Type: application/json; charset=UTF-8
   `Location` ヘッダが、新しく作成されたリソースを指し示す URL を含んでいます。
 * `204`: リクエストは成功裡に処理されましたが、レスポンスはボディ・コンテントを含んでいません (`DELTE` リクエストなどの場合)。
 * `304`: リソースは修正されていません。キャッシュしたバージョンを使うことが可能です。
-* `400`: 無効なリクエストです。これはユーザのさまざまな行為によって引き起こされます。例えば、リクエストのボディに無効な JSON データを入れたり、無効なアクションパラメータを指定したり、など。
+* `400`: 無効なリクエストです。これはユーザのさまざまな行為によって引き起こされます。
+  例えば、リクエストのボディに無効な JSON データを入れたり、無効なアクションパラメータを指定したり、など。
 * `401`: 認証が失敗しました。
 * `403`: 認証されたユーザは指定された API エンド・ボイントにアクセスすることを許可されていません。
 * `404`: リクエストされたリソースは存在しません。
 * `405`: メソッドが許可されていません。どの HTTP メソッドが許可されているか、`Allow` ヘッダをチェックしてください。
 * `415`: サポートされていないメディア・タイプです。リクエストされたコンテント・タイプまたはバージョン番号が無効です。
-* `422`: データの検証が失敗しました (例えば `POST` リクエストに対するレスポンスで)。
-  レスポンス・ボディで詳細なエラー・メッセージをチェックしてください。
+* `422`: データの検証が失敗しました (例えば `POST` リクエストに対するレスポンスで)。レスポンス・ボディで詳細なエラー・メッセージをチェックしてください。
 * `429`: リクエストの数が多すぎます。レート制限のためにリクエストが拒絶されました。
 * `500`: 内部的サーバエラー。これは内部的なプログラムエラーによって生じ得ます。
 
@@ -44,7 +46,8 @@ Content-Type: application/json; charset=UTF-8
 ## エラー・レスポンスをカスタマイズする <span id="customizing-error-response"></span>
 
 場合によっては、デフォルトのエラー・レスポンス形式をカスタマイズしたいことがあるでしょう。
-例えば、さまざまな HTTP ステータスを使ってさまざまなエラーを示すという方法によるのではなく、次に示すように、HTTP ステータスとしては常に 200 を使い、実際の HTTP ステータス・コードはレスポンスの JSON 構造の一部として包み込む、という方式です。
+例えば、さまざまな HTTP ステータスを使ってさまざまなエラーを示すという方法によるのではなく、次に示すように、
+HTTP ステータスとしては常に 200 を使い、実際の HTTP ステータス・コードはレスポンスの JSON 構造の一部として包み込む、という方式です。
 
 ```
 HTTP/1.1 200 OK
@@ -87,4 +90,5 @@ return [
 ];
 ```
 
-上記のコードは、`suppress_response_code` が `GET` のパラメータとして渡された場合に、レスポンスを (成功したものも、失敗したものも) 上記で説明したように再フォーマットします。
+上記のコードは、`suppress_response_code` が `GET` のパラメータとして渡された場合に、
+レスポンスを (成功したものも、失敗したものも) 上記で説明したように再フォーマットします。