PHP 8.5 和 Laravel 兼容，但不是“开箱即用”——Laravel 官方尚未正式声明支持 PHP 8.5（截至 2026 年 3 月），必须手动验证并处理多层兼容性断点。
检查 Laravel 版本是否满足 PHP 8.5 的最低要求
Laravel 本身不直接“支持 PHP 8.5”，而是看它所依赖的底层组件（如 Symfony、Doctrine、monolog）能否在 PHP 8.5 上稳定运行。目前 Laravel 11.x 是唯一可能平稳过渡的版本：
- Laravel
11.x要求php: "^8.2"，已覆盖 PHP 8.5 运行时基础；而10.x只声明支持到^8.1，在 PHP 8.5 下可能出现类型推断异常或扩展加载失败 - Symfony 7.2+（Laravel 11 默认绑定）已明确通过 PHP 8.5 的 CI 测试；Symfony 6.4 在部分联合类型场景下会触发
TypeError - 关键依赖如
doctrine/dbal4.0+、monolog/monolog3.7+ 已适配 PHP 8.5 的never返回类型和交叉类型语法
必须处理的 PHP 8.5 破坏性变更点
这些不是 Laravel 自身报错，而是 PHP 解析器或扩展行为变化导致 Laravel 运行时崩溃或静默失效：
-
create_function()已被彻底移除 → Laravel 9 之前某些第三方包（如旧版barryvdh/laravel-debugbar）若未升级，会在php artisan serve启动时报Fatal error: Uncaught Error: Call to undefined function create_function() -
each()函数废弃 → 少数自定义 Helper 或遗留 Migration 中若使用该函数遍历数组，将直接中断执行 - mysqli 扩展禁用旧式密码协商 → 若项目仍用 MySQL 5.7 且服务端配置了
old_passwords=1，Laravel 的DB::connection()会抛出mysqli_sql_exception，而非连接超时 -
assert()默认不再解析字符串参数 → 某些测试中写法如assert('Auth::check()')将变成空操作，失去断言效果
composer.json 配置与依赖锁定策略
盲目改 "php": "^8.5" 会导致 Composer 解析失败或降级到不兼容包——必须配合平台约束与显式依赖控制：
立即学习“PHP免费学习笔记（深入）”；
- 在
composer.json的config.platform中强制声明目标环境："config": { "platform": { "php": "8.5.0" } }否则composer update可能装入只标称支持 PHP 8.4 的spatie/laravel-ignition2.3.x - 升级前先运行
composer outdated --direct，重点盯住：laravel/framework、symfony/*、doctrine/*、monolog/monolog - 对非官方维护的包（如私有 SDK、老插件），不要依赖
composer update自动适配；应加--with-all-dependencies并逐个验证其源码是否含create_function或each
上线前必须做的三件事
很多团队卡在“能跑”和“真稳”之间，问题往往出在没模拟真实链路：
- 用
php -d opcache.enable=1 -d opcache.jit_buffer_size=256M artisan tinker启动交互终端，手动调用几个高频 Model 方法（如User::first()->posts），观察是否触发 JIT 编译异常或WeakMap内存泄漏 - 在生产镜像中运行
php --ini和php -m，确认opcache、mbstring、json、ctype全部加载，且无mysql（已移除）残留配置干扰mysqli - 回滚方案不能只靠 Git —— 必须提前打包好 PHP 8.4 的完整运行时（含 FPM 配置、OPcache 设置、SSL 模块），因为 PHP 8.5 的二进制不向下兼容，临时切回旧版会因 SAPI 加载失败直接 502
最容易被忽略的是：PHP 8.5 的 str_contains_any() 等新函数不会影响 Laravel，但如果你在 Blade 模板里写了 @php $x = str_contains_any(...) @endphp，而部署机上 PHP 版本未同步更新，就会报 Call to undefined function —— 这类混合写法必须全局 grep 清理。
