在 composer.json 的 scripts 段添加 lint 命令需确保 PHPCS 已安装（推荐 vendor/bin/phpcs），命令须含 --standard=PSR12 等规则、--report=full 等参数，并注意版本兼容性、配置文件位置及 git 暂存区扫描技巧。

composer.json 里 scripts 怎么写 lint 命令

直接在 scripts 段里加一条命令，Composer 就能用 composer lint 触发 PHPCS。关键是命令要可执行、路径要对、参数要合理。

• PHPCS 必须已全局安装或项目本地安装（推荐 vendor/bin/phpcs）
• 命令字符串里别漏掉 --standard=PSR12 这类规则集，否则默认用 PSR2，容易误报
• 加上 --report=full 或 --report=checkstyle 方便 CI 解析；本地开发用 --report=emacs 更省眼
• 如果项目有自定义规则（比如 ruleset.xml），必须显式指定 --standard=./ruleset.xml，不能只放文件名

示例：

"scripts": {
  "lint": "phpcs --standard=PSR12 --report=full --extensions=php src/ tests/"
}

为什么 vendor/bin/phpcs 执行时报 Class 'PHP_CodeSnifferFilesFile' not found

这是 PHPCS 版本和 autoloader 冲突的典型症状，常见于 PHPCS 3.x 升级到 4.x 后未清理残留。

• PHPCS 4.x 要求 PHP 7.4+，且内部命名空间全变了，PHP_CodeSnifferFilesFile 在 4.x 已不存在
• 检查 composer show squizlabs/php_codesniffer 确认版本；若显示 v4.x，但项目里还混着旧版 ruleset 或自定义 sniff，就会报这个错
• 删掉 vendor/ 和 composer.lock，重新 composer install，确保所有依赖对齐
• 自定义 sniff 必须重写：v4 要求实现 PHP_CodeSnifferSniffsSniff 接口，且注册方式改用 register() 方法返回 token 列表

PHPCS 在 CI 中静默通过，但本地跑出一堆 warning

根本原因是规则集加载路径不一致，或者标准配置没随代码提交。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• CI 里可能用了全局 PHPCS + 全局 phpcs.xml，而本地用的是项目内 vendor/bin/phpcs，读的是项目根目录下的 phpcs.xml.dist
• 确认项目根目录有没有 phpcs.xml 或 phpcs.xml.dist；没有就等于没约束，PHPCS 会退回到内置默认值
• CI 脚本里别写死 phpcs，统一用 ./vendor/bin/phpcs，避免环境差异
• 加个 --no-cache 参数，防止 CI 缓存了旧的扫描结果

怎么让 PHPCS 只检查 git staged 的文件

靠 git diff 和 xargs 配合，避免每次全量扫，尤其对老项目提速明显。

立即学习“PHP免费学习笔记（深入）”；

• 先用 git diff --cached --name-only --diff-filter=ACM | grep '.php$' 提取暂存区的 PHP 文件
• 再用 xargs 传给 PHPCS；注意空输入时命令不能失败，加 -r 参数（GNU xargs）或用 sh -c 包一层
• 完整命令示例：

  "lint-staged": "git diff --cached --name-only --diff-filter=ACM | grep '\.php$' | xargs -r vendor/bin/phpcs --standard=PSR12"

• 如果用 Husky 或 lint-staged 工具，记得把 phpcs 命令包进 shell 脚本里，不然 Windows 下管道会挂

PHPCS 的规则加载顺序、版本兼容性、路径解析逻辑非常依赖当前工作目录和配置文件位置，一个 phpcs.xml 放错层级，或者 vendor/bin/phpcs 被 alias 成了全局命令，问题就藏得特别深。