swoole 没有 5.0 版本，当前最新稳定版是 4.10.x；所谓“swoole 5”系误传，官方仓库、文档、changelog 均无 v5 相关记录，升级重点应放在 4.8.0+ 的协程增强与 php 8.1+ 兼容性上。
Swoole 没有官方发布的 5.0 版本，所谓 “Swoole 5” 是误传或社区非正式叫法；当前最新稳定版是 Swoole 4.10.x（截至 2026 年 3 月），所有生产环境应以 4.8.0+ 为基准选型。
为什么搜不到 swoole5 的 release 页面
官方 Gitee 仓库 https://gitee.com/hp3347/swoole 最新 tag 是 v4.10.1，GitHub 镜像同源。Swoole 团队从未发布过 major 版本号为 5 的分支或文档 —— 这和 Java 的 Servlet 4.0 → 5.0、Swift 4 → 5 等有明确版本演进的项目不同，Swoole 的主版本迭代止步于 4.x。
- 部分人把
swoole-src的某个开发分支、或第三方打包镜像（如某些 Docker 镜像标签写错）误称为 “5.0” - 也有将
php-swoole扩展与 PHP 主版本混淆的，比如在 PHP 8.3 下用 Swoole 4.10，被简写成 “swoole5 for php83”，纯属命名不严谨 - 官方 changelog、升级指南、CI 构建脚本里均无
v5.前缀的 commit 或 tag
swoole4.0 到 4.10 的关键演进点
真正的升级价值不在 “4→5”，而在 4.0.0 → 4.10.x 这十年间持续打磨出的稳定性、协程能力边界和运维友好性。
-
4.4.0+起全面支持PHP 8.0/8.1，修复了大量 JIT 兼容问题；4.8.0+开始适配PHP 8.2/8.3的属性反射变更 -
4.6.0引入Co::waitGroup和增强版Channel::select()，协程同步原语更接近 Go 风格 -
4.8.5起默认启用enable_coroutine => true，MySQLi/PDO 的协程 Hook 更彻底，无需手动go(function() { ... })包裹 -
4.10.0优化了Server->stats()的内存占用，并修复了Http2Client在长连接复用下的 header 内存泄漏
升级到 4.10.x 容易踩的坑
很多团队卡在 4.5.x 或 4.6.x，不是因为不想升，而是几个硬性兼容点没处理好。
- 如果你还在用
new Swoole\Http\Server+on('request')手动解析 body，4.8.0+默认开启http_compression，gzip 编码请求体可能让$request->rawContent()返回空 —— 改用$request->getData()或显式关掉压缩 -
4.7.0后废弃了Swoole\Coroutine\MySQL类名，必须改用Swoole\Coroutine\Mysql（大小写敏感），否则 autoload 直接报Class not found - 自定义进程使用
Process::signal()捕获SIGUSR1时，4.9.0+要求先调用Process::set(['signal_dispatch' => true])，否则信号不触发回调 - 若依赖
ext-redis的协程版，确保已安装swoole_redis扩展（非 phpredis），且 PHP 配置中extension=swoole.so必须在extension=redis.so之后加载，否则new Co\Redis()会 fallback 到阻塞模式
真正要关心的不是 “有没有 5.0”，而是你用的 swoole_version() 返回值是否 ≥ 4.8.0、PHP 版本是否 ≥ 8.1、以及协程 MySQL/Redis 客户端有没有在真实压测中暴露出超时或连接复用异常 —— 这些细节，比版本号大一位小数重要得多。
