前言把服务器上的 PHP 从 7.4 或 8.0 换到 8.2重启 FPM刷新页面——然后页面就出了问题。最常见的几种表现页面顶部出现几行Deprecated: ...文字把布局顶乱了接口返回的 JSON 前面多了几行提示前端直接报数据格式错误日志里刷屏Creation of dynamic property X::$y is deprecated某些页面直接 500堆栈指向一行看起来很正常的代码。这批报错其实分两类一类是 8.2 自己的新弃用deprecated另一类是你在 7.4 跳到 8.2 的途中跳过了 8.0 和 8.1 两个大版本的行为变更。后者往往是主要来源因为 8.0 有一批默认值变更和静默失败变抛异常的改动升级跨度越大踩中的越多。本文按先止血、再分类、最后批量修的顺序走先让页面恢复可用再把弃用转成异常找出全部问题点然后给出 8.1/8.2 两张改法对照表和一个自动扫描脚本。一、先止血别让弃用提示进到页面上升级后第一优先级不是立刻改代码而是先让网站能访问同时保证信息不丢。; php.ini —— 生产环境 display_errors Off log_errors On error_log /var/log/php/error.log error_reporting E_ALL关键点是error_reporting E_ALL和display_errors Off同时设置错误照样记录到日志只是不输出到响应里。很多人的做法是把error_reporting调低来消掉报错比如设成E_ALL ~E_DEPRECATED结果问题被藏起来等到 8.3、8.4 把弃用的东西真正移除时网站一夜之间全挂。如果要做到只对接口屏蔽、对页面显示可以在入口文件里按 SAPI 和路由动态处理?php declare(strict_types1); // 入口文件最顶部任何输出之前 $isApi str_starts_with($_SERVER[REQUEST_URI] ?? /, /api/); ini_set(display_errors, $isApi ? 0 : 1); ini_set(log_errors, 1); error_reporting(E_ALL); // 永远记录全部包括 Deprecated二、把弃用警告变成异常一次性找全弃用警告是提醒你以后会坏不是现在坏了。所以升级后真正该做的动作是在预发环境把弃用转成异常用完整的调用栈把每个问题点定位出来。?php declare(strict_types1); /** * 仅在开发/预发环境启用把弃用警告升级为异常带完整堆栈抛出 */ set_error_handler(static function (int $no, string $msg, string $file, int $line): bool { if ($no E_DEPRECATED || $no E_USER_DEPRECATED) { throw new ErrorException($msg, 0, $no, $file, $line); } return false; }); // 随后跑业务代码或单元测试第一个弃用点会直接带着堆栈抛出来ErrorException的构造函数是(string $message, int $code, int $severity, string $filename, int $line, ?Throwable $previous)。把$file和$line传进去异常堆栈里显示的就是真实出错位置而不是set_error_handler那一行——这是这个技巧能用的关键漏传的话堆栈会全部指向错误处理器本身等于白抛。只跑手工点页面效率太低。更可靠的做法是让爬虫或回归测试把整站跑一遍配合上面的处理器一次性收集全部弃用点# 先用语法检查排掉编译期错误再跑业务 find ./src -name *.php -print0 | xargs -0 -n1 php -l三、8.1 与 8.2 的报错对照表从 7.4 直升 8.2 时你会同时撞上 8.0、8.1、8.2 三个版本的变化。下表按报错信息里出现的原话组织方便直接搜。报错信息里的关键短语引入版本改法Passing null to parameter #N of type string8.1 弃用用?? 兜住 null或改成可空类型Creation of dynamic property X::$y is deprecated8.2 弃用声明属性或给类加#[\AllowDynamicProperties]Using ${var} in strings is deprecated8.2 弃用改成{$var}或直接$varFunction utf8_encode() is deprecated8.2 弃用改成mb_convert_encoding()Function strftime() is deprecated8.1 弃用改成date()或IntlDateFormatterFunction strtolower() no longer locale-aware相关行为变化8.2 行为变更不要依赖setlocale()影响大小写Implicit conversion from float to int loses precision8.1 弃用显式(int)或intdiv()/round()Return type of X::y() should either be compatible with ...8.1 起强制补上返回类型或加#[\ReturnTypeWillChange]Cannot write to $GLOBALS相关8.1 弃用不要整体给$GLOBALS赋值X implements Serializable is deprecated8.1 弃用改用__serialize()/__unserialize()Uncaught PDOException老代码没写 try/catch8.0 行为变更默认错误模式改为抛异常Uncaught TypeError老代码传错类型8.0 行为变更严格类型检查传 null 要显式声明围绕这张表有几个必须展开的点。关于动态属性。8.2 之前给一个没声明过属性的对象赋值会自动创建一个动态属性很多老框架和 ORM 就靠这个工作。8.2 起它会发弃用警告。三种处理方式按推荐程度排序?php declare(strict_types1); // 方案一推荐显式声明属性 final class User { public int $id 0; public string $name ; /** var arraystring, mixed */ private array $extra []; // 真正的动态数据放进数组里 } // 方案二整个类允许动态属性适合老代码过渡 #[\AllowDynamicProperties] final class LegacyUser { public function __construct(public string $name) {} } // 方案三只在特定对象上开一个受控的口袋 final class Bag { private array $data []; public function __set(string $name, mixed $value): void { $this-data[$name] $value; } public function __get(string $name): mixed { return $this-data[$name] ?? null; } }注意#[\AllowDynamicProperties]是不可继承的语义陷阱它加在父类上子类也能写动态属性但如果加在子类上父类的实例依然会报弃用。另外它是属性attribute语法上是#[...]和 PHP 7 注释里的无关。关于给内置函数传 null。这是 8.1 升级后日志里数量最多的弃用因为老代码里数据库字段可能是 null直接往下传实在太常见?php declare(strict_types1); $nickname $user[nickname] ?? null; // 可能是 null // ❌ 8.1 起Deprecated: htmlspecialchars(): Passing null to parameter #1 echo htmlspecialchars($nickname); // ✅ 两种改法 echo htmlspecialchars($nickname ?? ); echo htmlspecialchars((string) $nickname);区别在于?? 是null 就当空串(string) $nickname也是空串但后者在值是数组时会发 Warning。推荐?? 语义更明确。关于 8.2 的${}字符串插值。这是一种很少见但确实存在的写法?php declare(strict_types1); $name world; // ❌ 8.2 起弃用Using ${var} in strings is deprecated echo Hello ${name}; // ✅ 正确写法 echo Hello {$name}; echo Hello $name;影响范围包括双引号字符串、heredoc 和 nowdoc。这里有个坑${name}和{$name}在简单变量上结果一样但${$name}可变变量的语义完全不同不能用简单的字符串替换批量改必须逐个看。四、代码实战一个 8.2 升级前的自查脚本下面这个脚本扫描项目目录按正则匹配出最常见的 8.1/8.2 风险写法并给出文件与行号。它是粗筛目的是缩小人工复核范围不替代 PHPStan 这类真正的静态分析工具。最低要求 PHP 8.0用到了str_starts_with和构造器属性提升。?php declare(strict_types1); /** * PHP 8.2 升级粗筛 * 用法: php check82.php /path/to/src */ /** var arraystring, string 规则名 正则 */ const RULES [ 字符串中的 ${var} 插值 /\$\{[a-zA-Z_]/, utf8_encode / utf8_decode /\butf8_(en|de)code\s*\(/, strftime / gmstrftime /\bgm?strftime\s*\(/, create_function8.0 已移除 /\bcreate_function\s*\(/, each()8.0 已移除 /\beach\s*\(/, 花括号字符串下标 $s{0} /\$[a-zA-Z_]\w*\s*\{[^}]*\}\s*(?!)/, implode 反序参数 /\bimplode\s*\(\s*\$[a-zA-Z_]/, FILTER_SANITIZE_STRING /FILTER_SANITIZE_STRING/, Serializable 接口 /implements\s[^{]*\bSerializable\b/, ]; function phpFiles(string $dir): array { $files []; $iterator new RecursiveIteratorIterator( new RecursiveDirectoryIterator($dir, FilesystemIterator::SKIP_DOTS) ); foreach ($iterator as $file) { if ($file-isFile() $file-getExtension() php) { $files[] $file-getPathname(); } } sort($files); return $files; } $dir $argv[1] ?? .; if (!is_dir($dir)) { fwrite(STDERR, 用法: php check82.php 目录\n); exit(1); } $totalHits 0; foreach (phpFiles($dir) as $file) { $lines file($file, FILE_IGNORE_NEW_LINES); if ($lines false) { continue; } foreach ($lines as $i $line) { $trimmed ltrim($line); // 跳过注释行减少噪音 if (str_starts_with($trimmed, //) || str_starts_with($trimmed, *) || str_starts_with($trimmed, #)) { continue; } foreach (RULES as $label $pattern) { if (preg_match($pattern, $line) 1) { printf(%s:%d [%s]\n %s\n, $file, $i 1, $label, trim($line)); $totalHits; } } } } printf(\n共命中 %d 处可疑写法请逐条人工确认。\n, $totalHits);跑完之后配合静态分析工具做精确判定。把目标版本设成 8.2PHPStan 会按 8.2 的函数表检查报出的函数不存在参数类型不匹配都是要改的composer require --dev phpstan/phpstan vendor/bin/phpstan analyse src --level5 --php-version80200至于自动改写Rector 提供了按版本组织的规则集能在保证语义的前提下批量替换掉弃用写法。但自动改写必须跑在版本控制里并且逐条 review diff——尤其是${$name}这类可变变量插值自动工具改错的代价比手工大得多。常见坑点1. 靠调低error_reporting解决报错❌ 错误写法error_reporting E_ALL ~E_DEPRECATED✅ 正确写法保持E_ALL把display_errors关掉让日志保留全部信息。弃用是下个大版本会移除的通知压掉它等于主动放弃升级预警。2.#[\AllowDynamicProperties]加错位置❌ 错误写法只给子类加属性父类实例照样发弃用警告。✅ 正确写法加在真正会被动态赋值的那个类上。另外这个属性不能用在readonly类上两者语义冲突会直接报编译错误。3. 把iterable/array返回类型漏掉导致 8.1 报错❌ 错误写法?php class MyCollection implements IteratorAggregate { public function getIterator() { return new ArrayIterator($this-items); } }✅ 正确写法二选一?php class MyCollection implements IteratorAggregate { // 方案一补上返回类型推荐 public function getIterator(): Traversable { return new ArrayIterator($this-items); } // 方案二过渡期显式声明保留旧签名 #[\ReturnTypeWillChange] public function getIterator() { return new ArrayIterator($this-items); } }8.1 起实现内部接口Iterator、ArrayAccess、Countable、JsonSerializable等的方法如果缺少兼容的返回类型会发出弃用警告。#[\ReturnTypeWillChange]是 8.1 引入的过渡方案但它只是关掉警告在下一个大版本里依然会失效只适合临时用。4.readonly属性在__clone里改不动❌ 错误写法?php final class Money { public function __construct(public readonly int $amount) {} public function __clone() { $this-amount 0; } // 8.3 之前会报错 }✅ 正确写法不要在这类对象上做克隆后修改的设计改用构造新实例的方式。readonly属性8.1 引入一旦初始化就不能再写在__clone()里也一样。8.3 才允许在__clone()中重新初始化readonly属性。如果你在 8.2 上打算靠克隆来复制并微调这条路走不通。5. 用strtolower()处理中文或依赖语言环境❌ 错误写法?php setlocale(LC_CTYPE, tr_TR.UTF-8); $lower strtolower($text); // 8.2 起不再受 locale 影响✅ 正确写法大小写转换本来就应该与语言环境无关需要按语言规则转换时用mb_strtolower($text, UTF-8)。8.2 起strtolower()等函数变成纯 ASCII 语义土耳其语的I/ı特例不再生效——从不确定变成确定行为更容易预测了但依赖旧行为的代码需要检查。6. 枚举被json_encode后变成{}或报错❌ 错误写法?php enum Status { case Active; case Banned; } // 无 backing type echo json_encode(Status::Active); // 无法序列化✅ 正确写法?php enum Status: string { case Active active; case Banned banned; } echo json_encode(Status::Active); // active —— backed enum 序列化为它的值json_encode()对backed enum有标量 backing type 的枚举会输出它的值对纯枚举pure enum没有定义默认序列化会失败。升级时如果发现接口字段突然空了先看看这里。7.new出现在参数默认值里被忽略8.1 起允许在参数默认值、静态变量初始化器、常量、属性参数里写new表达式。但要注意参数默认值里的new每次调用都会重新求值不是只求一次。如果你把它当成单例用会得到一堆不同的对象。总结阶段动作关键点止血关display_errors保log_errors不要调低error_reporting定位弃用转异常拿完整堆栈ErrorException必须传$file/$line分类对照 8.1 / 8.2 报错表区分弃用与行为变更批量修静态分析 Rector目标版本设成 80200逐条 review防回归灰度和回归测试用爬虫把整站跑一遍收集警告升级到 PHP 8.2 后的报错绝大多数不是新版本坏了而是老代码里长期存在的隐性问题被新版本用更严格的方式表达了出来传 null、写动态属性、类型不匹配、实现接口却不声明返回类型。正确的处理顺序是先让错误可见、再让它可定位、最后才动手改而不是一上来就把报错关掉。这样升级一次之后等到 8.3、8.4 时你就不会重新经历一遍同样的过程。