跳到正文
Code Review
← 规则库/语言与脚本

评审检查清单

Php

语言与脚本40 个检查项9 个章节
**/*.{php,phtml}
01

PHP 评审原则

0 项
精确优先于召回:仅报告在变更代码及其可达上下文中很可能真实存在的缺陷。将正确性与安全类发现视为阻塞项;仅涉及风格的建议为非阻塞项。在报告依赖版本或生命周期的行为之前,先考量项目的 PHP 版本与框架约定。

在提出非局部结论之前,先使用 file_read 与 code_search 核实调用方、输入来源、框架配置、模板上下文与资源所有权。不要重复报告已由 PHPStan、Psalm、PHP_CodeSniffer、格式化工具或 PHP 编译器可靠强制执行的发现,除非 diff 展示了这些工具无法表达的具体后果。

02

类型转换、相等性与 Null 语义

5 项
  • 宽松比较(== 或 !=)的类型转换可能使不同的安全或业务敏感值比较相等。当操作数预期为同一类型时应优先使用严格比较;不要标记有意为之且经过校验的规范化
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 真值判断或 empty() 检查在 0、"0"、false、null 与空值含义各不相同时,错误地将它们视为等价
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 在必须区分值为 null 的已存在键与缺失键时使用了 isset();当契约关注的是键存在性而非值非空时,应使用 array_key_exists()
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 可空、联合类型或返回 false 的 API,其失败值流入假定拿到可用对象、标量或资源的代码。标记前先确认声明契约与运行时契约
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 数字字符串、算术或比较行为所依赖的 PHP 版本与 composer.json、CI 或部署配置支持的版本不一致
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

03

数组、迭代与值语义

5 项
  • 读取数组键时未处理可达的键缺失路径,尤其是请求数据、解码后的 JSON、数据库行或可选配置
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • foreach 的值变量以引用方式迭代后未 unset() 即复用,使其仍别名指向最后一个元素,后续赋值会破坏数组
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 使用数组并集(+)、array_merge、展开语法或数字键重索引时,语义与预期的覆盖和排序行为不一致
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 回调或闭包以引用捕获循环变量,随后观察到非预期的最终值或被修改的值
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 迭代期间修改集合,可能导致跳过、重复或意外保留元素。不要标记遍历行为有意为之且局部显而易见的修改
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

04

错误、异常与 API 契约

5 项
  • 捕获 Throwable 或 Exception 后静默丢弃、转换为成功,或在失败至关重要的路径上替换为误导性默认值
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 在不相关操作之外捕获宽泛异常,导致处理器无法区分预期失败与编程或基础设施缺陷
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 代码库契约对同一失败不一致地混用异常、false 与 null,导致调用方遗漏错误路径
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 清理、回滚或响应收尾代码隐藏了主要异常,或在操作失败后仍返回成功
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 用 @ 抑制警告或错误,且抑制可能将有意义的失败转变为无效状态。不要标记用途有明确文档限定且能安全检查结果的兼容性探测
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

05

资源、事务与请求生命周期

5 项
  • 长驻进程中的事务、锁、数据库游标或资源未在每条可达路径上释放、提交或回滚,且延迟清理可能耗尽容量或破坏正确性。不要仅因 PHP 可在请求结束时释放,就标记普通的请求级流或文件
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 数据库事务存在可导致事务保持打开状态的提前返回或异常路径,或存在当前驱动/框架不支持的嵌套事务假设
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • cURL 或流操作在请求或 worker 路径上缺少超时,而该路径上远程端点可能使执行停滞
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 在同一会话的并发请求必须继续推进时,跨慢速网络、数据库或 CPU 工作持有会话锁
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 当所有权转移已由周边代码确立时,不要报告由框架、依赖注入容器、generator 消费方或调用方拥有的资源
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

06

数据库与 ORM 正确性

5 项
  • PHP-DATABASE-AND-ORM-CORRECTNESS-001状态加载中
    用不可信值拼装 SQL 而非使用参数绑定。列名、排序方向等标识符通常无法绑定,需要白名单
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • PHP-DATABASE-AND-ORM-CORRECTNESS-002状态加载中
    原始 ORM 表达式、查询片段或动态表/列名,使攻击者可控数据绕过框架的常规参数化
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • PHP-DATABASE-AND-ORM-CORRECTNESS-003状态加载中
    变更的多步写入必须原子执行时缺少事务边界,或副作用顺序安排不当,使回滚无法恢复一致性
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • PHP-DATABASE-AND-ORM-CORRECTNESS-004状态加载中
    仅当循环在有意义规模上可达,且预加载或批处理能保持行为不变时,才报告 N+1 查询或重复远程调用
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • PHP-DATABASE-AND-ORM-CORRECTNESS-005状态加载中
    仅当请求可控字段能流入模型,且框架的 fillable/guarded/schema 配置尚未约束它们时,才报告批量赋值暴露
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

07

Web 与模板安全边界

6 项

报告前先确认攻击者的控制能力以及输出或执行上下文。框架校验与自动转义可能使看似危险的操作实际安全。

  • 不可信输出渲染时未针对 HTML 文本、属性、URL、JavaScript 或 CSS 做与上下文相符的转义处理。对于 .phtml 模板,先核实视图助手是否已对该值转义,以及原始 HTML 是否有意为之且已净化
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 授权仅在客户端、模板或隐藏控件中执行,而非在服务端操作处强制;标记前先检查路由中间件、policy、voter 与控制器守卫
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 基于 cookie 的认证使跨站调用成为可能时,改变状态的浏览器请求缺少必需的 CSRF 防护。不要标记采用 token 认证、不受环境凭据影响的 API
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 由不可信数据构建的重定向、响应头或 cookie,在需要这些属性的场景中未做校验,或缺少 Secure、HttpOnly 与 SameSite 防护
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 仅凭客户端文件名、扩展名或 MIME 头信任文件上传;核实服务端类型检查、生成的存储名称、目标路径边界与可执行文件处理
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 用户可控路径用于文件系统访问时未做规范化与边界强制,造成目录穿越、符号链接逃逸或意外覆盖
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

08

动态执行、反序列化与外发请求

6 项
  • eval、动态 include/require、变量函数调用、反射或 shell 命令可被不可信输入触达,且缺少严格白名单
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 对攻击者可控数据调用 unserialize(),包括缺少密钥管理或校验的签名数据。优先选择不可执行格式;allowed_classes 能减少对象注入,但不会使任意数据变得可信
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 通过拼接或不完整转义构建 shell 命令。优先使用参数分离的直接进程 API,并对类选项的攻击者可控值进行校验
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 外发 URL 源自不可信输入,缺少必需的协议、主机、端口、重定向与私网限制,造成 SSRF 或凭据转发
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 弱随机性或弱密码处理:可预测的 token 生成、可逆的密码存储、手工密码哈希,或对机密未采用常数时间比较。视情况优先使用 random_bytes、password_hash、password_verify 与 hash_equals
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • 机密、会话标识、授权头、密码、私钥或敏感个人数据被写入日志、在错误中返回或嵌入源码
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

09

性能与评审范围

3 项
  • PHP-PERFORMANCE-AND-REVIEW-SCOPE-001状态加载中
    仅在有有意义的数据规模或热路径证据时报告性能问题:重复查询、意外的全量结果物化、二次复杂度数组操作或循环内重复执行的高开销工作
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • PHP-PERFORMANCE-AND-REVIEW-SCOPE-002状态加载中
    仅针对由本次变更引入、涉及类型转换、边界值、错误、事务、授权、转义或框架配置的具体失败模式建议测试
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

  • PHP-PERFORMANCE-AND-REVIEW-SCOPE-003状态加载中
    不要将格式化、命名、导入顺序、现代语法偏好或已由确定性 PHP 工具强制执行的建议列为阻塞项
    内置
    来源与改动说明

    来源

    本站调整:沿用原规则,提供中文说明并补充编号。

返回本页顶部 ↑继续浏览规则库

手动复制规则链接

浏览器未允许自动复制,请选中下方链接复制。