update 2019年7月19日18:22:36

Author: veaba

.gitignore

@@ -1 +1,3 @@
-_book
+_book
+.idea
+demos/server/node_modules

README.md

@@ -1,5 +1,6 @@
 # Table of contents
 * [关于本socket.io中文文档](README.md)
+* [socke.IO website](https://socket.io/)
 
 * [1 指南(Guide)]()
     * [1-1 介绍(Introduction)](guide/introduction.md)
@@ -30,11 +31,12 @@
         * [2.2.2 房间](docs/rooms_and_namespaces/rooms.md)
         * [2.2.3 给外部发送消息](docs/rooms_and_namespaces/sending_message_from_the_outside-world.md)
 
-    * [2.3 migrating_from_0.9]()
+    * [2.3 从0.9迁移版本 migrating_from_0.9]()
         * [2.3.1 authentication_differences](docs/migrating_from_0.9/authentication_differences.md )
-        * [2.3.2 parser_protocol_differences](docs/migrating_from_0.9/parser_protocol_differences.md)
-        * [2.3.3 log_differences](docs/migrating_from_0.9/log_differences.md)
-        * [2.3.4 shorcuts](docs/migrating_from_0.9/shorcuts.md)
+        * [2.3.2 log_differences](docs/migrating_from_0.9/log_differences.md)
+        * [2.3.3 shorcuts](docs/migrating_from_0.9/shorcuts.md)
+        * [2.3.4 configuration_differences](docs/migrating_from_0.9/configuration_differences.md)
+        * [2.3.5 parser_protocol_differences](docs/migrating_from_0.9/parser_protocol_differences.md)
 
     * [2.4 using_multiple_nodes]()
         * [2.4.1 apache_httpd_configuration](docs/using_multiple_nodes/apache_httpd_configuration.md)

SUMMARY.md

@@ -0,0 +1,59 @@
+## 身份验证差异
+
+### Socket.io 现使用中间器件
+
+可以通过io.use（）为socket.io服务器提供任意函数，该函数在创建socket时运行。查看此示例：
+
+```js
+const srv=require('http').createServer();
+const io = require('socket.io')(srv)
+let run=0;
+
+io.use((socket,next)=>{
+    run++; //0->1
+    next()
+});
+
+io.use((socket,next)=>{
+    run++;// 1->2
+    next();
+})
+
+const socket=require('socket.io-client')();
+socket.io('connect',()=>{
+    // run  此时等于2
+})
+
+```
+
+### 现通过中间件进行身份验证更简单
+
+旧的`io.set()`和`io.get()`已弃用，只能支持向后兼容。下面是一个将旧的授权示例转换为中间件样式的转换：
+
+```js
+io.set('authorization',(handshakeData,callback)=>{
+    //确保握手数据看起来不错
+    callback(null,true)//出错，'authorized' boolean second
+})
+```
+新的：
+
+```js
+io.use((socket,next)=>{
+    const handshakeData= socket.request;
+    // 确保握手数据看起来和以前一样好
+    // 如果错误，则执行这个：
+    // next(new Error('not authorized'));
+    // 否则回调next
+    next();
+})
+```
+
+### 命名空间授权?
+
+```js
+io.of('/namespace').use((socket,next)=>{
+    const handshakeData= socket.request;
+    next()
+})
+```

docs/migrating_from_0.9/authentication_differences.md

@@ -0,0 +1,33 @@
+## 配置差异
+
+### io.set 不见了
+相反，在服务器初始化中进行如下配置：
+
+```js
+const socket= require('socket.io')({
+    // 这里是选项
+})
+```
+
+日志级别等选项已不存在,`io.set('transports')`, `io.set('heartbeat interval')`, `io.set('heartbeat timeout'`, 和 `io.set('resource')` 仍然支持向后兼容性。
+
+
+### 设置资源路径
+
+上一个`资源`选项等效于新`路径`选项，但在开始时需要一个`/`。例如，以下配置：
+
+```js
+const socket= io.connect('localhost:3000',{
+    resource:"path/to/socket.io";
+})
+```
+
+变成：
+
+
+```js
+const socket= io.connect('localhost:3000',{
+    path:'/path/to/socket.io';
+})
+
+```

docs/migrating_from_0.9/configuration_differences.md

@@ -0,0 +1,18 @@
+## 日志差异
+
+### 现在支持基于调试的日志记录
+
+要打印所有调试日志，请将环境变量DEBUG设置为。ie：`DEBUG=node index.js`
+
+只打印socket.io相关日志：`DEBUG=socket.io:*node index.js`。
+
+只从socket对象打印日志：`DEBUG=socket.io:socket node index.js`
+
+希望这种模式在这一点上是有意义的。socket.io/lib中的文件名与其调试名等效。
+
+调试也在浏览器中工作；日志被保存到本地存储。
+
+使用：打开开发控制台，键入`localstorage.debug='socket.io:*'`（或任何调试级别），然后刷新页面。在运行`localstorage.debug=''`之前，所有内容都会被记录。
+
+请参阅此处的调试文档了解[更多信息](https://www.npmjs.org/package/debug)
+

docs/migrating_from_0.9/log_differences.md

@@ -0,0 +1,37 @@
+## 快捷方式
+
+一般来说，常见事物有一些新的捷径。旧版本应该仍然有效，但是快捷方式很好。
+
+### 向默认命名空间中的所有客户端广播
+
+以前:
+
+```js
+io.sockets.emit('eventname',"eventdata");
+```
+现在：
+
+```js
+io.emit('eventname','eventdata')
+```
+
+整洁。
+
+请注意，在这两种情况下，这些消息都会到达连接到默认“/”命名空间的所有客户端，但不会到达其他命名空间中的客户端。
+
+### 启动服务端
+
+以前：
+
+```js
+const io = require('socket.io');
+const socket=io.listen(80,{/*选项*/});
+
+```
+
+现在：
+
+```js
+const io=require('socket.io');
+const socket=io({/*选项*/})
+````

docs/migrating_from_0.9/shorcuts.md

@@ -1,4 +1,5 @@
 ## 广播消息
+- 广播时不支持回调
 
 要进行广播，只需添加广播标志即可发出和发送方法调用。 广播意味着向除了启动它的socket之外的所有人发送消息。
 
@@ -8,5 +9,6 @@
 const io = require('socket.io')(80)
 io.on('connection',(socket)=>{
     socket.broadcast.emit('user connected')
+    socket.broadcast.to('socketId').emit('hi',"hi") //给指定人发送
 })
- ```
+ ```

docs/overview/broadcasting_messages.md

@@ -14,7 +14,7 @@ app.get('/',(req,res)=>{
 
 io.on('connection',(socket)=>{
     socket.emit('news',{hello:'world'}
-    soclet.ont('my other event',(data)=>{
+    socket.on('my other event',(data)=>{
         console.log(data)
     })
 })

docs/overview/using_with_express.md

@@ -1 +1,45 @@
-## 房间
+## 房间
+
+在每个名称空间中，还可以定义`sockets`可以`join(加入/连接)`和`level(离开)`的任意通道。
+
+### 加入或离开
+
+可以调用`join`来订阅给定通道的 `socket`
+
+```js
+io.on('connection',socket=>{
+    socket.join("some room")
+})
+```
+
+然后在广播或者emit时，简单地使用 `to` 或 `in`（两者是相同）：
+
+```js
+io.to('some room').emit('some event');
+```
+
+离开该频道，请以与`join`的相同的方式调用`level`:
+
+```js
+io.level("some room")
+```
+
+### 默认房间
+
+Socket.io中的每`Socket`都由一个随机的、不可访问的、唯一的标识符`Socket#id`标识。为了方便起见，每个套接字都自动加入由该id标识的房间。
+
+
+这使得向其他socket 广播消息变得容易：
+
+```js
+io.on('connection',(socket)=>{
+    socket.io('say to someone',(id,msg)=>{
+        socket.broadcast.to(id).emit("my message",msg)
+    })
+})
+```
+
+### 断开
+
+断开连接后，sockets 会自动离开它们所属的所有通道，不需要进行特殊处理。
+