PHP 8.5 尚未发布，Hyperf 当前仅官方支持 PHP 8.1～8.3；其协程依赖 Swoole 扩展而非 PHP 原生语法，v3.2 要求 Swoole ≥5.0.3。
PHP 8.5 尚未发布，Hyperf 当前不支持
目前（2024 年中）PHP 官方最新稳定版是
，
处于 alpha 阶段，
连正式开发计划都未公布——它不存在，更谈不上“兼容性”或“协程支持”。所有声称“PHP 8.5 + Hyperf”的讨论，要么混淆了版本号，要么基于非官方分支或误传。
Hyperf 官方明确支持的 PHP 版本截至
是
～
。你如果在 composer.json 里写
，
会直接失败，报错类似：
Hyperf 协程底层依赖 Swoole，不是 PHP 原生协程
Hyperf 的协程能力完全来自
扩展，而非 PHP 语言层的
/
（PHP 目前也没有原生协程语法）。这意味着：
版本必须与 Hyperf 版本对齐：例如 Hyperf
要求
PHP 本身只是运行环境，只要满足最低要求（如
），协程行为几乎不受 PHP 小版本升级影响
但 PHP 8.3 的 JIT、FFI 等特性可能间接影响
性能，需以实际压测为准，不能默认“新版一定更好”
升级 PHP 小版本前必须验证 swoole 兼容性
哪怕只是从
升到
，也要检查三点：
立即学习
“
PHP免费学习笔记（深入）
”；
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
当前
版本是否在
Swoole 官方支持列表
中标注支持该 PHP 版本
运行
，确认输出中没有
启动 Hyperf 时观察日志：若出现
或
，说明协程初始化失败，大概率是
编译/加载问题
示例错误日志：
—— 这和 PHP 版本无关，而是
里漏配了
。
Hyperf v3.x 在 PHP 8.3 下的实际表现要点
目前主流生产环境已跑通
，但要注意：
类型注解在 PHP 8.3 有细微行为变化，若你自定义了基于反射的 AOP 切面，需检查
返回结构是否一致
扩展在 PHP 8.3 默认禁用
的旧式连接池，Hyperf 的
组件若直连 MySQL，建议改用
驱动
协程上下文（
）在高并发下内存泄漏风险比 8.2 更明显，建议配合
插件做兜底
真正卡住上线的往往不是版本数字，而是某条没覆盖到的
逻辑在新 PHP 版本抛出了不同异常类型——比如
替代了
，而你的 catch 没跟上。
8.3.108.48.5v3.28.18.3"php": "^8.5"composer installYour requirements could not be resolved to an installable set of packages.swooleasyncawaitswoolev3.2swoole >=5.0.3,8.1+swoole8.2.128.3.0swoolephp --ri swooleWARNING: PHP version mismatchcoroutine is not enabledFailed to create coroutineswoole[ERROR] Swoole\Coroutine::create(): coroutine is not enabled, please check if 'swoole.enable_coroutine' is set to 'On'php.iniswoole.enable_coroutine = OnHyperf v3.2.9 + PHP 8.3.7 + Swoole 5.1.1#[Attribute]ReflectionAttribute::getArguments()mysqlimysqlnddbpdo_mysqlCo::getContext()hyperf/memory-limittry/catchJsonExceptionInvalidArgumentException