docs/guide-ja updated [ci skip] (#18095)

docs/guide-ja/db-dao.md

@@ -107,6 +107,18 @@ ODBC 経由でデータベースに接続しようとする場合は、[[yii\db\
 > ]
 > ```
 
+MS SQL Server でバイナリ・データを正しく処理するためには追加の接続オプションが必要になります。
+
+```php
+'db' => [
+ 'class' => 'yii\db\Connection',
+    'dsn' => 'sqlsrv:Server=localhost;Database=mydatabase',
+    'attributes' => [
+        \PDO::SQLSRV_ATTR_ENCODING => \PDO::SQLSRV_ENCODING_SYSTEM
+    ]
+],
+```
+
 
 ## SQL クエリを実行する <span id="executing-sql-queries"></span>
 

docs/guide-ja/db-query-builder.md

@@ -602,6 +602,28 @@ $query1->union($query2);
 
 [[yii\db\Query::union()|union()]] を複数回呼んで、`UNION` 句をさらに追加することが出来ます。
 
+### [[yii\db\Query::withQuery()|withQuery()]] <span id="with-query"></span>
+
+[[yii\db\Query::withQuery()|withQuery()]] メソッドは SQL クエリの `WITH` プレフィックスを指定するものです。サブクエリの代りに `WITH` を使うと読みやすさを向上させ、ユニークな機能(再帰 CTE)を利用することが出来ます。詳細は [modern-sql](https://modern-sql.com/feature/with) を参照して下さい。例えば、次のクエリは `admin` の持つ権限をその子も含めて全て再帰的に取得します。
+
+```php
+$initialQuery = (new \yii\db\Query())
+    ->select(['parent', 'child'])
+    ->from(['aic' => 'auth_item_child'])
+    ->where(['parent' => 'admin']);
+
+$recursiveQuery = (new \yii\db\Query())
+    ->select(['aic.parent', 'aic.child'])
+    ->from(['aic' => 'auth_item_child'])
+    ->innerJoin('t1', 't1.child = aic.parent');
+
+$mainQuery = (new \yii\db\Query())
+    ->select(['parent', 'child'])
+    ->from('t1')
+    ->withQuery($initialQuery->union($recursiveQuery), 't1', true);
+```
+
+[[yii\db\Query::withQuery()|withQuery()]] を複数回呼び出してさらなる CTE をメイン・クエリに追加することが出来ます。クエリはアタッチされたのと同じ順序でプリペンドされます。クエリのうちの一つが再帰的である場合は CTE 全体が再帰的になります。
 
 ## クエリ・メソッド <span id="query-methods"></span>
 

docs/guide-ja/start-databases.md

@@ -178,8 +178,9 @@ class CountryController extends Controller
 
 上記のコードを `controllers/CountryController.php` というファイルに保存します。
 
-`index` アクションは `Country::find()` を呼び出します。このアクティブ・レコードのメソッドは `country` テーブルから全てのデータを読み出すことが可能な DB クエリを構築します。
-一回のリクエストで返される国の数を制限するために、クエリは [[yii\data\Pagination]] オブジェクトの助けを借りてページ付けされます。
+最初に `index` アクションは `Country::find()` を呼び出します。この [find()](https://www.yiiframework.com/doc/api/2.0/yii-db-activerecord#find()-detail) メソッドが `country` テーブルからデータを取得するメソッドを提供する [ActiveQuery](https://www.yiiframework.com/doc/api/2.0/yii-db-activequery) クエリ・オブジェクトオブジェクトを生成します。
+
+一回のリクエストで返される国の数を制限するために、クエリ・オブジェクトは [[yii\data\Pagination]] オブジェクトの助けを借りてページ付けされます。
 `Pagination` オブジェクトは二つの目的に奉仕します。
 
 * クエリによって表現される SQL 文に `offset` 句と `limit` 句をセットして、
@@ -187,8 +188,10 @@ class CountryController extends Controller
 * 次の項で説明されるように、一連のページ・ボタンからなるページャを
   ビューに表示するために使われます。
 
-コードの最後で、`index` アクションは `index` と言う名前のビューをレンダリングしています。
-このとき、国データだけでなく、そのページネーション情報がビューに渡されます。
+次に、[all()](https://www.yiiframework.com/doc/api/2.0/yii-db-activequery#all()-detail) メソッドがクエリ結果に基づいて全ての `country` レコードを返します。
+
+コードの最後で、`index` アクションは `index` と言う名前のビューをレンダリングします。
+このときに、返された国データとそのページネーション情報がビューに渡されます。
 
 
 ビューを作成する <span id="creating-view"></span>

docs/guide-ja/start-hello.md

@@ -56,7 +56,7 @@ Yii はコントローラ・クラスの中で、アクション・メソッド
 アクション ID は常に小文字で参照されます。
 アクション ID が複数の単語を必要とするときは、単語がダッシュ (-) で連結されます (例えば、`create-comment`)。
 アクション・メソッドの名前は、アクション ID からダッシュを全て削除し、各単語の先頭の文字を大文字にした結果に `action` という接頭辞を付けたものになります。
-例えば、アクション ID `create-comment` に対応するアクション・メソッド名は `actionCreateComment` となります。
+例えば、アクション ID `create-comment` はアクション・メソッド名 `actionCreateComment` に対応します。
 
 私たちの例では、アクション・メソッドは `$message` というパラメータを取り、そのデフォルト値は `"こんにちは"` です
 (PHP で関数やメソッドの引数にデフォルト値を設定するのと全く同じ方法です)。

docs/guide-ja/start-installation.md

@@ -291,6 +291,66 @@ server {
 また、HTTPS サーバを走らせている場合には、安全な接続であることを Yii が正しく検知できるように、
 `fastcgi_param HTTPS on;` を追加しなければならないことにも注意を払ってください。
 
+### 推奨される NGINX Unit の構成<span id="recommended-nginx-unit-configuration"></span>
+
+[NGINX Unit](https://unit.nginx.org/) と PHP 言語モジュールを使って Yii ベースのアプリを走らせることが出来ます。
+その構成のサンプルです。
+
+```json
+{
+    "listeners": {
+        "*:80": {
+            "pass": "routes/yii"
+        }
+    },
+
+    "routes": {
+        "yii": [
+            {
+                "match": {
+                    "uri": [
+                        "!/assets/*",
+                        "*.php",
+                        "*.php/*"
+                    ]
+                },
+
+                "action": {
+                    "pass": "applications/yii/direct"
+                }
+            },
+            {
+                "action": {
+                    "share": "/path/to/app/web/",
+                    "fallback": {
+                        "pass": "applications/yii/index"
+                    }
+                }
+            }
+        ]
+    },
+
+    "applications": {
+        "yii": {
+            "type": "php",
+            "user": "www-data",
+            "targets": {
+                "direct": {
+                    "root": "/path/to/app/web/"
+                },
+
+                "index": {
+                    "root": "/path/to/app/web/",
+                    "script": "index.php"
+                }
+            }
+        }
+    }
+}
+```
+
+また、自分の PHP 環境を [セットアップ](https://unit.nginx.org/configuration/#php) したり、この同じ構成でカスタマイズした `php.ini` を提供したりすることも出来ます。
+
 ### IIS の構成 <span id="iis-configuration"></span>
 
 ドキュメント・ルートが `path/to/app/web` フォルダを指すように構成された仮想ホストでアプリケーションをホストすることを推奨します。その `web` フォルダに `web.config` という名前のファイル、すなわち `path/to/app/web/web.config` を配置しなければなりません。ファイルの内容は以下の通りです。

docs/guide-ja/tutorial-mailing.md

@@ -23,6 +23,15 @@ return [
     'components' => [
         'mailer' => [
             'class' => 'yii\swiftmailer\Mailer',
+            'useFileTransport' => false,
+            'transport' => [
+                'class' => 'Swift_SmtpTransport',
+                'encryption' => 'tls',
+                'host' => 'your_mail_server_host',
+                'port' => 'your_smtp_port',
+                'username' => 'your_username',
+                'password' => 'your_password',
+            ],             
         ],
     ],
 ];