PHP 8.5与Magento 2兼容吗？升级需注意这些！

PHP 8.5 与 Magento 2 不兼容，因 PHP 8.5 彻底移除 create_function()、强化动态属性报错、严格化类型推导等变更导致核心模块中断；Magento 官方截至 2026 年 3 月未支持，最新版 2.4.7 最高仅验证至 PHP 8.2。

PHP 8.5 和 Magento 2 当前不兼容

Magento 官方截至 2026 年 3 月仍未宣布对 PHP 8.5 的任何支持。最新稳定版 Magento 2.4.7（发布于 2025 年底）明确要求的最高 PHP 版本仍是 PHP 8.1 或 PHP 8.2（部分补丁版本有限支持 8.2，但非全功能验证）。强行在生产环境启用 PHP 8.5 会导致大量致命错误——不是“可能报错”，而是核心模块直接中断。

为什么 Magento 2 无法跑在 PHP 8.5 上

根本原因不在 Magento 代码写得“旧”，而在于 PHP 8.5 主动移除了 Magento 2 底层严重依赖的若干语法和运行时行为：

• create_function() 已被彻底删除，而部分第三方模块（尤其老插件、自定义支付/物流适配器）仍用它动态构造回调
• 动态属性创建（如 $obj->unknown_prop = 'x'）在 PHP 8.5 中默认触发 Error 而非 Notice，Magento 2.4.x 大量使用 __get/__set 的松散对象模型会立刻崩
• never 类型虽是新特性，但 Magento 自身类型声明未覆盖全部入口，Composer 自动注入或 DI 容器在解析联合类型时可能因 PHP 8.5 更严格的推导逻辑而失败
• 扩展层面：ext/mysql 虽早已移除，但部分遗留安装脚本或数据库迁移工具仍残留对其的检测逻辑，在 PHP 8.5 下会因函数不存在直接 Fatal error

升级前必须做的三件事

如果你正在评估从 PHP 8.1 升到 8.5（比如为未来铺路），别跳过这些实操检查：

• 在 composer.json 中强制锁定平台版本："config": {"platform": {"php": "8.1.0"}}，防止 composer update 意外拉入声称“支持 PHP 8.5”但实际没测试过的包
• 用 phpstan + Magento 扩展扫描全项目：重点盯 Deprecated: Function create_function() is deprecated 和 Dynamic property 相关警告——它们在 PHP 8.5 下不是警告，是崩溃
• 禁用所有非官方模块，只留 Magento 官方模块 + Magento\Framework 核心，再用 bin/magento setup:di:compile 测试能否通过。90% 的失败发生在 DI 编译阶段，而非运行时

替代路径比硬升更现实

与其冒险改 Magento 2 去适配 PHP 8.5，不如把精力放在更可控的升级路径上：

• 确认你用的是 Magento 2.4.6-p3 或更高补丁版本——它们已修复大量 PHP 8.2 兼容性问题，且性能提升明显
• 用 opcache.preload + 合理的 opcache.memory_consumption=512 配合 PHP 8.1/8.2，实际性能差距远小于 PHP 8.5 带来的风险
• 如果真需要 PHP 8.5 的特性（比如 never 返回类型用于自定义 CLI 命令），把这类逻辑抽离成独立服务（Go/Python/Node），通过 API 调用，而非塞进 Magento 主进程

真正卡住升级的从来不是 PHP 版本号本身，而是那些没写在 composer.json 里、却藏在第三方模块 Helper 类里的一行 create_function()。