docs/guide-ja/structure-controllers.md - revised [ci skip]

cc395c91 · Nobuo Kihara · 66960342 · cc395c91
Commit cc395c91 authored Nov 28, 2014 by Nobuo Kihara
Hide whitespace changes
Inline Side-by-side

Showing with 92 additions and 113 deletions

structure-controllers.md docs/guide-ja/structure-controllers.md +92 -113

No files found.
--- a/docs/guide-ja/structure-controllers.md
+++ b/docs/guide-ja/structure-controllers.md
@@ -3,9 +3,8 @@
 コントローラは [MVC](http://ja.wikipedia.org/wiki/Model_View_Controller) アーキテクチャの一部を成すものです。
 これは [[yii\base\Controller]] を拡張したクラスのオブジェクトであり、リクエストの処理とレスポンスの生成について責任を負うものです。
-具体的には、[アプリケーション](structure-applications.md) から制御を引き継いだ後、コントローラは入ってきたリクエストのデータを分析し、
+具体的には、[アプリケーション](structure-applications.md) から制御を引き継いだ後、コントローラは入ってきたリクエストのデータを分析し、それを [モデル](structure-models.md) 
-それを [モデル](structure-models.md) に引き渡して、モデルが生成した結果を [ビュー](structure-views.md) に投入し、
+に引き渡して、モデルが生成した結果を [ビュー](structure-views.md) に投入し、最終的に外に出て行くレスポンスを生成します。
-最終的に外に出て行くレスポンスを生成します。
 ## アクション<a name="actions"></a>
@@ -14,7 +13,7 @@
 アクションは、エンドユーザがアドレスを指定して実行をリクエストできる最も基本的な構成単位です。
 コントローラは一つまたは複数のアクションを持ち得ます。
-次の例は、`view` と `create` という二つのアクションを持つ `post` コントローラを示すものです:
+次の例は、`view` と `create` という二つのアクションを持つ `post` コントローラを示すものです。
 ```php
 namespace app\controllers;
@@ -53,8 +52,7 @@ class PostController extends Controller
 }
 ```
-`view` アクション (`actionView()` メソッドで定義されます) において、
+`view` アクション (`actionView()` メソッドで定義されます) において、コードは最初に、リクエストされたモデルの ID に従って [モデル](structure-models.md) を読み出します。
-コードは最初に、リクエストされたモデルの ID に従って [モデル](structure-models.md) を読み出します。
 モデルの読み出しが成功したときは、`view` という名前の [ビュー](structure-views.md) を使ってモデルを表示します。
 失敗したときは例外を投げます。
@@ -69,32 +67,32 @@ class PostController extends Controller
 エンドユーザは、いわゆる *ルート* によって、アクションのアドレスを指定します。
 ルートは、次の部分からなる文字列です。
-* モジュール ID: この部分は、コントローラがアプリケーションではなく [モジュール](structure-modules.md) に属する場合にのみ存在します;
+* モジュール ID: この部分は、コントローラがアプリケーションではなく [モジュール](structure-modules.md) に属する場合にのみ存在します。
 * コントローラ ID: 同じアプリケーション (または、コントローラがモジュールに属する場合は、同じモジュール)
-  に属する全てのコントローラの中から、特定のコントローラを指定するユニークな文字列;
+  に属する全てのコントローラの中から、特定のコントローラを指定するユニークな文字列。
 * アクション ID: 同じコントローラに属する全てのアクションの中から、特定のアクションを指定するユニークな文字列。
-ルートは次の形式を取ります:
+ルートは次の形式を取ります。
 ```
 ControllerID/ActionID
 ```
-または、コントローラがモジュールに属する場合は、次の形式を取ります:
+または、コントローラがモジュールに属する場合は、次の形式を取ります。
 ```php
 ModuleID/ControllerID/ActionID
 ```
 ですから、ユーザが `http://hostname/index.php?r=site/index` という URL でリクエストをした場合は、`site` コントローラの中の `index` アクションが実行されます。
-どのようにしてルートがアクションとして解決されるかについて、更なる詳細は [ルーティングと URL 生成](runtime-routing.md) の節を参照してください。
+ルートがどのようにしてアクションとして解決されるかについての詳細は、[ルーティングと URL 生成](runtime-routing.md) の節を参照してください。
 ## コントローラを作成する<a name="creating-controllers"></a>
-[[yii\web\Application|ウェブアプリケーション]] では、コントローラは [[yii\web\Controller]] またはその子クラスから派生させるべきです。
+[[yii\web\Application|ウェブアプリケーション]] では、コントローラは [[yii\web\Controller]] またはその子クラスから派生させるべきものです。
-同様に、[[yii\console\Application|コンソールアプリケーション]] では、コントローラは [[yii\console\Controller]] またはその子クラスから派生させるべきです。
+同様に、[[yii\console\Application|コンソールアプリケーション]] では、コントローラは [[yii\console\Controller]] またはその子クラスから派生させるべきものです。
-次のコードは `site` コントローラを定義するものです:
+次のコードは `site` コントローラを定義するものです。
 ```php
 namespace app\controllers;
@@ -113,43 +111,41 @@ class SiteController extends Controller
 この理由により、たいていはコントローラが処理するリソースの型を示す名詞をコントローラの ID として使います。
 例えば、記事データを処理するコントローラの ID としては、`article` を使うことが出来ます。
-既定では、コントローラの ID は、以下の文字のみを含むべきものです: すなわち、小文字の英字、数字、アンダースコア、ダッシュ、
+既定では、コントローラの ID は、小文字の英字、数字、アンダースコア、ダッシュ、および、フォワードスラッシュのみを含むべきものです。
-および、フォワードスラッシュ。
 例えば、`article` と `post-comment` はともに有効なコントローラの ID ですが、`article?`、`PostComment`、`admin\post` は有効ではありません。
-コントローラの ID は、サブディレクトリの接頭辞を含んでも構いません。例えば、`admin/article` は、
+コントローラの ID は、サブディレクトリの接頭辞を含んでも構いません。例えば、`admin/article` は、[[yii\base\Application::controllerNamespace|コントローラ名前空間]]
-[[yii\base\Application::controllerNamespace|コントローラ名前空間]] の下の `admin` サブディレクトリにある `article` コントローラを表します。
+の下の `admin` サブディレクトリにある `article` コントローラを表します。
-サブディレクトリの接頭辞として有効な文字は以下を含みます: 小文字または大文字の英字、数字、アンダースコア、そして、
+サブディレクトリの接頭辞として有効な文字は、小文字または大文字の英字、数字、アンダースコア、そして、
-フォワードスラッシュ。フォワードスラッシュは、複数レベルのサブディレクトリの区切り文字として使われます (例えば、`panels/admin`)。
+フォワードスラッシュです。
+フォワードスラッシュは、複数レベルのサブディレクトリの区切り文字として使われます (例えば、`panels/admin`)。
 ### コントローラクラスの命名規則<a name="controller-class-naming"></a>
-コントローラクラスの名前は下記の規則に従ってコントローラの ID から導出することが出来ます:
+コントローラクラスの名前は下記の規則に従ってコントローラの ID から導出することが出来ます。
-* ダッシュで区切られた各単語の最初の文字を大文字に変える。コントローラ ID がスラッシュを含む場合、
+* ダッシュで区切られた各単語の最初の文字を大文字に変える。
-  この規則は ID の最後のスラッシュの後ろの部分にのみ適用されることに注意。
+  コントローラ ID がスラッシュを含む場合、この規則は ID の最後のスラッシュの後ろの部分にのみ適用されることに注意。
 * ダッシュを削除し、フォワードスラッシュを全てバックワードスラッシュに置き換える。
 * 接尾辞 `Controller` を追加する。
 * そして、[[yii\base\Application::controllerNamespace|コントローラ名前空間]] を頭に付ける。
-以下は、[[yii\base\Application::controllerNamespace|コントローラ名前空間]] がデフォルト値 `app\controllers` を取っていると
+以下は、[[yii\base\Application::controllerNamespace|コントローラ名前空間]] がデフォルト値 `app\controllers` を取っていると仮定したときの、いくつかの例です。
-仮定したときの、いくつかの例です:
-* `article` から `app\controllers\ArticleController` が導出される;
+* `article` から `app\controllers\ArticleController` が導出される。
-* `post-comment` から `app\controllers\PostCommentController` が導出される;
+* `post-comment` から `app\controllers\PostCommentController` が導出される。
-* `admin/post-comment` から `app\controllers\admin\PostCommentController` が導出される;
+* `admin/post-comment` から `app\controllers\admin\PostCommentController` が導出される。
 * `adminPanels/post-comment` から `app\controllers\adminPanels\PostCommentController` が導出される。
-コントローラクラスは [オートロード可能](concept-autoloading.md) でなければなりません。この理由により、
+コントローラクラスは [オートロード可能](concept-autoloading.md) でなければなりません。
-上記の例の `aritcle` コントローラクラスは [エイリアス](concept-aliases.md) が `@app/controllers/ArticleController.php` である
+この理由により、上記の例の `aritcle` コントローラクラスは [エイリアス](concept-aliases.md) が `@app/controllers/ArticleController.php`
-ファイルに保存されるべきものとなります。一方、`admin/post2-comment` コントローラは `@app/controllers/admin/Post2CommentController.php`
+であるファイルに保存されるべきものとなります。一方、`admin/post2-comment` コントローラは `@app/controllers/admin/Post2CommentController.php`
 というエイリアスのファイルに保存されるべきものとなります。
-> Info|情報: 最後の例である `admin/post2-comment` は、どうすれば [[yii\base\Application::controllerNamespace|コントローラ名前空間]] の
+> Info|情報: 最後の例である `admin/post2-comment` は、どうすれば [[yii\base\Application::controllerNamespace|コントローラ名前空間]]
-  サブディレクトリにコントローラを置くことが出来るかを示しています。
+  のサブディレクトリにコントローラを置くことが出来るかを示しています。
-  この方法は、コントローラをいくつかのカテゴリに分けて組織したい、けれども [モジュール](structure-modules.md) は使いたくない、
+  この方法は、コントローラをいくつかのカテゴリに分けて整理したい、けれども [モジュール](structure-modules.md) は使いたくない、という場合に役立ちます。
-  という場合に役立ちます。
 ### コントローラマップ<a name="controller-map"></a>
@@ -157,7 +153,7 @@ class SiteController extends Controller
 [[yii\base\Application::controllerMap|コントローラマップ]] を構成すると、上で述べたコントローラの ID とクラス名の制約を乗り越えることが出来ます。
 これは、主として、クラス名に対する制御が及ばないサードパーティのコントローラを使おうとする場合に有用です。
-[[yii\base\Application::controllerMap|コントローラマップ]] は [アプリケーションのコンフィギュレーション](structure-applications.md#application-configurations) の中で、次のように構成することが出来ます:
+[[yii\base\Application::controllerMap|コントローラマップ]] は [アプリケーションの構成情報](structure-applications.md#application-configurations) の中で、次のように構成することが出来ます。
 ```php
 [
@@ -165,7 +161,7 @@ class SiteController extends Controller
        // クラス名を使って "account" コントローラを宣言する
        'account' => 'app\controllers\UserController',
-        // コンフィギュレーション配列を使って "article" コントローラを宣言する
+        // 構成情報配列を使って "article" コントローラを宣言する
        'article' => [
            'class' => 'app\controllers\PostController',
            'enableCsrfValidation' => false,
@@ -182,7 +178,7 @@ class SiteController extends Controller
 [[yii\web\Application|ウェブアプリケーション]] では、この値は `'site'` であり、一方、[[yii\console\Application|コンソールアプリケーション]] では、`help` です。
 従って、URL が `http://hostname/index.php` である場合は、`site` コントローラがリクエストを処理することになります。
-次のように [アプリケーションのコンフィギュレーション](structure-applications.md#application-configurations) を構成して、デフォルトコントローラを変更することが出来ます:
+次のように [アプリケーションの構成情報](structure-applications.md#application-configurations) を構成して、デフォルトコントローラを変更することが出来ます。
 ```php
 [
@@ -196,7 +192,7 @@ class SiteController extends Controller
 アクションの作成は、コントローラクラスの中にいわゆる *アクションメソッド* を定義するだけの簡単なことです。
 アクションメソッドとは、`action` という語で始まる名前を持つ *public* メソッドのことです。
 アクションメソッドの返り値がエンドユーザに送信されるレスポンスデータを表します。
-次のコードは、`index` と `hello-world` という二つのアクションを定義するものです:
+次のコードは、`index` と `hello-world` という二つのアクションを定義するものです。
 ```php
 namespace app\controllers;
@@ -220,52 +216,51 @@ class SiteController extends Controller
 ### アクション ID<a name="action-ids"></a>
-アクションは、たいてい、あるリソースについて特定の操作を実行するように設計されます。この理由により、
+アクションは、たいてい、あるリソースについて特定の操作を実行するように設計されます。
-アクション ID は、通常、`view`、`update` などのような動詞になります。
+この理由により、アクション ID は、通常、`view`、`update` などのような動詞になります。
-既定では、アクション ID は次の文字のみを含むべきものです: すなわち、小文字の英字、数字、アンダースコア、そして、ダッシュ。
+既定では、アクション ID は、小文字の英字、数字、アンダースコア、そして、ダッシュのみを含むべきものです。
-アクション ID の中のダッシュは単語を分けるために使われます。例えば、
+アクション ID の中のダッシュは単語を分けるために使われます。
-`view`、`update2`、`comment-post` は全て有効なアクション ID ですが、`view?`、`Update` は有効ではありません。
+例えば、`view`、`update2`、`comment-post` は全て有効なアクション ID ですが、`view?`、`Update` は有効ではありません。
-アクションは二つの方法で作成することが出来ます: すなわち、インラインアクションとスタンドアロンアクションです。
+アクションは二つの方法で作成することが出来ます。すなわち、インラインアクションとスタンドアロンアクションです。
 インラインアクションはコントローラクラスのメソッドとして定義されるものであり、一方、スタンドアロンアクションは
 [[yii\base\Action]] またはその子クラスから派生させたクラスです。
 インラインアクションは作成するのにより少ない労力を要し、アクションを再利用する意図がない場合によく推奨されます。
-もう一方で、スタンドアロンアクションは、主として、さまざまなコントローラの中で使われることや、
+もう一方で、スタンドアロンアクションは、主として、さまざまなコントローラの中で使われることや、[エクステンション](structure-extensions.md)
-[エクステンション](structure-extensions.md) として再配布されることを意図して作成されます。
+として再配布されることを意図して作成されます。
 ### インラインアクション<a name="inline-actions"></a>
 インラインアクションは、たった今説明したように、アクションメソッドとして定義されるアクションを指します。
-アクションメソッドの名前は、次の基準に従って、アクション ID から導出されます:
+アクションメソッドの名前は、次の基準に従って、アクション ID から導出されます。
-* アクション ID に含まれる各単語の最初の文字を大文字に変換する;
+* アクション ID に含まれる各単語の最初の文字を大文字に変換する。
-* ダッシュを削除する;
+* ダッシュを削除する。
-* 前置辞 `action` を前に付ける。
+* 接頭辞 `action` を前に付ける。
 例えば、`index` は `actionIndex` となり、`hello-world` は `actionHelloWorld` となります。
-> Note|注意: アクションメソッドの名前は、*大文字と小文字を区別* します。`ActionIndex` という名前のメソッドがあっても、
+> Note|注意: アクションメソッドの名前は、*大文字と小文字を区別* します。`ActionIndex`
-  それはアクションメソッドとは見なされず、結果として、`index` アクションに対するリクエストは例外に帰結します。
+  という名前のメソッドがあっても、  それはアクションメソッドとは見なされず、結果として、`index`
-  アクションメソッドが public でなければならない事にも注意してください。private や protected なメソッドが
+  アクションに対するリクエストは例外に帰結します。
-  インラインアクションを定義することはありません。
+  アクションメソッドが public でなければならない事にも注意してください。
+  private や protected なメソッドがインラインアクションを定義することはありません。
-アクションは、作成するのにほとんど労力を要さないため、たいていの場合、インラインアクションとして定義されます。
+インラインアクションは作成するのにほとんど労力を要さないため、たいていのアクションはインラインアクションとして定義されます。
-しかしながら、同じアクションを別の場所で再利用する計画があったり、また、アクションを再配布したいと思ったりする場合は、
+しかし、同じアクションを別の場所で再利用する計画を持っていたり、また、アクションを再配布したいと思っていたりする場合は、アクションを *スタンドアロンアクション* として定義することを考慮すべきです。
-*スタンドアロンアクション* として定義することを考慮すべきです。
 ### スタンドアロンアクション<a name="standalone-actions"></a>
 スタンドアロンアクションは、[[yii\base\Action]] またはその子クラスを拡張したクラスとして定義されるものです。
-例えば、Yii のリリースに [[yii\web\ViewAction]] と [[yii\web\ErrorAction]] が含まれていますが、これらは両方とも
+例えば、Yii のリリースに [[yii\web\ViewAction]] と [[yii\web\ErrorAction]] が含まれていますが、これらは両方ともスタンドアロンアクションです。
-スタンドアロンアクションです。
-スタンドアロンアクションを使用するためには、下記のように、コントローラの [[yii\base\Controller::actions()]] メソッドを
+スタンドアロンアクションを使用するためには、下記のように、コントローラの [[yii\base\Controller::actions()]]
-オーバーライドして、スタンドアロンアクションを *アクションマップ* の中で宣言します:
+メソッドをオーバーライドして、スタンドアロンアクションを *アクションマップ* の中で宣言します。
 ```php
 public function actions()
@@ -274,7 +269,7 @@ public function actions()
        // クラス名を使って "error" アクションを宣言する
        'error' => 'yii\web\ErrorAction',
-        // コンフィギュレーション配列を使って "view" アクションを宣言する
+        // 構成情報配列を使って "view" アクションを宣言する
        'view' => [
            'class' => 'yii\web\ViewAction',
            'viewPrefix' => '',
@@ -283,10 +278,8 @@ public function actions()
 }
 ```
-見ると分かるように、`actions()` メソッドは、キーがアクション ID であり、値が対応するアクションのクラス名または
+見ると分かるように、`actions()` メソッドは、キーがアクション ID であり、値が対応するアクションのクラス名または [構成情報](concept-configurations.md) である配列を返すべきものです。
-[コンフィギュレーション](concept-configurations.md) である配列を返すべきものです。
+インラインアクションと違って、スタンドアロンアクションのアクション ID は、`actions()` メソッドにおいて宣言される限りにおいて、任意の文字を含むことが出来ます。
-インラインアクションと違って、スタンドアロンアクションのアクション ID は、`actions()` メソッドにおいて宣言される
-限りにおいて、任意の文字を含むことが出来ます。
 スタンドアロンアクションクラスを作成するためには、[[yii\base\Action]] またはその子クラスを拡張して、
@@ -316,14 +309,12 @@ class HelloWorldAction extends Action
 返り値は、エンドユーザにレスポンスとして送信される [レスポンス](runtime-responses.md) オブジェクトとすることが出来ます。
-* [[yii\web\Application|ウェブアプリケーション]] では、返り値を、[[yii\web\Response::data]] に割り当てられ、
+* [[yii\web\Application|ウェブアプリケーション]] では、[[yii\web\Response::data]] に割り当てられて後にレスポンスの本文を表す文字列へと変換される、任意のデータとすることも出来ます。
-  さらにレスポンスの本文を表す文字列へと変換される任意のデータとすることも出来ます。
+* [[yii\console\Application|コンソールアプリケーション]] では、返り値をコマンド実行の [[yii\console\Response::exitStatus|終了ステータス]] を示す整数とすることも出来ます。
-* [[yii\console\Application|コンソールアプリケーション]] では、返り値をコマンド実行の [[yii\console\Response::exitStatus|終了ステータス]]
-  を示す整数とすることも出来ます。
 これまでに示した例においては、アクションの結果はすべて文字列であり、エンドユーザに送信されるレスポンスの本文として扱われるものでした。
 次の例では、アクションがレスポンスオブジェクトを返すことによって、ユーザのブラウザを新しい URL にリダイレクトすることが出来る様子が示されています
-([[yii\web\Controller::redirect()|redirect()]] メソッドの返り値はレスポンスオブジェクトです):
+([[yii\web\Controller::redirect()|redirect()]] メソッドの返り値はレスポンスオブジェクトです)。
 ```php
 public function actionForward()
@@ -336,13 +327,12 @@ public function actionForward()
 ### アクションパラメータ<a name="action-parameters"></a>
-インラインアクションのアクションメソッドと、スタンドアロンアクションの `run()` メソッドは、
+インラインアクションのアクションメソッドと、スタンドアロンアクションの `run()` メソッドは、*アクションパラメータ* と呼ばれる引数を取ることが出来ます。
-*アクションパラメータ* と呼ばれる引数を取ることが出来ます。
 パラメータの値はリクエストから取得されます。
 [[yii\web\Application|ウェブアプリケーション]] では、各アクションパラメータの値は `$_GET` からパラメータ名をキーとして読み出されます。
 [[yii\console\Application|コンソールアプリケーション]] では、アクションパラメータはコマンドライン引数に対応します。
-次の例では、`view` アクション (インラインアクションです) は、二つのパラメータを宣言しています: すなわち、`$id` と `$version` です。
+次の例では、`view` アクション (インラインアクションです) は、二つのパラメータ、すなわち、`$id` と `$version` を宣言しています。
 ```php
 namespace app\controllers;
@@ -358,18 +348,15 @@ class PostController extends Controller
 }
 ```
-アクションパラメータは、次のように、さまざまなリクエストに応じて値を投入されます:
+アクションパラメータは、次のように、さまざまなリクエストに応じて値を投入されます。
-* `http://hostname/index.php?r=post/view&id=123`: `$id` パラメータには `'123'` という値が入れられますが、
+* `http://hostname/index.php?r=post/view&id=123`: `$id` パラメータには `'123'` という値が入れられますが、`version`
-  `version` というクエリパラメータが無いので、`$version` は null のままになります。
+  というクエリパラメータは無いので、`$version` は null のままになります。
-* `http://hostname/index.php?r=post/view&id=123&version=2`: `$id` および `$version` パラメータに、それぞれ、
+* `http://hostname/index.php?r=post/view&id=123&version=2`: `$id` および `$version` パラメータに、それぞれ、`'123'` と `'2'` が入ります。
-  `'123'` と `'2'` が入ります。
+* `http://hostname/index.php?r=post/view`: 必須の `$id` パラメータがリクエストで提供されていないため、 [[yii\web\BadRequestHttpException]] 例外が投げられます。
-* `http://hostname/index.php?r=post/view`: 必須の `$id` パラメータがリクエストで提供されていないため、
+* `http://hostname/index.php?r=post/view&id[]=123`: `$id` パラメータが予期しない配列値 `['123']` を受け取ろうとするため、[[yii\web\BadRequestHttpException]] 例外が投げられます。
-  [[yii\web\BadRequestHttpException]] 例外が投げられます。
-* `http://hostname/index.php?r=post/view&id[]=123`: `$id` パラメータが予期しない配列値 `['123']` を受け取ろうとするため、
-  [[yii\web\BadRequestHttpException]] 例外が投げられます。
-アクションパラメータに配列値を受け取らせたい場合は、以下のように、パラメータに `array` の型ヒントを付けなければなりません:
+アクションパラメータに配列値を受け取らせたい場合は、以下のように、パラメータに `array` の型ヒントを付けなければなりません。
 ```php
 public function actionView(array $id, $version = null)
@@ -378,13 +365,11 @@ public function actionView(array $id, $version = null)
 }
 ```
-このようにすると、リクエストが `http://hostname/index.php?r=post/view&id[]=123` である場合、`$id` パラメータは
+このようにすると、リクエストが `http://hostname/index.php?r=post/view&id[]=123` である場合、`$id` パラメータは `['123']` という値を受け取るようになります。
-`['123']` という値を受け取るようになります。
+リクエストが `http://hostname/index.php?r=post/view&id=123` である場合も、スカラ値 `'123'` が自動的に配列に変換されるため、`$id` パラメータは引き続き同じ配列値を受け取ります。
-リクエストが `http://hostname/index.php?r=post/view&id=123` である場合も、スカラ値 `'123'` が自動的に配列に変換されるため、
-`$id` パラメータは引き続き同じ配列値を受け取ります。
 上記の例は主としてウェブアプリケーションでのアクションパラメータの動作を示すものです。
-コンソールアプリケーションについては、[コンソールコマンド](tutorial-console.md) の節で更なる詳細を参照してください。
+コンソールアプリケーションについては、[コンソールコマンド](tutorial-console.md) の節で詳細を参照してください。
 ### デフォルトアクション<a name="default-action"></a>
@@ -393,7 +378,7 @@ public function actionView(array $id, $version = null)
 [ルート](#ids-routes) がコントローラ ID のみを含む場合は、指定されたコントローラのデフォルトアクションがリクエストされたことを意味します。
 既定では、デフォルトアクションは `index` と設定されます。
-このデフォルト値を変更したい場合は、以下のように、コントローラクラスでこのプロパティをオーバーライドするだけです:
+このデフォルト値を変更したい場合は、以下のように、コントローラクラスでこのプロパティをオーバーライドするだけです。
 ```php
 namespace app\controllers;
@@ -414,40 +399,34 @@ class SiteController extends Controller
 ## コントローラのライフサイクル<a name="controller-lifecycle"></a>
-リクエストを処理するときに、[アプリケーション](structure-applications.md) はリクエストされた [ルート](#routes)に基いてコントローラを作成します。
+リクエストを処理するときに、[アプリケーション](structure-applications.md) はリクエストされた [ルート](#routes) に基いてコントローラを作成します。
-そして、次に、コントローラはリクエストに応じるために以下のライフサイクルを経過します:
+そして、次に、コントローラはリクエストに応じるために以下のライフサイクルを経過します。
 1. コントローラが作成され構成された後、[[yii\base\Controller::init()]] メソッドが呼ばれる。
-2. コントローラは、リクエストされたアクション ID に基いて、アクションオブジェクトを作成する:
+2. コントローラは、リクエストされたアクション ID に基いて、アクションオブジェクトを作成する。
   * アクション ID が指定されていないときは、[[yii\base\Controller::defaultAction|デフォルトアクション ID]] が使われる。
-   * アクション ID が [[yii\base\Controller::actions()|アクションマップ]] の中に見つかった場合は、
+   * アクション ID が [[yii\base\Controller::actions()|アクションマップ]] の中に見つかった場合は、スタンドアロンアクションが作成される。
-     スタンドアロンアクションが作成される。
   * アクション ID に合致するアクションメソッドが見つかった場合は、インラインアクションが作成される。
   * アクションが見つからないと、[[yii\base\InvalidRouteException]] 例外が投げられる。
-3. コントローラは、アプリケーション、(コントローラがモジュールに属する場合は) モジュール、そしてコントローラの
+3. コントローラは、アプリケーション、(コントローラがモジュールに属する場合は) モジュール、そしてコントローラの `beforeAction()` メソッドをこの順で呼び出す。
-   `beforeAction()` メソッドをこの順で呼び出す:
+   * どれか一つの呼び出しが false を返した場合は、残りのまだ呼ばれていない `beforeAction()` はスキップされ、アクションの実行はキャンセルされる。
-   * どれか一つの呼び出しが false を返した場合は、残りのまだ呼ばれていない `beforeAction()` はスキップされ、
+   * 既定では、それぞれの `beforeAction()` メソッドは、ハンドラをアタッチすることが可能な `beforeAction` イベントをトリガする。
-     アクションの実行はキャンセルされる。
+4. コントローラがアクションを走らせる。
-   * 既定では、それぞれの `beforeAction()` メソッドは、ハンドラを取り付けることが出来る `beforeAction` イベントをトリガする。
-4. コントローラがアクションを走らせる:
   * リクエストデータが解析されて、アクションパラメータにデータが投入される。
-5. コントローラは、コントローラ、(コントローラがモジュールに属する場合は) モジュール、そしてアプリケーションの
+5. コントローラは、コントローラ、(コントローラがモジュールに属する場合は) モジュール、そしてアプリケーションの `afterAction()` メソッドをこの順で呼び出す。
-   `afterAction()` メソッドをこの順で呼び出す。
+   * 既定では、それぞれの `afterAction()` メソッドは、ハンドラをアタッチすることが可能な `afterAction` イベントをトリガする。
-   * 既定では、それぞれの `afterAction()` メソッドは、ハンドラを取り付けることが出来る `afterAction` イベントをトリガする。
 6. アプリケーションはアクションの結果を受け取り、それを [レスポンス](runtime-responses.md) に割り当てる。
 ## 最善の慣行<a name="best-practices"></a>
-良く設計されたアプリケーションでは、コントローラはたいてい非常に軽いものになり、
+良く設計されたアプリケーションでは、コントローラはたいてい非常に軽いものになり、それぞれのアクションは数行のコードしか含まないものになります。
-それぞれのアクションは数行のコードしか含まないものになります。
+あなたのコントローラが少々複雑になっている場合、そのことは、通常、コントローラをリファクタして、コードの一部を他のクラスに移動すべきことを示すものです。
-あなたのコントローラが少々複雑になっている場合、そのことは、通常、コントローラをリファクタして、
-コードの一部を他のクラスに移動すべきことを示すものです。
 要約すると、コントローラは、
-* [リクエスト](runtime-requests.md) データにアクセスすることが出来ます;
+* [リクエスト](runtime-requests.md) データにアクセスすることが出来ます。
-* リクエストデータを使って [モデル](structure-models.md) や他のサービスコンポーネントのメソッドを呼ぶことが出来ます;
+* リクエストデータを使って [モデル](structure-models.md) や他のサービスコンポーネントのメソッドを呼ぶことが出来ます。
-* [ビュー](structure-views.md) を使ってレスポンスを構成することが出来ます;
+* [ビュー](structure-views.md) を使ってレスポンスを構成することが出来ます。
-* リクエストされたデータの処理をするべきではありません - データは [モデル](structure-models.md) において処理されるべきです;
+* リクエストされたデータの処理をするべきではありません - データは [モデル](structure-models.md) において処理されるべきです。
 * HTML を埋め込むなどの表示に関わるコードは避けるべきです - 表示は [ビュー](structure-views.md) で行う方が良いです。