PHP 7.1 升级到 8.3 报错主因是 8.3 对语法、行为和错误处理更严格，需分阶段识别根源：先确认真实运行环境（CLI/Web 配置分离）、再检查扩展与依赖兼容性（如 APCu、Redis 版本）、最后修复代码层问题（动态属性、隐式类型转换、废弃函数等）。
PHP 7.1 升级到 8.3 报错，本质不是“版本跳得大”，而是 PHP 8.3 对语法、行为和错误处理的约束远比 7.1 严格得多——很多在 7.1 中静默运行或仅发警告的代码，在 8.3 下直接报 Fatal error 或 TypeError。关键不在“修错”，而在按阶段识别根源、逐层拦截问题。
环境是否真跑在 PHP 8.3 上
报错前先排除“假升级”：CLI 和 Web 服务（Apache/Nginx）使用的是两个独立的 PHP 实例，改了命令行的 php -v 不代表网页也用了 8.3。
- 创建
info.php，内容为<?php phpinfo(); ?>，用浏览器访问，重点核对三处：-
PHP Version：确认是
8.3.x（如8.3.24） -
Loaded Configuration File：路径是否指向你修改的
php.ini -
PHP Extension Build：
TS（线程安全）或NTS（非线程安全）必须与 Web 服务器匹配（如 Apache 通常需 TS，Nginx+PHP-FPM 用 NTS）
-
PHP Version：确认是
- CLI 和 Web 的
php.ini是两个文件：Linux 下分别是/etc/php/8.3/cli/php.ini和/etc/php/8.3/fpm/php.ini；Windows 下 Apache 要检查httpd.conf中LoadModule php_module指向的 DLL 是否为 8.3 版本。
扩展与依赖是否真正就位
PHP 8.3 移除了旧扩展接口，部分扩展必须升级或替换：
-
php-pecl-apcu-bc、php-pecl-mcrypt必须卸载（已彻底废弃） - Redis 扩展需 ≥
5.3.0，GD 需 ≥2.3.0，否则php -m会显示缺失，phpinfo()里看不到模块 - Composer 依赖需重新验证：运行
composer check-platform-reqs，看是否有包声明不支持php: ^8.3 - Yii 2.0.55 等老框架虽属“继承式兼容”，但必须人工验证四项硬指标：核心类加载、DI 容器反射行为、错误处理边界、静态分析兼容性——仅靠
composer.json里"php": ">=8.3"无法保障运行稳定。
代码层典型报错及快速修复方向
PHP 7.1 项目升 8.3，以下几类错误出现频率最高，可优先排查：
立即学习“PHP免费学习笔记（深入）”；
-
动态属性被弃用
报错示例：Deprecated: Creation of dynamic property XXXController::$data is deprecated
原因：PHP 8.2+ 默认禁止给对象动态添加未声明属性
解法：- 在类顶部加
#[\AllowDynamicProperties]（临时兼容） - 更推荐：改用私有数组属性 +
__get/__set，例如：private array $props = []; public function __set($key, $value) { $this->props[$key] = $value; } public function __get($key) { return $this->props[$key] ?? null; }
- 在类顶部加
隐式类型转换触发警告或错误
报错示例：Deprecated: Implicit conversion from float to int loses precision
原因：$t = $arr['sec'] * 100000 + $arr['usec']/10结果是浮点数，再参与位运算& 0x7FFFFFFF会隐式转 int
解法：显式强转，如$t = (int)($arr['sec'] * 100000 + $arr['usec']/10) & 0x7FFFFFFF;-
废弃函数直接移除
each()、create_function()、mysql_*()等在 8.3 中已完全不存在
替换方案：-
each()→ 改用foreach -
create_function()→ 改用匿名函数fn($a, $b) => $a + $b或function($a, $b) { return $a + $b; } -
assert('1==1')（字符串参数）→ 改为assert(1===1)（布尔表达式）
-
-
DI 容器参数类型校验失败
报错示例：Argument 1 passed to SiteController::actionTest() must be an instance of int, string given
原因：Yii 2.0.50 以下版本 DI 容器对无类型提示参数（如$id）仍做反射校验
解法：- 升级框架至
2.0.51+ - 或补全类型提示：
public function actionTest(mixed $id, string $name)
- 升级框架至
不复杂但容易忽略
