dosc/guide-ja updated [ci skip] (yiisoft#13471)

* doc/guide-ja updated [ci skip]

* docs/guide-ja updated [ci skip]

* docs/guide-ja/db-migrations.md updated [ci skip]

docs/guide-ja/concept-components.md

@@ -9,7 +9,7 @@
 * [ビヘイビア](concept-behaviors.md)
 
 個々にでも、組み合わせでも、これらの機能は Yii のクラスのカスタマイズ性と使いやすさをとても高めてくれます。たとえば、[[yii\jui\DatePicker|日付選択]] を行うユーザインターフェース·コンポーネントは、
-対話型の日付選択UIを生成するとき、[ビュー](structure-view.md) で次のように使用することができます:
+対話型の日付選択UIを生成するとき、[ビュー](structure-views.md) で次のように使用することができます:
 
 ```php
 use yii\jui\DatePicker;

docs/guide-ja/db-migrations.md

@@ -869,48 +869,48 @@ return [
 もう、`migrationTable` のコマンドラインオプションを使ってテーブルを指定する必要はなくなります。
 
 
-### Namespaced Migrations <span id="namespaced-migrations"></span>
+### 名前空間を持つマイグレーション <span id="namespaced-migrations"></span>
 
-Since 2.0.10 you can use namespaces for the migration classes. You can specify the list of the migration namespaces via
-[[yii\console\controllers\MigrateController::migrationNamespaces|migrationNamespaces]]. Using of the namespaces for
-migration classes allows you usage of the several source locations for the migrations. For example:
+2.0.10 以降では、マイグレーションのクラスに名前空間を適用することが出来ます。
+マイグレーションの名前空間のリストをを [[yii\console\controllers\MigrateController::migrationNamespaces|migrationNamespaces]] によって指定することが出来ます。
+マイグレーションのクラスに名前空間を使うと、マイグレーションのソースについて、複数の配置場所を使用することが出来ます。
+例えば、
 
 ```php
 return [
     'controllerMap' => [
         'migrate' => [
             'class' => 'yii\console\controllers\MigrateController',
             'migrationNamespaces' => [
-                'app\migrations', // Common migrations for the whole application
-                'module\migrations', // Migrations for the specific project's module
-                'some\extension\migrations', // Migrations for the specific extension
+                'app\migrations', // アプリケーション全体のための共通のマイグレーション
+                'module\migrations', // プロジェクトの特定のモジュールのためのマイグレーション
+                'some\extension\migrations', // 特定のエクステンションのためのマイグレーション
             ],
         ],
     ],
 ];
 ```
 
-> Note: migrations applied from different namespaces will create a **single** migration history, e.g. you might be
-  unable to apply or revert migrations from particular namespace only.
+> Note: 異なる名前空間に属するマイグレーションを適用しても、**単一の** マイグレーション履歴が生成されます。
+> つまり、特定の名前空間に属するマイグレーションだけを適用したり元に戻したりすることは出来ません。
 
-While operating namespaced migrations: creating new, reverting and so on, you should specify full namespace before
-migration name. Note that backslash (`\`) symbol is usually considered a special character in the shell, so you need
-to escape it properly to avoid shell errors or incorrect behavior. For example:
+名前空間を持つマイグレーションを操作するときは、新規作成時も、元に戻すときも、マイグレーション名の前にフルパスの名前空間を指定しなければなりません。
+バックスラッシュ (`\`) のシンボルは、通常、シェルでは特殊文字として扱われますので、シェルのエラーや誤った動作を防止するために、適切にエスケープしなければならないことに注意して下さい。
+例えば、
 
 ```
 yii migrate/create 'app\\migrations\\createUserTable'
 ```
 
-> Note: migrations specified via [[yii\console\controllers\MigrateController::migrationPath|migrationPath]] can not
-  contain a namespace, namespaced migration can be applied only via [[yii\console\controllers\MigrateController::migrationNamespaces]]
-  property.
+> Note: [[yii\console\controllers\MigrateController::migrationPath|migrationPath]] によって指定されたマイグレーションは、名前空間を持つことが出来ません。
+  名前空間を持つマイグレーションは [[yii\console\controllers\MigrateController::migrationNamespaces]] プロパティを通じてのみ適用可能です。
 
 
 ### 分離されたマイグレーション <span id="separated-migrations"></span>
 
-Sometimes using single migration history for all project migrations is not desirable. For example: you may install some
-'blog' extension, which contains fully separated functionality and contain its own migrations, which should not affect
-the ones dedicated to main project functionality.
+プロジェクトのマイグレーション全体に単一のマイグレーション履歴を使用することが望ましくない場合もあります。
+例えば、完全に独立した機能性とそれ自身のためのマイグレーションを持つような 'blog' エクステンションをインストールする場合には、
+メインのプロジェクトの機能専用のマイグレーションに影響を与えたくないでしょう。
 
 これらをお互いに完全に分離して適用かつ追跡したい場合は、別々の名前空間とマイグレーション履歴テーブルを使う
 複数のマイグレーションコマンドを構成することが出来ます。

docs/guide-ja/runtime-handling-errors.md

@@ -10,7 +10,7 @@ Yii が内蔵している [[yii\web\ErrorHandler|エラーハンドラ]] は、
 * さまざまなエラーレスポンス形式をサポートしています。
 
 [[yii\web\ErrorHandler|エラーハンドラ]] はデフォルトで有効になっています。
-アプリケーションの [エントリスクリプト](structure-entry-scripts.md) において、定数 `YII_ENABLE_ERROR_HANDLER` を false と定義することによって、これを無効にすることが出来ます。
+アプリケーションの [エントリスクリプト](structure-entry-scripts.md) において、定数 `YII_ENABLE_ERROR_HANDLER` を `false` と定義することによって、これを無効にすることが出来ます。
 
 
 ## エラーハンドラを使用する <span id="using-error-handler"></span>
@@ -59,16 +59,16 @@ throw new NotFoundHttpException();
 ## エラー表示をカスタマイズする <span id="customizing-error-display"></span>
 
 [[yii\web\ErrorHandler|エラーハンドラ]] は、定数 `YII_DEBUG` の値に従って、エラー表示を調整します。
-`YII_DEBUG` が true である (デバッグモードである) 場合は、エラーハンドラは、デバッグがより容易になるように、例外とともに、詳細なコールスタック情報とソースコード行を表示します。
-そして、`YII_DEBUG` が false のときは、アプリケーションに関する公開できない情報の開示を防ぐために、エラーメッセージだけが表示されます。
+`YII_DEBUG` が `true` である (デバッグモードである) 場合は、エラーハンドラは、デバッグがより容易になるように、例外とともに、詳細なコールスタック情報とソースコード行を表示します。
+そして、`YII_DEBUG` が `false` のときは、アプリケーションに関する公開できない情報の開示を防ぐために、エラーメッセージだけが表示されます。
 
 > Info: 例外が [[yii\base\UserException]] の子孫である場合は、`YII_DEBUG` の値の如何にかかわらず、コールスタックは表示されません。
 これは、この種の例外はユーザの誤操作によって引き起こされるものであり、開発者は何も修正する必要がないと考えられるからです。
 
 デフォルトでは、[[yii\web\ErrorHandler|エラーハンドラ]] は二つの [ビュー](structure-views.md) を使ってエラーを表示します。
 
 * `@yii/views/errorHandler/error.php`: エラーがコールスタック情報なしで表示されるべき場合に使用されます。
-  `YII_DEBUG` が false の場合、これが表示される唯一のビューとなります。
+  `YII_DEBUG` が `false` の場合、これが表示される唯一のビューとなります。
 * `@yii/views/errorHandler/exception.php`: エラーがコールスタック情報と共に表示されるべき場合に使用されます。
 
 エラー表示をカスタマイズするために、エラーハンドラの [[yii\web\ErrorHandler::errorView|errorView]] および [[yii\web\ErrorHandler::exceptionView|exceptionView]] プロパティを構成して、自分自身のビューを使用することが出来ます。

docs/guide-ja/runtime-responses.md

@@ -191,8 +191,9 @@ public function actionOld()
 そして、クライアントサイドで、このヘッダの値を読み、それに応じてブラウザをリダイレクトする JavaScript を書くことが出来ます。
 
 > Info: Yii には `yii.js` という JavaScript ファイルが付属しています。
-これは、よく使われる一連の JavaScript 機能を提供するもので、その中には `X-Redirect` ヘッダに基づくブラウザのリダイレクトも含まれています。
-従って、あなたが ([[yii\web\YiiAsset]] アセットバンドルを登録して) この JavaScript ファイルを使うつもりなら、AJAX のリダイレクトをサポートするためには、何も書く必要がなくなります。
+  これは、よく使われる一連の JavaScript 機能を提供するもので、その中には `X-Redirect` ヘッダに基づくブラウザのリダイレクトも含まれています。
+  従って、あなたが ([[yii\web\YiiAsset]] アセットバンドルを登録して) この JavaScript ファイルを使うつもりなら、AJAX のリダイレクトをサポートするためには、何も書く必要がなくなります。
+  `yii.js` に関する更なる情報は [クライアントスクリプトの節](output-client-scripts.md#yii.js) にあります。
 
 
 ## ファイルを送信する <span id="sending-files"></span>

docs/guide-ja/runtime-sessions-cookies.md

@@ -288,7 +288,7 @@ unset($cookies['language']);
 や [[yii\web\Cookie::expire|expire]] など、他のプロパティを定義して、利用可能なクッキー情報の全てを完全に表しています。
 クッキーを準備するときに必要に応じてこれらのプロパティを構成してから、レスポンスのクッキーコレクションに追加することが出来ます。
 
-> Note: セキュリティを向上させるために、[[yii\web\Cookie::httpOnly]] のデフォルト値は true に設定されています。
+> Note: セキュリティを向上させるために、[[yii\web\Cookie::httpOnly]] のデフォルト値は `true` に設定されています。
 これは、クライアントサイドスクリプトが保護されたクッキーにアクセスする危険を軽減するものです (ブラウザがサポートしていれば)。
 詳細については、[httpOnly wiki article](https://www.owasp.org/index.php/HttpOnly) を読んでください。
 
@@ -304,7 +304,7 @@ unset($cookies['language']);
   これは、サードパーティのライブラリが、クッキー検証を含まない独自の方法でクッキーを操作することが出来るようにするするためです。
 
 クッキー検証はデフォルトで有効になっています。
-[[yii\web\Request::enableCookieValidation]] プロパティを false に設定することによって無効にすることが出来ますが、無効にしないことを強く推奨します。
+[[yii\web\Request::enableCookieValidation]] プロパティを `false` に設定することによって無効にすることが出来ますが、無効にしないことを強く推奨します。
 
 > Note: `$_COOKIE` と `setcookie()` によって直接に 読み出し/送信 されるクッキーは検証されません。
 

docs/guide-ja/security-authorization.md

@@ -245,6 +245,10 @@ return [
 
 `yii migrate --migrationPath=@yii/rbac/migrations`
 
+異なる名前空間のマイグレーションを扱う方法の詳細については
+[分離されたマイグレーション](db-migrations.md#separated-migrations) の節を参照して下さい。
+
+
 これで `authManager` は `\Yii::$app->authManager` によってアクセスすることが出来るようになります。
 
 

docs/guide-ja/start-forms.md

@@ -57,7 +57,7 @@ class EntryForm extends Model
 * `email` のデータは構文的に有効なメールアドレスでなければならない
 
 ユーザによって入力されたデータを `EntryForm` オブジェクトに投入した後、[[yii\base\Model::validate()|validate()]] を呼んでデータ検証ルーチンを始動することが出来ます。
-データ検証が失敗すると [[yii\base\Model::hasErrors|hasErrors]] プロパティが true に設定されます。
+データ検証が失敗すると [[yii\base\Model::hasErrors|hasErrors]] プロパティが `true` に設定されます。
 そして、[[yii\base\Model::getErrors|errors]] を通じて、どのような検証エラーが発生したかを知ることが出来ます。
 
 

docs/guide-ja/start-gii.md

@@ -33,7 +33,7 @@ if (YII_ENV_DEV) {
 上記の構成情報は、[開発環境](concept-configurations.md#environment-constants) において、アプリケーションは `gii` という名前のモジュールをインクルードすべきこと、そして `gii` は [[yii\gii\Module]] というクラスであることを記述しています。
 
 アプリケーションの [エントリスクリプト](structure-entry-scripts.md) である `web/index.php` をチェックすると、次の行があることに気付くでしょう。
-これは本質的には `YII_ENV_DEV` を true に設定するものです。
+これは本質的には `YII_ENV_DEV` を `true` に設定するものです。
 
 ```php
 defined('YII_ENV') or define('YII_ENV', 'dev');

docs/guide-ja/start-installation.md

@@ -50,7 +50,7 @@ Composer は `composer self-update` コマンドを実行してアップデー
 > アクセス・トークンの構成の仕方については、[Github API トークンに関する Composer ドキュメント](https://getcomposer.org/doc/articles/troubleshooting.md#api-rate-limit-and-oauth-tokens)
 > の指示を参照して下さい。
 
-### Yii をインストールする
+### Yii をインストールする <span id="installing-from-composer"></span>
 
 Composer がインストールされたら、ウェブからアクセスできるフォルダで下記のコマンドを実行することによって Yii をインストールすることが出来ます。
 
@@ -150,7 +150,7 @@ http://localhost:8080/
   ```
 
 Yii の最低必要条件を満たすように PHP のインストールを構成しなければなりません。
-最も重要なことは、PHP 5.4 以上でなければならないということです。
+最も重要なことは、PHP 5.4 以上でなければならないということです。最新の PHP 7 なら理想的です。
 また、アプリケーションがデータベースを必要とする場合は、[PDO PHP 拡張](http://www.php.net/manual/ja/pdo.installation.php) および対応するデータベースドライバ (MySQL データベースのための `pdo_mysql` など) をインストールしなければなりません。
 
 

docs/guide-ja/structure-controllers.md

@@ -397,7 +397,7 @@ class SiteController extends Controller
    * アクション ID に合致するアクションメソッドが見つかった場合は、インラインアクションが作成される。
    * 上記以外の場合は、[[yii\base\InvalidRouteException]] 例外が投げられる。
 3. コントローラは、アプリケーション、(コントローラがモジュールに属する場合は) モジュール、そしてコントローラの `beforeAction()` メソッドをこの順で呼び出す。
-   * どれか一つの呼び出しが false を返した場合は、残りのまだ呼ばれていない `beforeAction()` メソッドはスキップされ、アクションの実行はキャンセルされる。
+   * どれか一つの呼び出しが `false` を返した場合は、残りのまだ呼ばれていない `beforeAction()` メソッドはスキップされ、アクションの実行はキャンセルされる。
    * デフォルトでは、それぞれの `beforeAction()` メソッドは、ハンドラをアタッチすることが可能な `beforeAction` イベントをトリガする。
 4. コントローラがアクションを実行する。
    * アクションパラメータが解析されて、リクエストデータからデータが投入される。

docs/guide-ja/structure-filters.md

@@ -60,7 +60,7 @@ public function behaviors()
 新しいアクションフィルタを作成するためには、[[yii\base\ActionFilter]] を拡張して、[[yii\base\ActionFilter::beforeAction()|beforeAction()]] および/または [[yii\base\ActionFilter::afterAction()|afterAction()]] メソッドをオーバーライドします。
 前者はアクションが走る前に実行され、後者は走った後に実行されます。
 [[yii\base\ActionFilter::beforeAction()|beforeAction()]] の返り値が、アクションが実行されるべきか否かを決定します。
-返り値が false である場合、このフィルタの後に続くフィルタはスキップされ、アクションは実行を中止されます。
+返り値が `false` である場合、このフィルタの後に続くフィルタはスキップされ、アクションは実行を中止されます。
 
 次の例は、アクションの実行時間をログに記録するフィルタを示すものです。
 

docs/guide-ja/structure-models.md

@@ -37,7 +37,7 @@ echo $model->name;
 ```
 
 また、配列の要素にアクセスするようして、属性にアクセスすることも出来ます。
-これは、[[yii\base\Model]] が [ArrayAccess インターフェイス](http://php.net/manual/ja/class.arrayaccess.php) と [ArrayIterator クラス](http://jp2.php.net/manual/ja/class.arrayiterator.php) をサポートしている恩恵です。
+これは、[[yii\base\Model]] が [ArrayAccess インターフェイス](http://php.net/manual/ja/class.arrayaccess.php) と [Traversable インターフェイス](http://jp2.php.net/manual/ja/class.traversable.php) をサポートしている恩恵です。
 
 ```php
 $model = new \app\models\ContactForm;
@@ -46,7 +46,7 @@ $model = new \app\models\ContactForm;
 $model['name'] = 'example';
 echo $model['name'];
 
-// 属性に反復アクセスする
+// モデルは foreach で中身をたどることが出来る
 foreach ($model as $name => $value) {
     echo "$name: $value\n";
 }

docs/guide-ja/structure-modules.md

@@ -177,7 +177,7 @@ $module = MyModuleClass::getInstance();
 
 ここで `MyModuleClass` は、当該モジュールクラスの名前を指すものです。
 `getInstance()` メソッドは、現在リクエストされているモジュールクラスのインスタンスを返します。
-モジュールがリクエストされていない場合は、このメソッドは null を返します。
+モジュールがリクエストされていない場合は、このメソッドは `null` を返します。
 モジュールクラスの新しいインスタンスを手動で作成しようとしてはいけないことに注意してください。
 手動で作成したインスタンスは、リクエストに対するレスポンスとして Yii によって作成されたインスタンスとは別のものになります。