PHP 8.4迁移致500错误主因是隐性语法与类型冲突，须重点排查已移除函数（如mysql_*、create_function）、__toString()等强制返回string、array_key_exists()参数类型校验、readonly属性硬性限制及反射禁用等高危变更点。
旧项目迁移到 PHP 8.4，光改 php.ini 或换镜像远远不够。真正卡住上线的，往往是那些“看起来能跑、一访问就 500”的隐性语法冲突。关键不是重写全部代码，而是精准识别并修复高危变更点。
必须扫一遍的已移除函数和废弃语法
PHP 8.4 彻底清除了多个长期标记为 deprecated 的功能，调用即 Fatal Error：
- mysql_* 系列函数：包括 mysql_connect、mysql_query 等，全移除。必须替换为 mysqli 或 PDO（推荐 PDO + prepared statement）
-
create_function()：已被完全删除。所有动态函数生成逻辑需改为匿名函数，例如
$func = function($x) { return $x * 2; }; - each() 函数：PHP 7.2 起废弃，8.4 彻底不可用。遍历数组请改用 foreach 或 key()/current() 组合
- call_user_method() 和 call_user_method_array()：早已弃用，应统一使用 call_user_func[_array]()
-
动态调用 final 方法：如
$obj->{'someFinalMethod'}()在 8.4 中直接报错，需检查反射或魔术方法中是否存在此类调用
类型与返回值约束变严格了
PHP 8.4 强化了类型系统一致性，旧代码中“侥幸通过”的松散写法会暴露问题：
PHP 8.5.12
下载
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
-
__toString() 必须返回 string：若方法内只 echo 或抛异常而无 return，会触发 Fatal error。务必补上
return (string)$val; - array_key_exists() 第二个参数必须是数组：传 null、string 或 object 将抛 TypeError，升级前加 is_array() 判断
-
函数返回类型声明不兼容：比如声明
function foo(): int却返回 null 或 false，8.4 默认开启 strict_types=1 时直接中断 - 构造函数参数类型与实际传入不匹配：尤其注意第三方库回调传参，如事件监听器中传入对象但类型声明为 array
只读属性（readonly）行为更硬性
PHP 8.1 引入 readonly，但 8.4 才真正落实“只读”语义——任何绕过构造函数的修改都会失败：
-
构造后赋值直接报错：如
$user->name = 'new';在 readonly 属性上将触发 Cannot modify readonly property -
反射强制写入被禁止：
(new ReflectionProperty($obj, 'name'))->setValue($obj, 'hack');在 8.4 中失效 - 序列化/反序列化保留只读状态：旧版可能绕过，8.4 下 unserialized 对象仍受保护，需确认 DTO 或缓存层逻辑是否依赖运行时修改
用工具自动发现兼容性风险
别靠肉眼 grep，用 PHPCompatibility 静态扫描覆盖全项目：
- 安装：运行
composer require --dev phpcompatibility/php-compatibility:"^10.0.0@dev" - 扫描指定版本：执行
phpcbf --standard=PHPCompatibility --runtime-set testVersion 8.4 ./src - 重点关注 Sniffs 报出的：
PHPCompatibility.Functions.RemovedFunctions、PHPCompatibility.PHP.NewReturnTypeDeclarations、PHPCompatibility.Classes.ReadonlyProperties - 配合 mu-plugin 或临时脚本，在线上环境加
error_reporting(E_ALL | E_STRICT); ini_set('display_errors', '1');暴露运行时 TypeError
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
