PHP 评审原则
0 项精确优先于召回:仅报告在变更代码及其可达上下文中很可能真实存在的缺陷。将正确性与安全类发现视为阻塞项;仅涉及风格的建议为非阻塞项。在报告依赖版本或生命周期的行为之前,先考量项目的 PHP 版本与框架约定。
在提出非局部结论之前,先使用 file_read 与 code_search 核实调用方、输入来源、框架配置、模板上下文与资源所有权。不要重复报告已由 PHPStan、Psalm、PHP_CodeSniffer、格式化工具或 PHP 编译器可靠强制执行的发现,除非 diff 展示了这些工具无法表达的具体后果。
类型转换、相等性与 Null 语义
5 项- 宽松比较(
==或!=)的类型转换可能使不同的安全或业务敏感值比较相等。当操作数预期为同一类型时应优先使用严格比较;不要标记有意为之且经过校验的规范化内置来源与改动说明
- 真值判断或
empty()检查在0、"0"、false、null与空值含义各不相同时,错误地将它们视为等价内置来源与改动说明
- 在必须区分值为
null的已存在键与缺失键时使用了isset();当契约关注的是键存在性而非值非空时,应使用array_key_exists()内置来源与改动说明
- 可空、联合类型或返回
false的 API,其失败值流入假定拿到可用对象、标量或资源的代码。标记前先确认声明契约与运行时契约内置来源与改动说明
- 数字字符串、算术或比较行为所依赖的 PHP 版本与
composer.json、CI 或部署配置支持的版本不一致内置来源与改动说明
数组、迭代与值语义
5 项- 读取数组键时未处理可达的键缺失路径,尤其是请求数据、解码后的 JSON、数据库行或可选配置内置
来源与改动说明
foreach的值变量以引用方式迭代后未unset()即复用,使其仍别名指向最后一个元素,后续赋值会破坏数组内置来源与改动说明
- 使用数组并集(
+)、array_merge、展开语法或数字键重索引时,语义与预期的覆盖和排序行为不一致内置来源与改动说明
- 回调或闭包以引用捕获循环变量,随后观察到非预期的最终值或被修改的值内置
来源与改动说明
- 迭代期间修改集合,可能导致跳过、重复或意外保留元素。不要标记遍历行为有意为之且局部显而易见的修改内置
来源与改动说明
错误、异常与 API 契约
5 项- 捕获
Throwable或Exception后静默丢弃、转换为成功,或在失败至关重要的路径上替换为误导性默认值内置来源与改动说明
- 在不相关操作之外捕获宽泛异常,导致处理器无法区分预期失败与编程或基础设施缺陷内置
来源与改动说明
- 代码库契约对同一失败不一致地混用异常、
false与null,导致调用方遗漏错误路径内置来源与改动说明
- 清理、回滚或响应收尾代码隐藏了主要异常,或在操作失败后仍返回成功内置
来源与改动说明
- 用
@抑制警告或错误,且抑制可能将有意义的失败转变为无效状态。不要标记用途有明确文档限定且能安全检查结果的兼容性探测内置来源与改动说明
资源、事务与请求生命周期
5 项- 长驻进程中的事务、锁、数据库游标或资源未在每条可达路径上释放、提交或回滚,且延迟清理可能耗尽容量或破坏正确性。不要仅因 PHP 可在请求结束时释放,就标记普通的请求级流或文件内置
来源与改动说明
- 数据库事务存在可导致事务保持打开状态的提前返回或异常路径,或存在当前驱动/框架不支持的嵌套事务假设内置
来源与改动说明
- cURL 或流操作在请求或 worker 路径上缺少超时,而该路径上远程端点可能使执行停滞内置
来源与改动说明
- 在同一会话的并发请求必须继续推进时,跨慢速网络、数据库或 CPU 工作持有会话锁内置
来源与改动说明
- 当所有权转移已由周边代码确立时,不要报告由框架、依赖注入容器、generator 消费方或调用方拥有的资源内置
来源与改动说明
数据库与 ORM 正确性
5 项- 用不可信值拼装 SQL 而非使用参数绑定。列名、排序方向等标识符通常无法绑定,需要白名单内置
来源与改动说明
- 原始 ORM 表达式、查询片段或动态表/列名,使攻击者可控数据绕过框架的常规参数化内置
来源与改动说明
- 变更的多步写入必须原子执行时缺少事务边界,或副作用顺序安排不当,使回滚无法恢复一致性内置
来源与改动说明
- 仅当循环在有意义规模上可达,且预加载或批处理能保持行为不变时,才报告 N+1 查询或重复远程调用内置
来源与改动说明
- 仅当请求可控字段能流入模型,且框架的 fillable/guarded/schema 配置尚未约束它们时,才报告批量赋值暴露内置
来源与改动说明
Web 与模板安全边界
6 项报告前先确认攻击者的控制能力以及输出或执行上下文。框架校验与自动转义可能使看似危险的操作实际安全。
- 不可信输出渲染时未针对 HTML 文本、属性、URL、JavaScript 或 CSS 做与上下文相符的转义处理。对于
.phtml模板,先核实视图助手是否已对该值转义,以及原始 HTML 是否有意为之且已净化内置来源与改动说明
- 授权仅在客户端、模板或隐藏控件中执行,而非在服务端操作处强制;标记前先检查路由中间件、policy、voter 与控制器守卫内置
来源与改动说明
- 基于 cookie 的认证使跨站调用成为可能时,改变状态的浏览器请求缺少必需的 CSRF 防护。不要标记采用 token 认证、不受环境凭据影响的 API内置
来源与改动说明
- 由不可信数据构建的重定向、响应头或 cookie,在需要这些属性的场景中未做校验,或缺少
Secure、HttpOnly与SameSite防护内置来源与改动说明
- 仅凭客户端文件名、扩展名或 MIME 头信任文件上传;核实服务端类型检查、生成的存储名称、目标路径边界与可执行文件处理内置
来源与改动说明
- 用户可控路径用于文件系统访问时未做规范化与边界强制,造成目录穿越、符号链接逃逸或意外覆盖内置
来源与改动说明
动态执行、反序列化与外发请求
6 项eval、动态include/require、变量函数调用、反射或 shell 命令可被不可信输入触达,且缺少严格白名单内置来源与改动说明
- 对攻击者可控数据调用
unserialize(),包括缺少密钥管理或校验的签名数据。优先选择不可执行格式;allowed_classes能减少对象注入,但不会使任意数据变得可信内置来源与改动说明
- 通过拼接或不完整转义构建 shell 命令。优先使用参数分离的直接进程 API,并对类选项的攻击者可控值进行校验内置
来源与改动说明
- 外发 URL 源自不可信输入,缺少必需的协议、主机、端口、重定向与私网限制,造成 SSRF 或凭据转发内置
来源与改动说明
- 弱随机性或弱密码处理:可预测的 token 生成、可逆的密码存储、手工密码哈希,或对机密未采用常数时间比较。视情况优先使用
random_bytes、password_hash、password_verify与hash_equals内置来源与改动说明
- 机密、会话标识、授权头、密码、私钥或敏感个人数据被写入日志、在错误中返回或嵌入源码内置
来源与改动说明
性能与评审范围
3 项- 仅在有有意义的数据规模或热路径证据时报告性能问题:重复查询、意外的全量结果物化、二次复杂度数组操作或循环内重复执行的高开销工作内置
来源与改动说明
- 仅针对由本次变更引入、涉及类型转换、边界值、错误、事务、授权、转义或框架配置的具体失败模式建议测试内置
来源与改动说明
- 不要将格式化、命名、导入顺序、现代语法偏好或已由确定性 PHP 工具强制执行的建议列为阻塞项内置
来源与改动说明