SuperAPI AI 工具集

review-php

通用与其它

查看项目

更新于 10-16 01:35

技能介绍

用途:仅审查 PHP 语言与运行时约定,不定义代码范围(差异或代码库),也不做安全或架构分析;范围由调用方或上游技能提供。适用于编排式审查中的语言步骤、单独的 PHP 语言检查(如新增 PHP 文件后)以及 PR 前的 PHP 检查表。

主要能力(九个维度):严格类型与声明(declare(strict_types=1)、类型化属性/参数、返回类型,避免隐式强制转换陷阱);错误处理(异常与错误、Throwable 层次、正确的 try-catch 与重抛,避免空捕获或过宽的捕获,error_reporting 与错误转异常);资源管理(fopen/fclose、数据库连接、流,确保通过 try-finally 或短作用域关闭,避免泄漏);PSR 标准(PSR-4 自动加载与命名空间到路径映射、PSR-12 编码风格);命名空间与自动加载(正确的 use 语句、避免全局命名空间污染、与 Composer 自动加载对齐);空安全(??、?->,避免 @ 抑制,isset 与 array_key_exists 的区别);生成器与可迭代(yield 用法、迭代器实现、大数据集的内存高效迭代);PHP 版本兼容性(特性与 composer.json 中 php 约束、已弃用 API 与迁移路径);可测试性(依赖注入、避免静态/单例、构造函数注入、可 mock 的接缝)。

使用方式:输入为已选定的代码范围(文件、目录或差异);输出为零个或多个结果,每条包含位置(file:line)、类别 language-php、严重性、标题、描述及可选建议。若相关维度不适用则不评估。

限制:不执行范围选择、安全分析(注入、认证、CSRF,交由 review-security)或架构分析(review-architecture);不做 SQL 特定分析(review-sql)。发现 SQL 注入或安全问题时仅记录并建议转交 review-security。全部 PHP 发现结果发出后交由 orchestrate-code-review 聚合。除明确在范围内,不按 PHP 特定规则检查非 PHP 文件。无具体位置或可执行建议时不给结论。示例:fopen 未在所有路径关闭应报资源管理结果并建议 try-finally 或 fclose;缺少 declare(strict_types=1) 与参数/返回类型应报类型安全结果。具体实现细节、收费与平台信息暂未提供。