如何系统地学习Swoole，适合初学者的学习路线有哪些？

本文共计810个文字，预计阅读时间需要4分钟。

这是新手跑TCP/HTTP示例时最常遇到的坑：

• 必须在启动服务前调用 Swoole\Runtime::enableCoroutine(true)，否则所有协程 API（包括 Swoole\Coroutine\sleep、go）都无效
• 该设置需在 new Swoole\Http\Server 之前执行，放在 on("request") 回调里无效
• PHP 8.1+ 开启后，部分扩展（如某些 Redis 客户端）若未适配协程，可能触发 Segmentation fault，建议优先用 Swoole\Coroutine\Redis

swoole_http_server 和 swoole_server 别混用配置项

新手复制代码时容易把 HTTP 服务器的配置直接套到原始 swoole_server 上，比如给 TCP 服务器加 'http_parse_post' 或在 on("request") 里处理非 HTTP 数据——这会导致运行时报错或静默失败。

• swoole_http_server 是 swoole_server 的子类，自带 HTTP 协议解析；裸 swoole_server 只收发原始字节流，需自己实现协议
• worker_num 对两者都有效，但 http_compression、enable_static_handler 等仅 HTTP 服务器支持
• 用 telnet 127.0.0.1 9501 测试时，如果连上就断开，大概率是用了 HTTP 服务器却发了非 HTTP 请求（如纯字符串）

php.ini 加了 extension=swoole.so 却提示 “Class not found”

不是扩展没装，而是 PHP CLI 和 Web SAPI（如 FPM）用的是两套 php.ini。你在终端 php -m | grep swoole 看到了，但 php-fpm 可能根本没加载。

• 查 CLI 配置路径：php --ini；查 FPM 配置路径：php-fpm -i | grep "Loaded Configuration File"
• 确保两个环境的 php.ini 都写了 extension=swoole.so，且扩展文件真实存在（通常在 /usr/lib/php/*/swoole.so 或 $(php-config --extension-dir)/swoole.so）
• 改完 php.ini 后，CLI 不用重启，但 FPM 必须执行 sudo systemctl reload php-fpm（或对应命令）

用 go() 启动协程，但变量修改不生效

协程是独立栈帧，go(function () { $a = 10; }); 里的 $a 和外层不是同一个变量——这不是 Bug，是协程隔离的必然结果。

• 需要共享状态时，用 Swoole\Coroutine\Channel 或 Swoole\Coroutine\WaitGroup，别依赖闭包引用外部变量
• 数据库连接、Redis 实例等资源不能跨协程复用（除非明确支持协程安全），每个协程应单独创建 Swoole\Coroutine\MySQL 实例
• 调试时用 Swoole\Coroutine::getCid() 打印协程 ID，确认逻辑确实在预期协程中执行

Swoole 的“简单”只体现在接口设计上，底层调度和资源边界比传统 PHP 严格得多；一个没关掉的 Channel、一次没 close() 的协程 MySQL 连接，都可能让服务缓慢泄漏内存或卡死——这些细节不在文档首页，但在日志里藏得最深。