必须直连 swoole 内置服务器才能启用 thinkphp 6.0 协程:确认 swoole ≥4.8.0、coroutine enabled、安装 think-swoole 并配置 coroutine.enable=true 与 mode=swoole_base/process,最后执行 php think swoole:start 启动服务。

要在本地快速启动 ThinkPHP 6.0 的 Swoole HTTP 服务,必须绕过 PHP-FPM 直连 Swoole 内置服务器,否则协程、连接池、WebSocket 等核心特性全部失效——所有请求退化为传统同步阻塞模式,性能与功能双双归零。
确认 Swoole 扩展已就绪
执行 php -r "echo SWOOLE_VERSION;",输出版本号必须 ≥ 4.8.0;若报错或无输出,说明 swoole 扩展未加载。
运行 php -m | grep swoole,确保终端返回 swoole 字样;若使用宝塔,请检查当前 CLI 执行的 PHP 版本是否与面板中启用的版本一致——【不同 PHP 版本间扩展不互通,此处错配会导致后续所有命令静默失败】。
再执行 php --ri swoole | grep coroutine,必须看到 coroutine => enabled,否则协程开关未打开,后续配置全无效。
初始化项目并安装 think-swoole
在空目录下运行:composer create-project topthink/think tp6-swoole。
进入项目目录:cd tp6-swoole。
安装官方 Swoole 适配器:composer require topthink/think-swoole;该包提供 php think swoole:publish 命令,会自动生成 config/swoole.php 配置文件——【若手动创建,路径或命名错误(如写成 swoole.php.bak 或放在 config/app/ 下),框架将完全忽略该文件】。
编辑 config/swoole.php 启用服务
第一步:定位到 'coroutine' => [] 节点,确保其中包含:'enable' => true 和 'flags' => SWOOLE_HOOK_ALL。
第二步:在 'server' => [] 中设置监听地址与端口,例如:'host' => '0.0.0.0'、'port' => 9501。
第三步:关键一步——修改 'mode' 值为 SWOOLE_BASE 或 SWOOLE_PROCESS(不能留空或写字符串);若设为 SWOOLE_BASE,协程调度更轻量,适合开发调试;若需 Task 进程处理耗时任务,则选 SWOOLE_PROCESS。
第四步:保存后,在项目根目录执行 php think swoole:start;成功时终端显示 Server started on http://0.0.0.0:9501,且进程持续运行不退出——这表示 Swoole 已接管 HTTP 请求,协程环境正式激活。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











