phpstorm本身不校验文件上传安全，需依赖phpstan或自定义phpcs sniff；psr-12仅规范代码风格，不覆盖$_files校验等安全逻辑，必须手动集成外部工具并正确配置路径、作用域及规则才能触发提示。
PHPStorm 本身不校验文件上传逻辑是否安全，它只负责把 phpcs、phpstan 这类工具的输出转成波浪线提示——你得先让这些工具能识别上传相关的风险点。
为什么直接开 PSR12 不会报 $_FILES 未校验？
PSR-12 是代码风格标准，不管业务逻辑。像 $_FILES['avatar']['tmp_name'] 是否被 is_uploaded_file() 验证、move_uploaded_file() 前是否检查 $_FILES['avatar']['error'] === UPLOAD_ERR_OK，这些属于安全规范，PSR 系列根本不覆盖。
- phpcs 默认启用的 sniff（如 PSR12、Generic）不包含文件上传校验规则
- 即使你写了
if ($_FILES['x']['error']) { die(); }，只要缩进/括号符合 PSR12，phpcs 就完全沉默 - 真正能揪出这类问题的是 phpstan（配合自定义规则）或专用静态分析器（如 psalm + plugins），但 PhpStorm 只是调用它们的“翻译器”
怎么让 PhpStorm 提示上传逻辑缺陷？
必须靠外部工具输出明确错误，并让 PhpStorm 解析到行号和消息。目前最可行的是用 phpstan + 自定义规则，或用 phpcs 手动注入 sniff：
- 安装
phpstan/phpstan并配置phpstan.neon，加入对$_FILES全局变量的访问检测（需写 custom rule 或用phpstan-phpunit类扩展） - 更轻量的做法：用
phpcs的自定义 sniff。新建一个UploadCheckSniff.php，在process()中扫描T_VARIABLE是否为$_FILES，再检查后续是否紧跟is_uploaded_file或move_uploaded_file调用；把它注册进phpcs.xml：<rule ref="YourStandard.UploadCheck"></rule> - PhpStorm 中 Settings → Languages & Frameworks → PHP → Quality Tools → PHPStan，填对
phpstan路径和配置文件路径；同时 Editor → Inspections → PHP → PHPStan validation 必须启用 - 别指望“一键启用上传检查”——没有现成标准 sniff 覆盖这个场景，你得自己写或找社区维护的扩展（如
sirbrillig/phpcs-security-audit，但它对$_FILES支持有限）
常见误配导致“明明写了规则却没提示”
不是规则没写，而是 PhpStorm 没看到结果。最容易卡在这几步：
-
phpstan报错但 PhpStorm 不显示：检查 Settings → Languages & Frameworks → PHP → Quality Tools → PHPStan 的 “Configuration file” 是否指向项目根目录下的phpstan.neon，且该文件里includes:正确加载了你的自定义扩展 -
phpcs自定义 sniff 不生效：运行命令行验证——phpcs --standard=YourStandard --sniffs=YourStandard.UploadCheck src/UploadController.php，如果命令行没输出，IDE 肯定也不会标红 - 路径填错：Windows 下
phpstan路径别填C:\Users\xxx\AppData\Roaming\Composer\vendor\bin\phpstan.bat，要填C:\Users\xxx\AppData\Roaming\Composer\vendor\phpstan\phpstan\phpstan.phar（.bat 是 wrapper，IDE 有时解析失败） - Scope 错了：Editor → Inspections → PHP → PHPStan validation 的 Scope 如果设成 “Test Sources”，而你的上传逻辑在
src/下，那就彻底静默
真正起作用的永远是命令行工具本身的检测能力，PhpStorm 只是把 stdout 里的第 3 行第 12 列错误，映射成编辑器里那条红色波浪线——上传校验这种深度语义检查，得你自己把规则塞进工具里，不能依赖 IDE 自动生成。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
