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

要在本地快速跑起 ThinkPHP 6.0 + Swoole 协程服务,必须绕过 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,否则协程开关未打开,后续配置全无效。
初始化 ThinkPHP 6.0 项目
在空目录下运行: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/ 下),框架将完全忽略该文件】。
启用 Swoole 协程服务
第一步:编辑 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 请求,协程环境正式激活。
验证协程是否真实运行
方法一:在控制器中写测试代码:
$cid = \Swoole\Coroutine::getCid();
return json(['coroutine_id' => $cid]);
访问接口,若返回非零数字(如 1、7),说明当前在协程上下文中执行。
方法二:用 ab 或 wrk 对 /index/test 接口压测 100 并发,观察内存占用是否平稳上升而非线性暴涨——协程复用同一内存空间,不会像 FPM 那样每请求新建进程。
方法三:在路由闭包中插入 \Swoole\Coroutine::sleep(1);,发起两个并发请求,若两者总耗时约 1 秒而非 2 秒,证明协程已挂起并行切换。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











