罗罗编程学习记录
本页内容 展开查看

04.5.2.13 弃用项与安全行为变更

所属:全栈开发面试题库 / 04 后端语言与运行时 / 04.5 PHP / 04.5.2 PHP 新版本特性与运行时演进

04.5.2.13-001 什么是弃用(deprecation)?告警与移除是什么节奏?

一句话结论

弃用表示某接口、语法或行为在当前版本仍可用,但已不推荐使用并发出告警;后续版本可能在小版本中继续告警,在更远版本中移除。升级时应先清理弃用告警,再进入可能移除该接口的版本。

概念解释

弃用是兼容性缓冲机制:给迁移留出周期,避免直接移除造成大面积破坏。告警级别通常为 E_DEPRECATED(引擎/内部函数)或 E_USER_DEPRECATED(库与框架主动触发)。从告警到移除的间隔没有统一固定版本,需对照各版本迁移指南。

原理流程

  1. 目标接口被标记弃用,调用时产生 deprecation 告警。
  2. 迁移期内代码改用替代方案,告警逐步清零。
  3. 后续版本移除旧接口,未迁移代码触发致命错误或解析错误。

代码或图示

// 弃用告警在错误处理器中的识别与记录
$deprecations = [];
set_error_handler(function (int $errno, string $errstr) use (&$deprecations): bool {
    if ($errno === E_DEPRECATED || $errno === E_USER_DEPRECATED) {
        $deprecations[] = $errstr;
    }
    return true;
});

// 库主动触发弃用提示的典型写法(示例,非真实废弃函数)
function legacyHelper(): void {
    trigger_error('legacyHelper is deprecated, use newHelper instead', E_USER_DEPRECATED);
}

legacyHelper();
restore_error_handler();
echo 'collected: ', count($deprecations), PHP_EOL;

常见误区

  • 以为弃用接口当前报错:当前版本通常只是告警,真正阻断发生在移除版本。
  • 忽略告警直到大版本升级:累积的弃用点会集中暴露,迁移成本升高。

追问

  • 弃用告警默认显示吗?答:取决于 error_reporting 与显示配置;生产环境可能被隐藏,需要主动收集。
  • 如何查某接口的弃用版本与替代方案?答:对照目标版本迁移指南与函数手册说明;本机探针只能确认函数是否存在,不能判断弃用状态。

04.5.2.13-002 PHP 8.0 主要有哪些弃用与移除方向?

一句话结论

8.0 作为大版本,移除了一批历史遗留接口与语法,并收紧类型比较与内部函数校验;具体移除清单以 8.0 迁移指南为准,本页只归纳方向,不重复 04.5.2.1 已展开的语法特性。

概念解释

8.0 的破坏性变化集中在:旧语法移除、类型比较规则收紧、部分内部函数参数与返回行为改变、错误从告警向 Error 迁移。升级到 8.0 的代码不能只跑语法检查,需要回归行为边界用例。

原理流程

  1. 对照 8.0 迁移指南的移除与不兼容章节。
  2. 检索源码中被移除的函数、常量与语法。
  3. 对行为变更路径补充测试用例后再切换运行时。

代码或图示

// 8.0 收紧方向示例:类型比较与绑定期校验更严格
function acceptNumber(int $value): int {
    return $value;
}

try {
    acceptNumber('10'); // 严格模式下类型不匹配的行为以引擎与 strict_types 为准
} catch (TypeError $e) {
    echo 'TypeError: ', $e->getMessage(), PHP_EOL;
}

// 核对清单:移除函数、移除语法、比较规则、内部函数签名、错误通道
$checklist = ['removed-functions', 'removed-syntax', 'comparison-rules', 'internal-signatures'];
echo implode(', ', $checklist), PHP_EOL;

常见误区

  • 把 8.1 之后的弃用项记到 8.0:版本归属必须逐版对照迁移指南。
  • 以为大版本升级只是换解释器:行为收紧同样需要代码适配。

追问

  • 8.0 移除了哪些历史扩展/函数族?答:以官方迁移指南移除清单为准;本项目不凭记忆列举具体函数名。
  • 弱类型代码升级 8.0 风险在哪?答:隐式转换与松散比较结果变化,需要补类型声明与边界测试。

04.5.2.13-003 PHP 8.1 主要弃用项需要关注什么?

一句话结论

8.1 在新特性之外引入了一批面向未来移除的弃用提示,具体条目见 04.5.2.2-020 与官方迁移指南;升级到 8.1 时应收集 deprecation 列表,作为向后续版本迁移的输入。

概念解释

8.1 的弃用多为逐步收紧类型与历史 API 的缓冲提示。本页不重复枚举各版本细节,重点是掌握收集方法与迁移流程:先在测试环境暴露告警,按调用点归类,再逐个替换。

原理流程

  1. 在 8.1 环境跑测试套件,收集 deprecation 告警。
  2. 按消息与调用位置聚类,区分引擎弃用与库弃用。
  3. 对照替代方案改造代码,复测告警减少。

代码或图示

// 按消息聚类的弃用清单骨架
$groups = [];
set_error_handler(function (int $errno, string $errstr, string $errfile, int $errline) use (&$groups): bool {
    if ($errno === E_DEPRECATED || $errno === E_USER_DEPRECATED) {
        $key = $errstr;
        $groups[$key][] = $errfile . ':' . $errline;
    }
    return true;
});

// 业务调用点在此期间执行(示例省略)
restore_error_handler();

foreach ($groups as $message => $locations) {
    echo $message, ' -> ', count($locations), ' sites', PHP_EOL;
}

常见误区

  • 把 8.1 告警当作可忽略噪音:后续版本移除时未迁移代码会被阻断。
  • 只统计告警数量不记录位置:无法定位改造点。

追问

  • 8.1 弃用项在哪个版本移除?答:以后续版本迁移指南的移除记录为准,不按固定间隔推断。
  • 框架触发的 E_USER_DEPRECATED 怎么处理?答:先升级框架到修复版本;仍存在则按框架指引改造调用点。

04.5.2.13-004 动态属性弃用与 #[AllowDynamicProperties] 的边界是什么?

一句话结论

8.2 起给未声明类动态赋值属性产生弃用告警;需要保留动态行为的类可标注 #[AllowDynamicProperties],新代码应显式声明属性或使用 stdClass/数组结构。该题目的细节已在 04.5.2.3-012、04.5.2.3-013 展开,本页只做升级视角的归纳。

概念解释

动态属性问题源于 PHP 历史上允许对象挂任意属性,拼写错误的属性名不会被发现。弃用推动代码显式声明属性;过渡标注只是缓冲,不能作为长期方案。升级排查时重点找 $obj->unknown = ... 写法。

原理流程

  1. 扫描运行期动态赋值的类与调用点。
  2. 能显式声明属性的补类型声明;确需动态结构的评估标注豁免。
  3. 新代码不引入动态属性依赖。

代码或图示

#[AllowDynamicProperties]
class TransitionalModel {
    public int $id;
}

$model = new TransitionalModel();
$model->id = 1;
// $model->nickname = 'x'; // 动态属性:当前版本告警,未来行为收紧

// 新代码方向:显式声明或用数组/值对象承载可变结构
class ExplicitModel {
    public function __construct(public int $id, public ?string $nickname = null) {}
}

常见误区

  • 给整个继承体系批量加豁免标注:掩盖了未声明属性的设计问题。
  • 以为动态属性在 8.2 直接报错:当前阶段为告警,移除节奏以后续版本指南为准。

追问

  • 内部类(如标准库对象)也受影响吗?答:部分内置类已按自身设计处理;具体行为以手册与本机实测为准。
  • 动态属性拼写错误如何在升级前发现?答:静态分析与运行期告警结合;测试覆盖属性赋值路径。

04.5.2.13-005 隐式可空参数弃用的迁移要点是什么?

一句话结论

参数类型声明了类型但未写 null、默认值为 null 的“隐式可空”写法在 8.4 弃用;迁移方向是把签名显式写成 ?T 或 T|null。细节见 04.5.2.5-013、04.5.2.5-014,本页归纳升级排查动作。

概念解释

旧写法形如 function f(string $x = null),类型上隐含可空;新签名要求显式表达可空。这类问题分布在函数与方法签名上,静态分析与编译器告警可批量定位,改造是机械性的类型补全。

原理流程

  1. 检索“带类型声明、默认 null、未写可空”的签名。
  2. 把参数类型改为 ?T 或 T|null。
  3. 检查调用方是否仍可能传 null,补充类型边界测试。

代码或图示

// 旧式:隐式可空(当前版本弃用告警)
// function oldMethod(string $name = null): string { return $name ?? 'anonymous'; }

// 新式:显式可空
function newMethod(?string $name): string {
    return $name ?? 'anonymous';
}

echo newMethod(null), PHP_EOL;

常见误区

  • 只改签名不复查调用方:传 null 的路径需要明确是否合法。
  • 把 ?T 与 T|null 混用在同一体系:选择一种风格保持一致。

追问

  • 返回值有类似隐式可空问题吗?答:返回类型可空性按声明规则检查;具体弃用条目以迁移指南为准。
  • 升级 8.4 前这类告警必须清零吗?答:当前版本为告警;计划继续升级时应先清零,避免累积到移除版本。

04.5.2.13-006 8.3 与 8.5 还有哪些需要列入升级清单的弃用项?

一句话结论

8.3、8.5 各自的弃用条目见 04.5.2.4-017、04.5.2.6-012;清单维护原则是:按目标版本迁移指南逐条核对,结合本机探针与测试告警,不凭记忆罗列函数名。

概念解释

每个版本的弃用可能覆盖内部函数参数、旧行为兼容层、遗留语法特性。升级清单应按“目标版本”分节:从当前版本到目标版本经过的每一跳,各自列出需要处理的条目。

原理流程

  1. 确定当前版本与目标版本之间经过的版本列表。
  2. 逐版阅读迁移指南的弃用与移除章节。
  3. 在代码库中检索对应调用点,登记到升级清单。

代码或图示

// 按版本分节的弃用清单骨架
$deprecationByVersion = [
    '8.3' => [],
    '8.4' => [],
    '8.5' => [],
];

foreach ($deprecationByVersion as $version => $items) {
    echo $version, ': ', count($items), ' tracked items', PHP_EOL;
}

// 核对手段:迁移指南、函数手册、测试环境告警、本机 function_exists 探针
echo 'runtime: ', PHP_VERSION, PHP_EOL;

常见误区

  • 只看目标版本指南,跳过中间版本:累积的弃用项可能在中间版本已被移除。
  • 把未在本机验证的条目写成确定结论:不确定项标注待确认。

追问

  • 如何确认某函数在目标版本是否被移除?答:手册查看函数版本状态,探针在目标环境 function_exists 复核。
  • 库代码的弃用项算项目清单吗?答:计入依赖升级项;项目业务代码只负责调用适配。

04.5.2.13-007 安全相关的默认行为收紧有哪些典型方向?

一句话结论

安全收紧的典型方向包括:反序列化白名单限制、类型与参数校验强化、敏感信息回溯脱敏、内部函数对非法入参更早失败、输入相关函数的边界行为明确化;具体条目以各版本迁移指南安全章节为准。

概念解释

收紧的共同思路是“失败更早、暴露更少”:减少静默错误与宽松转换,限制对象注入面,避免敏感值随日志外泄。升级时安全行为变化可能改变既有容错路径,需要回归依赖宽松行为的代码。

原理流程

  1. 梳理项目中的反序列化、外部输入处理、鉴权与日志记录路径。
  2. 对照版本安全变更核对行为差异。
  3. 对依赖旧宽松行为的写法改造,补充安全测试用例。

代码或图示

// 反序列化白名单方向:限制可重建的类(细节见 04.5.2.4-010、04.5.2.4-019)
$data = 'a:1:{s:3:"foo";s:3:"bar";}';
$allowed = ['stdClass'];
$object = unserialize($data, ['allowed_classes' => $allowed]);
echo get_class($object), PHP_EOL;

// 敏感参数标注方向(细节见 04.5.2.3-008)
function authenticate(string $login, #[SensitiveParameter] string $secret): bool {
    return $secret !== '';
}

常见误区

  • 以为安全收紧只影响新代码:既有容错路径也可能因校验提前而改变结果。
  • 升级后沿用旧的反序列化宽松配置:对象注入面未被收敛。

追问

  • 密码哈希相关函数有变化吗?答:以手册中密码哈希扩展文档为准;本页不凭记忆列函数参数。
  • 安全收紧导致旧功能报错怎么办?答:先判断旧行为是否本身不安全;不能为了恢复旧行为关闭安全校验,应改造输入处理。

04.5.2.13-008 unserialize 白名单行为变化如何影响既有代码?

一句话结论

unserialize() 的 allowed_classes 控制反序列化可重建的对象类型;默认行为与历史兼容参数在版本演进中逐步收紧,宽松允许任意类会扩大对象注入风险。细节已在 04.5.2.4 展开,本页从升级排查角度归纳。

概念解释

反序列化不可信数据是经典注入入口:攻击者构造序列化字符串触发魔术方法链。升级排查时检查所有 unserialize 调用,确认白名单是否显式限定;无法避免反序列化时,优先改用 JSON 等数据格式。

原理流程

  1. 检索代码库中的 unserialize 调用点。
  2. 核对 allowed_classes 配置:是否限定已知类或关闭对象重建。
  3. 评估数据来源可信度,不可信来源改为安全格式传输。

代码或图示

// 限定白名单:只重建明确允许的类型
function safeRestore(string $payload, array $allowedClasses): ?object {
    return unserialize($payload, ['allowed_classes' => $allowedClasses]);
}

// 关闭对象重建:仅恢复标量与数组结构
$plain = unserialize($payload ?? '', ['allowed_classes' => false]);
echo is_array($plain) ? 'array restored' : 'other', PHP_EOL;

常见误区

  • 把 allowed_classes 设为 true 或省略却宣称安全:未限定类即保留对象注入面。
  • 反序列化缓存数据忽略来源:缓存被污染时同样可触发问题。

追问

  • 白名单类自身有魔术方法风险吗?答:有,白名单类的 __wakeup、__destruct 等仍需审查;对象注入防护是多层措施。
  • 历史兼容参数行为以什么为准?答:以当前版本手册参数说明与本机探针为准,不沿用旧版本文档记忆。

04.5.2.13-009 弃用告警如何在开发与测试环境收集?

一句话结论

收集方式:注册错误处理器过滤 deprecation 级别,记录消息、文件、行号与调用栈摘要;测试环境全量跑用例后聚类去重,形成待迁移清单,而不是依赖页面显示或日志偶然可见。

概念解释

告警可能来自业务代码、框架、依赖库三个层级。收集时保留触发位置,便于区分是项目改造还是升级依赖可解决。CI 中可对新增弃用计数设阈值,防止迁移后再次引入。

原理流程

  1. 应用启动期注册 deprecation 收集处理器。
  2. 测试套件执行期间累计告警条目。
  3. 结束后按消息聚类输出清单,关联到代码模块。

代码或图示

class DeprecationCollector {
    /** @var array<int, array{message:string, file:string, line:int}> */
    private array $items = [];

    public function handler(int $errno, string $errstr, string $errfile, int $errline): bool {
        if ($errno === E_DEPRECATED || $errno === E_USER_DEPRECATED) {
            $this->items[] = ['message' => $errstr, 'file' => $errfile, 'line' => $errline];
        }
        return true;
    }

    /** @return array<int, array{message:string, file:string, line:int}> */
    public function items(): array {
        return $this->items;
    }
}

$collector = new DeprecationCollector();
set_error_handler($collector->handler(...));
restore_error_handler();
echo 'collected: ', count($collector->items()), PHP_EOL;

常见误区

  • 只看 Web 响应页面的告警输出:CLI、定时任务与测试路径的告警被漏掉。
  • 收集后不聚类:重复噪音淹没真实改造点。

追问

  • 处理器中能否直接把弃用升级为失败?答:可以在 CI 模式下计数或抛异常阻断;生产环境应记录而非中断请求。
  • 框架内部告警如何过滤?答:按文件路径与消息归属区分框架代码与业务代码,分别登记处理方。

04.5.2.13-010 弃用告警的抑制手段有哪些风险?

一句话结论

抑制手段包括错误控制符 @、调整 error_reporting、错误处理器过滤;风险是掩盖真实迁移需求,让弃用点在后续版本变成阻断错误。抑制只能作为临时过渡,必须登记并限期替换。

概念解释

@ 抑制当前表达式的错误报告;error_reporting 调整影响全局可见性;处理器过滤在代码层面丢弃告警。三者都不修复根因。过渡期抑制应附带注释与跟踪条目,避免长期存在。

原理流程

  1. 确认告警来源与替代方案。
  2. 短期无法改造时,在最小作用域内抑制并登记。
  3. 排期完成替代改造后移除抑制,复测告警清零。

代码或图示

// 临时抑制示例:注释说明原因与替代计划(实际项目中不保留长期 @)
$value = @legacyTransform($input);

// 处理器按白名单过滤示例:只放行已登记的过渡项
$knownPending = ['legacyTransform'];
set_error_handler(function (int $errno, string $errstr) use ($knownPending): bool {
    foreach ($knownPending as $keyword) {
        if (str_contains($errstr, $keyword)) {
            return true; // 已登记过渡项,记录后放行
        }
    }
    return false;
});

function legacyTransform(string $input): string {
    return trim($input);
}
restore_error_handler();

常见误区

  • 在全局配置里关掉 deprecation 级别:所有弃用点被隐藏,升级风险不可见。
  • 抑制项无注释无清单:后续无人清理,技术债固化。

追问

  • @ 能抑制致命错误吗?答:不能,致命错误不受错误控制符影响;抑制范围限于可报告告警级别。
  • 静态分析能发现被抑制的弃用调用吗?答:部分规则可识别废弃函数调用;具体能力按所选分析工具为准(待确认)。

04.5.2.13-011 替代方案迁移表如何建立?

一句话结论

迁移表按“旧写法/旧接口 → 替代写法/接口 → 引入版本 → 迁移状态 → 备注”组织,每个弃用点一行;表与代码清单对应,升级时按表逐项关闭。

概念解释

迁移表把零散告警转化为可跟踪的改造任务。字段包含:旧接口名、替代接口、版本依据(迁移指南条目)、调用位置、负责模块、状态。状态分为未开始、改造中、已完成、待确认。

原理流程

  1. 从告警收集与指南核对中提取旧接口清单。
  2. 为每项查替代方案与版本依据。
  3. 登记调用位置与状态,改造完成后复测移除告警。

代码或图示

// 迁移表数据结构示意(表格内容按项目实际填写)
$migrationTable = [
    [
        'legacy' => 'legacyHelper',
        'replacement' => 'newHelper',
        'since' => '8.x 迁移指南条目',
        'sites' => ['src/Old/Service.php'],
        'status' => '未开始',
    ],
];

foreach ($migrationTable as $row) {
    echo $row['legacy'], ' -> ', $row['replacement'], ' [', $row['status'], ']', PHP_EOL;
}

常见误区

  • 迁移表只记函数名不记调用位置:改造时需要重新检索。
  • 替代方案不写版本依据:后续核对无法判断结论来源。

追问

  • 没有直接替代接口的弃用项怎么办?答:在备注中说明设计替代(重构、抽适配层),状态标记待确认并评审。
  • 迁移表谁维护?答:业务代码 owner 登记调用点,架构/平台核对替代方案与版本依据。

04.5.2.13-012 升级阻断点排查流程是什么?

一句话结论

先清弃用告警,再处理致命不兼容:语法解析错误、被移除函数/类、缺失扩展与不兼容依赖按阻断级排序;每修复一类跑一次扫描与测试,避免多类问题混在一起归因。

概念解释

阻断点是“升级后无法启动或核心链路必现失败”的问题。排查顺序:语法层 php -l → 函数/类/扩展存在性探针 → 依赖约束 → 行为回归。告警类问题不阻断当前版本,但必须在进入下一版本前处理。

原理流程

  1. 语法层:全量 php -l,排除解析错误。
  2. 存在性层:探针核对被调用函数、类、扩展。
  3. 行为层:测试套件回归,记录与旧版本结果不一致的用例。

代码或图示

// 阻断点分级清单
$blockers = [
    'syntax' => '解析失败,升级后无法编译',
    'removed-symbol' => '调用已移除的函数/类/常量',
    'missing-extension' => '目标环境未加载所需扩展',
    'incompatible-dependency' => '依赖库不支持目标 PHP 版本',
    'behavior-regression' => '合法写法结果与旧版本不一致',
];

foreach ($blockers as $level => $desc) {
    echo $level, ': ', $desc, PHP_EOL;
}

// 探针:核对符号存在性
echo 'str_contains: ', function_exists('str_contains') ? 'ok' : 'missing', PHP_EOL;

常见误区

  • 跳过告警直接排查致命错误:累积弃用在移除版本集中爆发,应提前清零。
  • 阻断点不分级:先改低风险行为差异,忽略启动级缺失扩展。

追问

  • 如何批量找被移除函数调用?答:对照迁移指南移除清单在源码检索函数名;静态分析规则可辅助识别(工具能力待确认)。
  • 行为回归怎么判定差异?答:保留旧版本测试基线输出,新版本同用例对比;边界用例(类型转换、空值、字符串比较)重点覆盖。

04.5.2.13-013 典型被替代函数族如何对照?

一句话结论

历史函数族的替代方向通常是:字符串/正则使用现代扩展函数,数据库访问使用现代驱动与抽象层;具体到 8.x 版本仍可调用的函数,必须以手册存在性探针为准,不在文档中凭记忆列废弃函数名。

概念解释

函数替代关系跨多个 PHP 大版本形成,早期移除项不属于本章节 8.0–8.5 增量范围。面试回答应聚焦方法:查手册版本状态、查迁移指南替代说明、用探针核对存在性,而不是背诵旧函数名清单。

原理流程

  1. 在手册中查旧函数的状态与推荐替代。
  2. 探针确认目标环境函数是否存在。
  3. 按替代方案改造调用点,补充返回值与错误处理测试。

代码或图示

// 核对函数状态的通用探针
function checkFunctions(array $names): array {
    $report = [];
    foreach ($names as $name) {
        $report[$name] = function_exists($name);
    }
    return $report;
}

// 示例清单按项目实际调用填写;不在本页枚举历史废弃函数名
$report = checkFunctions(['str_contains', 'trim', 'json_encode']);
echo json_encode($report), PHP_EOL;

常见误区

  • 把跨大版本历史遗留当成 8.x 新增弃用:版本归属混淆会误导升级判断。
  • 凭印象写替代函数名:手册与探针双重核对后再落文档。

追问

  • 正则新旧扩展如何选型?答:以手册推荐与维护状态为准;项目内统一一种现代扩展,避免混用。
  • 数据库驱动迁移注意什么?答:连接参数、错误模式、类型绑定与返回格式都需回归,不只是换函数名。

04.5.2.13-014 行为变更(非移除)如何识别?

一句话结论

行为变更指接口名称保留但参数校验、返回值、类型比较或错误通道发生变化;识别方式是对照迁移指南行为章节,结合边界用例在新旧版本对比输出。

概念解释

与移除类问题不同,行为变更不会触发“函数不存在”,而是同样的输入产生不同结果或走不同错误通道。典型场景:松散比较规则、内部函数非法入参的失败方式、字符串与数字转换、错误从告警变为异常。

原理流程

  1. 阅读迁移指南的行为变更与不兼容章节。
  2. 为受影响路径准备边界用例:空值、类型混合、非法格式、极值。
  3. 新旧版本分别执行,对比返回值、告警与异常类型。

代码或图示

// 边界用例骨架:覆盖类型混合与空值路径
$cases = [
    ['input' => 0, 'expect' => 'int-zero'],
    ['input' => '0', 'expect' => 'string-zero'],
    ['input' => '', 'expect' => 'empty-string'],
    ['input' => null, 'expect' => 'null'],
];

foreach ($cases as $case) {
    echo var_export($case['input'], true), ' => ', gettype($case['input']), PHP_EOL;
}

// 对比维度:返回值、类型、告警级别、异常类别
$dimensions = ['return-value', 'return-type', 'warning-level', 'exception-class'];
echo implode(', ', $dimensions), PHP_EOL;

常见误区

  • 只跑正常路径测试:行为差异集中在边界与非法输入。
  • 把行为差异误判为代码 bug:先确认是否为引擎有意收紧。

追问

  • 类型比较规则变化影响哪些写法?答:松散比较、数组比较、字符串数字转换相关判断;具体规则以手册类型比较章节为准。
  • 行为变更需要改代码还是改测试?答:旧宽松依赖应改造;业务结果本就要求严格的,补充测试固化新行为。

04.5.2.13-015 第三方库触发的弃用告警如何处理?

一句话结论

优先升级库到兼容版本;库尚未修复时,评估补丁、隔离调用边界或在清单中标注阻塞;不能通过抑制项目告警来掩盖库层面的升级需求。

概念解释

依赖库可能使用了项目 PHP 版本已弃用的内部行为。处理顺序:查库更新日志是否有兼容新版的版本 → 升级库 → 复测;库长期未维护则评估替换或自维护补丁,并在升级清单中登记风险。

原理流程

  1. 从告警位置判断属于业务代码还是 vendor 目录。
  2. 查库的版本约束与更新记录,升级到修复版本。
  3. 无修复方案时记录风险与替代计划,纳入后续升级阻断评估。

代码或图示

// 告警归属判定骨架
function classifySource(string $file, string $vendorDir): string {
    return str_contains($file, $vendorDir) ? 'dependency' : 'project';
}

$alerts = [
    ['file' => 'vendor/old-lib/Parser.php', 'message' => 'deprecated call'],
    ['file' => 'src/Service/Order.php', 'message' => 'deprecated call'],
];

foreach ($alerts as $alert) {
    echo classifySource($alert['file'], 'vendor'), PHP_EOL;
}

常见误区

  • 直接改 vendor 目录源码:升级库时补丁被覆盖,且未走依赖维护流程。
  • 库告警不跟踪:最终升级 PHP 版本时被库兼容性阻断。

追问

  • 库升级引入新依赖怎么办?答:按依赖树重新核对版本约束与兼容性,避免连锁升级超出控制范围。
  • 如何确认库已声明兼容目标 PHP?答:查看库 Composer 约束与更新日志;必要时在目标环境集成测试验证。

04.5.2.13-016 弃用项如何被静态分析识别?

一句话结论

静态分析规则可标注废弃函数/方法并报告调用点;识别覆盖范围取决于规则库对版本的支持,本机未安装分析工具,具体规则与版本覆盖标注待确认。

概念解释

分析工具通常维护符号废弃信息:手册文档、注解或规则库标记废弃状态,扫描调用点时报告。相比运行期告警,静态分析可在不执行代码的情况下发现未被测试覆盖的调用点,两者互补。

原理流程

  1. 分析工具加载目标 PHP 版本的废弃符号信息。
  2. 扫描源码调用点,匹配废弃函数、方法与常量。
  3. 报告位置与替代建议,纳入迁移清单。

代码或图示

// 代码侧配合:新代码不调用已确认废弃的接口
class OrderService {
    public function __construct(private OrderRepository $repo) {}

    public function find(int $id): ?Order {
        return $this->repo->find($id);
    }
}

// 静态分析报告的常见字段:规则标识、符号名、位置、替代建议
$reportFields = ['identifier', 'symbol', 'file', 'line', 'replacement'];
echo implode(', ', $reportFields), PHP_EOL;

常见误区

  • 以为静态分析覆盖所有弃用类型:语法、行为类弃用未必有规则覆盖,仍需迁移指南核对。
  • 工具版本过旧识别不到新弃用项:分析工具需跟随 PHP 版本更新。

追问

  • 项目自定义废弃函数如何被识别?答:通过标注或分析工具的废弃注解约定;具体语法以工具文档为准(待确认)。
  • 静态报告与运行告警冲突时以谁为准?答:以当前版本运行期行为与官方手册为准,分析报告作为辅助线索。

04.5.2.13-017 配置项与 INI 默认值变更如何核对?

一句话结论

升级不仅换代码,还要核对 php.ini 与运行时配置:已移除的配置项、默认值变化、扩展专属设置都可能影响行为;核对方式是对比新旧环境配置并对照迁移指南配置章节。

概念解释

部分行为由 INI 配置控制(错误报告、内存、OPcache、扩展开关等)。新版本默认值可能收紧或调整;沿用旧配置文件不代表行为与旧版本一致。升级清单应包含配置项对比与生效验证。

原理流程

  1. 导出新旧环境的有效配置(加载文件、关键项当前值)。
  2. 对照迁移指南核对移除项与默认值变化。
  3. 在目标环境验证关键配置生效,记录差异项。

代码或图示

// 配置探针:读取当前运行时关键项(函数与键名以手册为准)
$iniKeys = ['error_reporting', 'memory_limit', 'display_errors', 'opcache.enable'];
foreach ($iniKeys as $key) {
    echo $key, ' = ', ini_get($key), PHP_EOL;
}

// 配置核对清单:移除项、默认值变化、扩展开关、路径与权限
$configChecks = ['removed-ini', 'default-change', 'extension-switch', 'path-permission'];
echo implode(', ', $configChecks), PHP_EOL;

常见误区

  • 直接复制旧 php.ini 到新版本:已移除项可能被忽略,默认值差异未被发现。
  • 只核对 CLI 配置忽略 FPM/常驻配置:不同 SAPI 加载的配置文件可能不同。

追问

  • 如何查看配置来自哪个文件?答:使用 php --ini 或运行时配置信息输出;具体命令按 SAPI 文档为准。
  • OPcache 配置变化影响什么?答:缓存策略、时间戳校验、JIT 相关项;见 04.5.2.8 与 04.5.2.15。

04.5.2.13-018 安全收紧导致既有行为失败如何定位与修复?

一句话结论

定位路径:先区分是类型校验失败、反序列化拒绝、敏感信息拦截还是输入过滤收紧;修复方向是改造输入与调用方式,而不是回退安全配置;修复后补充对应安全测试用例。

概念解释

安全收紧后的失败往往表现为 TypeError、反序列化异常、更早拒绝非法格式。定位时记录异常类别、消息、输入样本与调用链;判断旧行为是否本身不安全,再决定改造方案。

原理流程

  1. 捕获失败:异常类别、消息、输入摘要、调用位置。
  2. 对照版本安全变更确认收紧点。
  3. 改造代码:显式校验输入、限定白名单、收敛敏感暴露;补测试固化。

代码或图示

function handleInput(mixed $raw): array {
    if (!is_array($raw)) {
        throw new InvalidArgumentException('payload must be array');
    }
    $clean = [];
    foreach ($raw as $key => $value) {
        if (is_string($key) && is_scalar($value)) {
            $clean[$key] = $value;
        }
    }
    return $clean;
}

try {
    handleInput('not-an-array');
} catch (InvalidArgumentException $e) {
    echo 'rejected: ', $e->getMessage(), PHP_EOL;
}

常见误区

  • 通过放宽类型、关闭校验来恢复旧行为:安全风险被重新引入。
  • 修复后不补测试:同类非法输入再次进入时无法提前发现。

追问

  • 旧业务依赖宽松类型转换怎么办?答:在边界显式转换并校验,内部保持严格类型;不要依赖引擎隐式转换兜底。
  • 安全测试用例覆盖什么?答:非法类型、越界取值、注入样本、敏感字段不出现在日志回溯中。

04.5.2.13-019 为什么弃用告警清零应作为升级前置条件?

一句话结论

弃用接口在后续版本会被移除,未清零的告警点就是下一轮升级的阻断点;提前清零让每次版本升级只面对新增变更,而不是累积多个版本的历史债务。

概念解释

升级成本随弃用累积放大:告警分散在多处代码、依赖与配置中,集中排查时理解成本高。把“弃用清零”作为进入下一版本的门禁,使升级路径保持线性:每跳版本处理当批变更。

原理流程

  1. 当前版本环境收集全部弃用告警。
  2. 按迁移表改造,复测告警归零。
  3. 再启动向目标版本的兼容性扫描与灰度。

代码或图示

// 升级门禁顺序示意
$gates = [
    'collect-deprecations' => '收集并聚类告警',
    'migrate-sites' => '按迁移表改造',
    'regress' => '测试套件复测',
    'scan-target' => '目标版本兼容性扫描',
];

foreach ($gates as $gate => $note) {
    echo $gate, ': ', $note, PHP_EOL;
}

// 门禁判定:新增弃用计数为 0 才进入下一阶段
$pendingCount = 0;
echo 'gate passed: ', $pendingCount === 0 ? 'yes' : 'no', PHP_EOL;

常见误区

  • 认为“能跑就行”暂时不迁:移除版本到来时改造时间被压缩。
  • 只清业务代码告警,依赖告警遗留:库兼容性问题仍会阻断升级。

追问

  • 遗留模块无法在本期清零怎么办?答:隔离部署或单列升级计划;不能带着未登记的弃用点进入目标版本。
  • 告警清零后如何防止回潮?答:CI 对新增弃用计数设阈值,代码评审检查废弃接口调用。

04.5.2.13-020 本页待确认项与核对手段有哪些?

一句话结论

各版本具体弃用函数清单、移除记录、配置默认值与安全收紧条目属待确认项;核对入口为官方迁移指南、函数手册与目标环境探针,本机 8.5.9 仅验证语言层 API 存在性。

概念解释

本页按主题归纳方向与流程,不枚举未经本机或官方文档核实的函数名、版本号与默认值。涉及具体条目时,先查迁移指南,再用探针在目标环境复核;结论随升级到新版本重新刷新。

原理流程

  1. 列出待核对条目类型:废弃符号、移除记录、INI 默认值、安全行为。
  2. 在官方文档定位对应版本章节。
  3. 目标环境跑探针与测试,把核实结果回填到项目文档。

代码或图示

// 本机探针:记录当前版本环境事实
$env = [
    'php-version' => PHP_VERSION,
    'sapi' => PHP_SAPI,
    'loaded-extensions' => get_loaded_extensions(),
];

echo 'PHP ', $env['php-version'], ' (', $env['sapi'], ')', PHP_EOL;
echo 'extensions: ', implode(', ', $env['loaded-extensions']), PHP_EOL;

// 待确认清单与核对入口
$pending = [
    'per-version-deprecated-functions' => '迁移指南对应章节',
    'removed-symbols' => '迁移指南移除记录',
    'ini-default-changes' => '手册配置章节',
    'security-behavior-notes' => '迁移指南安全章节',
];
foreach ($pending as $item => $source) {
    echo $item, ' <- ', $source, PHP_EOL;
}

常见误区

  • 把待确认条目写成确定函数名或版本号:未核实内容必须标注待确认与核对手段。
  • 探针结果跨版本套用:环境变化后必须重跑。

追问

  • 本页与 04.5.2.12 如何配合使用?答:12 页讲升级流程与排期,本页讲弃用清单、安全变更与排查动作;两份清单在升级评估时合并使用。
  • 升级后哪些文档需要更新?答:迁移表、弃用清单与本页待确认项;版本相关结论按新环境探针刷新。