本篇內容主要講述了最新的`think-swoole`擴展的使用。目前僅支持Linux環境或者MacOs下運行,要求`swoole`版本為`4.3.1+`。
> 由于 `think-swoole`是基于`swoole`的,要了解這個擴展如何使用,首先需要對`swoole`有一定的了解,這也是本文閱讀的前提,具體可以參考 Swoole官方文檔內容:[https://wiki.swoole.com](https://wiki.swoole.com)
## 安裝
首先按照`Swoole`官網說明安裝`swoole`擴展,然后使用
~~~
composer require topthink/think-swoole
~~~
安裝`think-swoole`擴展。
>[danger] 由于`Swoole`不支持`windows`環境,所以你無法在`windows`環境下測試,只能使用虛擬機或者`WSL`環境測試。
## `HTTP`服務
直接在命令行下啟動HTTP服務端。
~~~
php think swoole
~~~
啟動完成后,默認會在`0.0.0.0:80`啟動一個HTTP Server,可以直接訪問當前的應用。相關配置參數可以在`config/swoole.php`里面配置(具體參考配置文件內容)。
支持的其它操作包括:
啟動HTTP服務(默認)
~~~
php think swoole start
~~~
停止服務
~~~
php think swoole stop
~~~
重啟服務
~~~
php think swoole restart
~~~
`reload`服務
~~~
php think swoole reload
~~~
### 守護進程模式
如果需要使用守護進程方式運行,可以配置
~~~
'options' => [
'daemonize' => true
]
~~~
## 熱更新
由于`Swoole`服務運行過程中PHP文件是常駐內存運行的,這樣可以避免重復讀取磁盤、重復解釋編譯PHP,以便達到最高性能。所以更改業務代碼后必須手動`reload`或者`restart`才能生效。
`think-swoole`擴展提供了熱更新功能,在檢測到相關目錄的文件有更新后會自動`reload`,從而不需要手動進行`reload`操作,方便開發調試。
如果你的應用開啟了調試模式,默認是開啟熱更新的。原則上,在部署模式下不建議開啟文件監控,一方面有性能損耗,另外一方面對文件所做的任何修改都需要確認無誤才能進行更新部署。
熱更新的默認配置如下:

當我們在應用的根目錄下定義一個特殊的`.env`環境變量文件,里面設置了`APP_DEBUG = true`會默認開啟熱更新,你也可以直接把`enable`設置為true。
參數說明:
| 參數 | 說明 |
| --- | --- |
| enable | 是否開啟熱更新 |
| name | 簡單點說就是監控那些類型的文件變動 |
| include | 簡單點說就是監控那些路徑下的文件變動 |
| exclude | 排除目錄 |
## 連接池
`think-swoole` 默認有實現數據庫和緩存連接池功能,涵蓋了日常開發的主要場景。
最新的`swoole`版本支持[一鍵協程](https://wiki.swoole.com/#/runtime),比如`redis`、`mysql`等等,很方便。連接池是在這個基礎上,解決一些問題和對性能的再一次提升。
要開啟一鍵協程,需要配置如下參數

這里需要設置為true,默認已經打開,flags默認即可。
連接池的配置參數如下:

參數說明:
| 參數 | 說明 |
| --- | --- |
| enable | 開關,不需要設置false |
| max\_active | 最大連接數,超過將不再新建連接 |
| max\_wait\_time | 超時時間 |
其中的`max_active`和`max_wait_time`需要根據自身業務和環境進行適當調整,最大化提高系統負載。
- 序言
- 基礎
- 安裝
- 開發規范
- 目錄結構
- 配置
- 架構
- 請求流程
- 架構總覽
- 入口文件
- 多應用模式
- URL訪問
- 容器和依賴注入
- 服務
- 門面
- 中間件
- 事件
- 路由
- 路由定義
- 變量規則
- 路由地址
- 路由參數
- 路由中間件
- 路由分組
- 資源路由
- 注解路由
- 路由綁定
- 域名路由
- MISS路由
- 跨域請求
- URL生成
- 控制器
- 控制器定義
- 基礎控制器
- 空控制器
- 資源控制器
- 控制器中間件
- 請求
- 請求對象
- 請求信息
- 輸入變量
- 請求類型
- HTTP頭信息
- 偽靜態
- 參數綁定
- 請求緩存
- 響應
- 響應輸出
- 響應參數
- 重定向
- 文件下載
- 數據庫
- 連接數據庫
- 分布式數據庫
- 查詢構造器
- 查詢數據
- 添加數據
- 更新數據
- 刪除數據
- 查詢表達式
- 鏈式操作
- where
- table
- alias
- field
- strict
- limit
- page
- order
- group
- having
- join
- union
- distinct
- lock
- cache
- cacheAlways
- comment
- fetchSql
- force
- partition
- failException
- sequence
- replace
- extra
- duplicate
- procedure
- 聚合查詢
- 分頁查詢
- 時間查詢
- 高級查詢
- 視圖查詢
- JSON字段
- 子查詢
- 原生查詢
- 獲取查詢參數
- 查詢事件
- 獲取器
- 事務操作
- 存儲過程
- 數據集
- 數據庫驅動
- 模型
- 定義
- 模型字段
- 新增
- 更新
- 刪除
- 查詢
- 查詢范圍
- JSON字段
- 獲取器
- 修改器
- 搜索器
- 數據集
- 自動時間戳
- 只讀字段
- 軟刪除
- 類型轉換
- 模型輸出
- 模型事件
- 模型關聯
- 一對一關聯
- 一對多關聯
- 遠程一對多
- 遠程一對一
- 多對多關聯
- 多態關聯
- 關聯預載入
- 關聯統計
- 關聯輸出
- 虛擬模型
- 視圖
- 模板變量
- 視圖過濾
- 模板渲染
- 模板引擎
- 視圖驅動
- 錯誤和日志
- 異常處理
- 日志處理
- 調試
- 調試模式
- Trace調試
- SQL調試
- 變量調試
- 遠程調試
- 驗證
- 驗證器
- 驗證規則
- 錯誤信息
- 驗證場景
- 路由驗證
- 內置規則
- 表單令牌
- 注解驗證
- 雜項
- 緩存
- Session
- Cookie
- 多語言
- 上傳
- 命令行
- 啟動內置服務器
- 查看版本
- 自動生成應用目錄
- 創建類庫文件
- 清除緩存文件
- 生成數據表字段緩存
- 生成路由映射緩存
- 輸出路由定義
- 自定義指令
- Debug輸出級別
- 擴展庫
- 數據庫遷移工具
- Workerman
- think助手工具庫
- 驗證碼
- Swoole
- 附錄
- 助手函數
- 升級指導
- 更新日志