必须直连 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，否则协程开关未打开，后续配置全无效。
立即学习“PHP免费学习笔记（深入）”；
初始化 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 秒，证明协程已挂起并行切换。
