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,不如把精力放在更可控的升级路径上:
立即学习“PHP免费学习笔记(深入)”;
- 确认你用的是
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()。











