Hyperf 当前不支持 PHP 8.5，因该版本尚未发布；官方明确支持 PHP 8.1–8.3，3.1.x 已适配 8.3，对 8.4 alpha 无保障，强行使用会导致 composer install 失败。
Hyperf 当前不支持 PHP 8.5
PHP 8.5 尚未发布（截至 2024 年 7 月，最新稳定版是 PHP 8.3.10，PHP 8.4 处于 alpha 阶段），所以不存在“Hyperf 兼容 PHP 8.5”的问题——它连尝鲜机会都没有。
你看到的“php8.5hyperf”这类关键词，大概率是误传、拼写错误，或把 PHP 8.3 / PHP 8.4 alpha 误标为 8.5。Hyperf 官方仓库的 composer.json 中，"php": "^8.1 || ^8.2 || ^8.3" 是当前明确支持的范围。
-
Hyperf 3.1.x已适配PHP 8.3，但对PHP 8.4 alpha无官方保障，更不涉及不存在的 8.5 - 强行用未发布的 PHP 版本跑 Hyperf，
composer install会直接失败，报错类似：Your requirements could not be resolved to an installable set of packages. - PHP 主版本号跳变（如从 8.3 直奔 8.5）不符合 PHP 的发布节奏——它只按年出一个主版本（8.2 → 8.3 → 8.4…），且每个版本都有明确 RFC 和冻结时间表
升级 Hyperf 前必须确认 PHP 版本真实值
很多人在 Docker 或 macOS 上执行 php -v 看到带 dev 或 alpha 字样的输出，就以为是“新版”，其实只是本地编译的实验分支，和生产兼容性完全无关。
- 运行
php -r "echo PHP_VERSION;"获取纯净版本号，排除构建信息干扰 - 检查
php --ini加载的配置路径，确认没被brew、phpbrew或自定义php.ini混淆环境 - Docker 用户重点看
Dockerfile里是否写了类似FROM php:8.5-cli——这行会构建失败，应改为php:8.3-cli或等待官方镜像更新
Hyperf 升级到 3.1+ 后，PHP 8.3 特性可用但需谨慎
Hyperf 3.1 支持 PHP 8.3，意味着你能用 #[\Override]、只读类（readonly class）、新 JSON 扩展行为等，但框架内部并未大规模采用这些特性——它们主要影响你自己的业务代码。
立即学习“PHP免费学习笔记（深入）”；
-
#[\Override]可用于重写 Hyperf 组件方法，但注意：Hyperf 的Container对属性注入的反射逻辑在 PHP 8.3 下有微小差异，若自定义了@Value或@Inject的 setter 注入，需加#[\Override]显式声明 - PHP 8.3 默认开启
json_throw_on_error，如果你在JsonRpc或HttpClient中手动调用json_encode()/json_decode()，建议统一补上错误处理，避免静默失败 - 不要在
config/autoload/dependencies.php里用 PHP 8.3 的新语法（如枚举作为数组键），因为该文件可能被早期 PHP 版本的 CLI 加载器预解析
别信“一键升级 PHP 8.5 + Hyperf”的脚本或教程
所有声称支持 PHP 8.5 的 Hyperf 教程、迁移脚本、Docker Compose 示例，目前都不可信。它们要么基于虚构版本，要么把 php:8.4-rc 错标为 8.5，要么悄悄降级用了 php:8.3 却不说明。
- 查 GitHub 上 Hyperf 主仓库的
CI配置（.github/workflows/ci.yml），真实测试矩阵永远只包含8.1、8.2、8.3 - Composer require 时加
--dry-run参数，能提前暴露版本冲突，比等 CI 报错快得多 - 如果团队真在试 PHP 8.4 alpha，务必锁定 Hyperf
dev-main分支，并接受随时 break 的风险——这不是迁移，是参与开发
真正要操心的不是“8.5 兼容”，而是你本地 PHP 版本是不是被误判了，以及 Hyperf 的 composer.json 约束有没有被绕过。版本号写错一个数字，后面所有操作都是在调试幻觉。
