4.3.0 [大版本] · Swoole文檔手冊

# 4.3.0 \[大版本\] [TOC] ## 新增 * 新增`Co::getContext`獲取協程上下文對象 ([RFC-1018](https://github.com/swoole/rfc-chinese/issues/45)) ([@twose](https://github.com/twose)) * 新增`Co::getPcid`獲取父協程ID ([RFC-1017](https://github.com/swoole/rfc-chinese/issues/41)) ([@twose](https://github.com/twose)) * 新增`Co::exists`判斷協程是否存在 ([@twose](https://github.com/twose)) * 協程Hook支持`stream_select`([#2358](https://github.com/swoole/swoole-src/pull/2358)) (matyhtf) * BASE模式下增加`max_wait_time`配置支持 ([#2282](https://github.com/swoole/swoole-src/pull/2282)) ([@shiguangqi](https://github.com/shiguangqi)) * 支持在Master/Manager/User進程中單向投遞任務 ([RFC-1015](https://github.com/swoole/rfc-chinese/issues/38)) ([@matyhtf](https://github.com/matyhtf)) * `Co\Socket`模塊新增`recvAll`和`sendAll`兩個API, 用于確保完整收/發數據, 直到完成或產生錯誤 ([`3700cbb`](https://github.com/swoole/swoole-src/commit/3700cbb4a5605ec9da74408d4303340852e663cf))([@twose](https://github.com/twose)) * Process支持協程模式, 具體請參考 ([Process中使用協程](https://wiki.swoole.com/wiki/page/p-process_coro.html)) * 新增`Server->getCallback`方法獲取Server指定名稱的回調函數 ([@matyhtf](https://github.com/matyhtf)) ## 增強 * 現在默認的最大連接數是100K (而不是10K), 如果系統配置小于此數量時取系統配置 ([`3d2e387`](https://github.com/swoole/swoole-src/commit/3d2e3871940ec9eebb109284e4b0cec209fd35f7)) ([@twose](https://github.com/twose)) * 優化Timer定時器的底層代碼, 現在它的運行速度更快, 并且支持任意數量的傳參 ([#2347](https://github.com/swoole/swoole-src/pull/2347)) ([@twose](https://github.com/twose)) * `Co::stats`將展示更多信息如事件數量, 監聽信號數量, aio任務數量等 ([@matyhtf](https://github.com/matyhtf)) * `Co::getBackTrace`在不傳參時等同于獲取當前調用棧即`debug_backtrace`, 便于代碼統一書寫 ([@twose](https://github.com/twose)) * `Co::listCoroutines`重命名為`Co::list`, 但仍保留原名作為別名(向下兼容) ([@twose](https://github.com/twose)) * `Table::exist`,`Server::exist`皆重命名為`exists`, 但仍保留原名作為別名(向下兼容) ([@twose](https://github.com/twose)) * Redis自動重連時將會自動鑒權和選擇對應的數據庫, 新增API:`getOptions`,`getAuth`,`getDBNum`([#2303](https://github.com/swoole/swoole-src/pull/2303)) ([`fdac8a3`](https://github.com/swoole/swoole-src/commit/fdac8a35c4bb48850c64f00dc60440bb679f096a)) ([@windrunner414](https://github.com/windrunner414)&[@twose](https://github.com/twose)) * FreeBSD下默認Socket緩沖區應為2M ([`750a29c`](https://github.com/swoole/swoole-src/commit/750a29cec6e92977dfc6ef7e80c8b5397f6af512)) ([@twose](https://github.com/twose)) * `Server->stats`返回值新增`worker_dispatch_count`來得到master向當前進程投遞請求數量, 可通過`worker_dispatch_count - worker_request_count`來獲得排隊中的請求數量 ([`a353808`](https://github.com/swoole/swoole-src/commit/a353808ed4cd0dda2d746ba114a1bf1d3ac8043c)) ([@matyhtf](https://github.com/matyhtf)) * 移除Nghttp2依賴, 可無需安裝, 直接編譯選項開啟 * 協程現在沒有最大嵌套層數限制, 可無限嵌套(協程之間并沒有實質的嵌套關系) ([`5458cbc`](https://github.com/swoole/swoole-src/commit/5458cbcf4fd401db442d7580072d06f5489cec79)) ([@twose](https://github.com/twose)) * 協程達到上限時, http服務器將會返回503錯誤表示服務暫時不可用 ([`ebd377f`](https://github.com/swoole/swoole-src/commit/ebd377f629aa7dca44ee421862d032b6514d6c74)) ([@twose](https://github.com/twose)) * `defer`現在會接收一個參數, 其值為協程結束時的返回值 ([example](https://github.com/swoole/swoole-src/commit/ef978b3b432615b0f392958145d999f4e66584eb)) ([@twose](https://github.com/twose)) ## 修復 * 修復task方法傳遞null參數時出錯的問題 ([#2366](https://github.com/swoole/swoole-src/issues/2366)) ([@twose](https://github.com/twose)) * 修復Http客戶端發送大數據時發送不完整的問題 ([#2360](https://github.com/swoole/swoole-src/issues/2360)) ([@twose](https://github.com/twose)) * 修復TCP客戶端使用eof協議時, 緩沖區中未處理的數據丟失的問題 ([`a59ae39`](https://github.com/swoole/swoole-src/commit/a59ae394aadfeed77a364d2803e898b6bad39879)) ([@twose](https://github.com/twose)) * 修復Server Reload的異步安全性 ([`022f859`](https://github.com/swoole/swoole-src/commit/022f85920110c6eb94454d6112176b40ae6c9628)) ([@matyhtf](https://github.com/matyhtf)) * 修復連接迭代器的索引值 ([`b066146`](https://github.com/swoole/swoole-src/commit/b066146c4e01e84df5414dc917898dfd55554acd)) ([@twose](https://github.com/twose)) * 修復Set-Cookie時, 特殊字符過長被截斷 ([#2368](https://github.com/swoole/swoole-src/issues/2368)) ([@mabu233](https://github.com/mabu233)&[@twose](https://github.com/twose)) * 修復Http客戶端沒有解碼cookie的問題(發送時重復編碼) ([`069ca5d`](https://github.com/swoole/swoole-src/commit/069ca5df5736485f2e7e78e7559a4569d15c08ad)) ([@twose](https://github.com/twose)) * 修復Http客戶端下載時使用超時功能導致coredump ([#2377](https://github.com/swoole/swoole-src/issues/2377)) ([@matyhtf](https://github.com/matyhtf)&[@twose](https://github.com/twose)) * 修復`__call`+`call_user_func*`調用MySQL客戶端方法時產生的coredump ([#2387](https://github.com/swoole/swoole-src/issues/2387)) ([@matyhtf](https://github.com/matyhtf)) * 修復Http2客戶端header名傳入數字時產生的coredump ([#2375](https://github.com/swoole/swoole-src/pull/2375)) ([@mabu233](https://github.com/mabu233)) * 修復`Swoole\Event::Dispatch`行為不符合預期 ([#2390](https://github.com/swoole/swoole-src/issues/2390)) ([@matyhtf](https://github.com/matyhtf)) * 修復PHP7.0.x極低版本下編譯失敗 ([`768b8a7`](https://github.com/swoole/swoole-src/commit/768b8a708ce7acfe2fecd327a525085cfc746703)) ([@shiguangqi](https://github.com/shiguangqi)) * 修復Socks5代理握手失敗 ([`94ef96c`](https://github.com/swoole/swoole-src/commit/94ef96ce700bd4dd03946961e4553f24bf3c9446)) ([@twose](https://github.com/twose)) * 修復低版本LINUX內核下連接失敗導致的內存讀錯誤 ([`5adf625`](https://github.com/swoole/swoole-src/commit/5adf625fc34c6e997eba0495cb209ec4e19c0e60)) ([@matyhtf](https://github.com/matyhtf)&[@twose](https://github.com/twose)) * 修復Server在BASE單進程模式下在master進程使用定時器無效的問題 ([`82eca13`](https://github.com/swoole/swoole-src/commit/82eca138333fa0a4bb6ef2df319837281c9c7720)) ([@twose](https://github.com/twose)) * 修復由于低版本ZendAPI不穩定可能導致的編譯不通過的問題 ([`768b8a7`](https://github.com/swoole/swoole-src/commit/768b8a708ce7acfe2fecd327a525085cfc746703)) ([@shiguangqi](https://github.com/shiguangqi)) * 修復調用sendto時返回EINVAL ([#2395](https://github.com/swoole/swoole-src/pull/2395)) ([@junwei](https://github.com/junwei)) ## 禁止 * 禁止在使用異步文件IO后創建Server或創建自定義進程 * 禁止在協程內創建Server或創建自定義進程 ## 移除 * `Websocket\Server->exists`只判斷連接是否存在, 請使用`isEstablished`方法判斷是否為Websocket客戶端 * 移除`swoole.fast_serialize`配置項 * 移除了協程客戶端方法調用失敗時產生的Warning, 統一使用返回值和錯誤碼判斷 * 移除`Server->gzip`方法 * 移除`PicoHttpParser`支持 ## 移除異步模塊移除所有異步模塊, 分離異步擴展到[async-ext](https://github.com/swoole/async-ext)移除的異步模塊如下: * Async系列函數 * MySQL * Redis * Http\\Client * Memory\\Pool * MsgQueue * RingQueue ## 單元測試 * 測試支持在任意裝有docker的主機上運行并自動部署基于docker的swoole/mysql/redis容器, 詳情參閱源碼目錄下travis文件夾內的README文檔