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