Update runtime-sessions-cookies.md

docs/guide-zh-CN/runtime-sessions-cookies.md

@@ -9,7 +9,8 @@ Sessions 和 Cookies
 ## Sessions <span id="sessions"></span>
 
 和 [请求](runtime-requests.md) 和 [响应](runtime-responses.md)类似，
-默认可通过为[[yii\web\Session]] 实例的`session` [应用组件](structure-application-components.md) 来访问sessions。
+默认可通过为[[yii\web\Session]] 实例的`session` 
+[应用组件](structure-application-components.md) 来访问sessions。
 
 
 ### 开启和关闭 Sessions <span id="opening-closing-sessions"></span>
@@ -69,10 +70,12 @@ foreach ($session as $name => $value) ...
 foreach ($_SESSION as $name => $value) ...
 ```
 
-> Info: 当使用`session`组件访问session数据时候，如果session没有开启会自动开启，
+> Info: 当使用`session`组件访问session数据时候，
+  如果session没有开启会自动开启，
   这和通过`$_SESSION`不同，`$_SESSION`要求先执行`session_start()`。
 
-当session数据为数组时，`session`组件会限制你直接修改数据中的单元项，例如：
+当session数据为数组时，`session`组件会限制你直接修改数据中的单元项，
+例如：
 
 ```php
 $session = Yii::$app->session;
@@ -117,26 +120,31 @@ $session['captcha.number'] = 5;
 $session['captcha.lifetime'] = 3600;
 ```
 
-为更好的性能和可读性，推荐最后一种方案，也就是不用存储session变量为数组，
+为更好的性能和可读性，推荐最后一种方案，
+也就是不用存储session变量为数组，
 而是将每个数组项变成有相同键前缀的session变量。
 
 
 ### 自定义Session存储 <span id="custom-session-storage"></span>
 
-[[yii\web\Session]] 类默认存储session数据为文件到服务器上，Yii提供以下session类实现不同的session存储方式：
+[[yii\web\Session]] 类默认存储session数据为文件到服务器上，
+Yii提供以下session类实现不同的session存储方式：
 
 * [[yii\web\DbSession]]: 存储session数据在数据表中
 * [[yii\web\CacheSession]]: 存储session数据到缓存中，缓存和配置中的[缓存组件](caching-data.md#cache-components)相关
 * [[yii\redis\Session]]: 存储session数据到以[redis](http://redis.io/) 作为存储媒介中
 * [[yii\mongodb\Session]]: 存储session数据到[MongoDB](http://www.mongodb.org/).
 
-所有这些session类支持相同的API方法集，因此，切换到不同的session存储介质不需要修改项目使用session的代码。
+所有这些session类支持相同的API方法集，因此，
+切换到不同的session存储介质不需要修改项目使用session的代码。
 
-> Note: 如果通过`$_SESSION`访问使用自定义存储介质的session，需要确保session已经用[[yii\web\Session::open()]] 开启，
+> Note: 如果通过`$_SESSION`访问使用自定义存储介质的session，
+  需要确保session已经用[[yii\web\Session::open()]] 开启，
   这是因为在该方法中注册自定义session存储处理器。
 
 学习如何配置和使用这些组件类请参考它们的API文档，如下为一个示例
-显示如何在应用配置中配置[[yii\web\DbSession]]将数据表作为session存储介质。
+显示如何在应用配置中配置[[yii\web\DbSession]]
+将数据表作为session存储介质。
 
 ```php
 return [
@@ -168,13 +176,41 @@ CREATE TABLE session
 - MSSQL: BLOB
 
 > Note: 根据 php.ini 设置的 `session.hash_function`，你需要调整`id`列的长度，
-  例如，如果 `session.hash_function=sha256` ，应使用长度为64而不是40的char类型。
+  例如，如果 `session.hash_function=sha256` ，
+  应使用长度为64而不是40的char类型。
 
+Alternatively, this can be accomplished with the following migration:
+
+```php
+<?php
+
+use yii\db\Migration;
+
+class m170529_050554_create_table_session extends Migration
+{
+    public function up()
+    {
+        $this->createTable('{{%session}}', [
+            'id' => $this->char(64)->notNull(),
+            'expire' => $this->integer(),
+            'data' => $this->binary()
+        ]);
+        $this->addPrimaryKey('pk-id', '{{%session}}', 'id');
+    }
+
+    public function down()
+    {
+        $this->dropTable('{{%session}}');
+    }
+}
+```
 
 ### Flash 数据 <span id="flash-data"></span>
 
-Flash数据是一种特别的session数据，它一旦在某个请求中设置后，只会在下次请求中有效，然后该数据就会自动被删除。
-常用于实现只需显示给终端用户一次的信息，如用户提交一个表单后显示确认信息。
+Flash数据是一种特别的session数据，它一旦在某个请求中设置后，
+只会在下次请求中有效，然后该数据就会自动被删除。
+常用于实现只需显示给终端用户一次的信息，
+如用户提交一个表单后显示确认信息。
 
 可通过`session`应用组件设置或访问`session`，例如：
 
@@ -216,16 +252,29 @@ $alerts = $session->getFlash('alerts');
 
 > Note: 不要在相同名称的flash数据中使用[[yii\web\Session::setFlash()]] 的同时也使用[[yii\web\Session::addFlash()]]，
   因为后一个防范会自动将flash信息转换为数组以使新的flash数据可追加进来，因此，
-  当你调用[[yii\web\Session::getFlash()]]时，会发现有时获取到一个数组，有时获取到一个字符串，
+  当你调用[[yii\web\Session::getFlash()]]时，
+  会发现有时获取到一个数组，有时获取到一个字符串，
   取决于你调用这两个方法的顺序。
 
+> Tip: For displaying Flash messages you can use [[yii\bootstrap\Alert|bootstrap Alert]] widget in the following way:
+>
+> ```php
+> echo Alert::widget([
+>    'options' => ['class' => 'alert-info'],
+>    'body' => Yii::$app->session->getFlash('postDeleted'),
+> ]);
+> ```
+
 
 ## Cookies <span id="cookies"></span>
 
-Yii使用 [[yii\web\Cookie]]对象来代表每个cookie，[[yii\web\Request]] 和 [[yii\web\Response]]
+Yii使用 [[yii\web\Cookie]]对象来代表每个cookie，
+[[yii\web\Request]] 和 [[yii\web\Response]]
 通过名为'cookies'的属性维护一个cookie集合，前者的cookie 集合代表请求提交的cookies，
 后者的cookie集合表示发送给用户的cookies。
 
+The part of the application dealing with request and response directly is controller. Therefore, cookies should be
+read and sent in controller.
 
 ### 读取 Cookies <span id="reading-cookies"></span>
 
@@ -256,7 +305,6 @@ if (isset($cookies['language'])) ...
 
 ### 发送 Cookies <span id="sending-cookies"></span>
 
-You can send cookies to end users using the following code:
 可使用如下代码发送cookie到终端用户：
 
 ```php
@@ -280,20 +328,25 @@ unset($cookies['language']);
 [[yii\web\Cookie::domain|domain]], [[yii\web\Cookie::expire|expire]]
 可配置这些属性到cookie中并添加到响应的cookie集合中。
 
-> Note: 为安全起见[[yii\web\Cookie::httpOnly]] 被设置为true，这可减少客户端脚本访问受保护cookie（如果浏览器支持）的风险，
+> Note: 为安全起见[[yii\web\Cookie::httpOnly]] 被设置为true，
+  这可减少客户端脚本访问受保护cookie（如果浏览器支持）的风险，
   更多详情可阅读 [httpOnly wiki article](https://www.owasp.org/index.php/HttpOnly) for more details.
 
 
 ### Cookie验证 <span id="cookie-validation"></span>
 
-在上两节中，当通过`request` 和 `response` 组件读取和发送cookie时，你会喜欢扩展的cookie验证的保障安全功能，它能
+在上两节中，当通过`request` 和 `response` 组件读取和发送cookie时，
+你会喜欢扩展的cookie验证的保障安全功能，它能
 使cookie不被客户端修改。该功能通过给每个cookie签发一个哈希字符串来告知服务端cookie是否在客户端被修改，
-如果被修改，通过`request`组件的[[yii\web\Request::cookies|cookie collection]]cookie集合访问不到该cookie。
+如果被修改，通过`request`组件的
+[[yii\web\Request::cookies|cookie collection]]cookie集合访问不到该cookie。
 
-> Note: Cookie验证只保护cookie值被修改，如果一个cookie验证失败，仍然可以通过`$_COOKIE`来访问该cookie，
+> Note: Cookie验证只保护cookie值被修改，如果一个cookie验证失败，
+  仍然可以通过`$_COOKIE`来访问该cookie，
   因为这是第三方库对未通过cookie验证自定义的操作方式。
 
-Cookie验证默认启用，可以设置[[yii\web\Request::enableCookieValidation]]属性为false来禁用它，尽管如此，我们强烈建议启用它。
+Cookie验证默认启用，可以设置[[yii\web\Request::enableCookieValidation]]属性为false来禁用它，
+尽管如此，我们强烈建议启用它。
 
 > Note: 直接通过`$_COOKIE` 和 `setcookie()` 读取和发送的Cookie不会被验证。