PHP 8 存在大量向后不兼容变更，如移除 mysql_* 函数、强化类型系统、禁用隐式转换、新增 ValueError/TypeError 等，需分阶段升级并全面适配代码、扩展及第三方库。
PHP 5 到 PHP 8 的核心兼容性断裂点
PHP 8 不是简单升级，而是有大量**向后不兼容变更**。直接运行旧代码大概率报错或行为异常，尤其 PHP 5.6 或更早项目迁移时，mysql_* 函数、create_function()、隐式转换逻辑等已彻底移除。
-
mysql_connect()、mysql_query()等函数在 PHP 7.0 就被废弃，PHP 8.0 中完全不存在 —— 必须改用PDO或mysqli -
each()、mysql_escape_string()、dl()等已删除，调用即致命错误Fatal error: Uncaught Error: Call to undefined function - PHP 8 强化了类型系统，
json_decode($str, null)第二个参数不能为null（必须是true或false），否则抛TypeError - 数组下标访问空对象（如
$obj['key']）在 PHP 7.x 仅警告，PHP 8.0+ 直接抛TypeError
常见报错与对应修复方式
升级后最常遇到的错误不是语法错，而是语义/行为变更引发的运行时异常。需重点检查：
-
Warning: A non-numeric value encountered→ 多出现在字符串与数字混用场景（如'123abc' + 456），PHP 8 默认禁用隐式转换，应先用is_numeric()或filter_var($val, FILTER_VALIDATE_INT)校验 -
Fatal error: Array and string offset access syntax with curly braces is no longer supported→ 替换所有$str{0}为$str[0] -
Uncaught TypeError: strlen(): Argument #1 ($string) must be of type string, null given→ PHP 8 启用严格类型校验，函数参数不再自动转类型，需显式判断：strlen($str ?? '')或is_string($str) ? strlen($str) : 0 -
Deprecated: Function get_magic_quotes_gpc() is deprecated→ 该函数早在 PHP 7.4 废弃，PHP 8 删除；现代应用不应依赖 magic quotes，应统一使用预处理或htmlspecialchars()输出转义
第三方库与框架的适配门槛
别只盯着自己写的代码 —— 你用的 Composer 包很可能卡在 PHP 7.2 或 7.4。执行 composer update 前务必确认：
- 查看
composer.json中"php": "^7.4"这类约束，需升级为"^8.0"或"^8.1" - 老旧框架如 CodeIgniter 2.x、Zend Framework 1 完全不支持 PHP 8；CI 3.1.11+、Laravel 8+、Symfony 5.4+ 才有稳定 PHP 8 支持
- 扩展依赖要同步检查：比如
mcrypt已被移除，需迁移到openssl；ext-mongo被ext-mongodb替代，API 完全不同 - 运行
composer why-not php:8.2可定位阻塞升级的具体包及其版本限制
平滑迁移的实操步骤建议
跳过 PHP 7 直升 PHP 8 风险极高。推荐分阶段推进，每步验证后再继续：
立即学习“PHP免费学习笔记（深入）”；
- 先将环境升级到 PHP 7.4，并开启
error_reporting = E_ALL | E_STRICT，修复所有Deprecated和Notice级别提示 - 用
php -l批量扫描文件语法，再用phpstan或psalm做静态分析，提前发现类型不匹配、未定义变量等问题 - 关键业务接口加日志捕获
set_error_handler()和set_exception_handler()，记录 PHP 8 新增的TypeError、ValueError实例 - 数据库连接层优先重构：把
mysql_*全部替换为mysqli面向对象写法（如(new mysqli($host, $user, $pass))->query($sql)），避免 PDO 配置陷阱
if (!is_string($input)) {
throw new ValueError('Expected string, got ' . gettype($input));
}
return mb_strtoupper($input);
PHP 8 的 ValueError 和 TypeError 是新异常类型，比传统 Exception 更精确，但老代码若只捕获 Exception 会漏掉它们 —— 这点极易被忽略。
