phpcs 默认强制要求添加 @license 标签以符合 psr 或 pear 规范，但这对闭源项目并不适用；本文教你通过配置文件精准禁用相关 sniff，既保持代码规范性，又避免引入不合法或无意义的许可证声明。
在闭源 PHP 项目中使用 PHPCS（PHP CodeSniffer）时，你可能会遇到如下报错：
ERROR | Missing @license tag in class comment
(PEAR.Commenting.ClassComment.MissingLicenseTag)该错误源自 PEAR 编码标准中对类注释必须包含 @license 的硬性要求。但闭源项目无法也不应声明开源许可证（如 MIT、GPL），而填写 "No License"、"Proprietary" 或空值不仅不符合语义规范，还可能误导协作者或自动化工具——PHPCS 并不校验 @license 值的有效性，仅检查其存在性，因此“虚假声明”违背了文档即契约的原则。
正确的解决方案不是妥协于形式，而是调整规则本身：通过 PHPCS 配置文件有选择地禁用该 sniff，而非在每个文件中添加无效标签。
步骤一：定位问题 sniff 名称
运行以下命令获取触发警告的完整 sniff ID：
立即学习“PHP免费学习笔记（深入）”；
vendor/bin/phpcs -s
输出中会明确显示类似：
PEAR.Commenting.ClassComment.MissingLicenseTag
步骤二：在 phpcs.xml 中排除该规则
在项目根目录的 phpcs.xml（或 phpcs.xml.dist）中，将该 sniff 添加到
<?xml version="1.0"?>
<ruleset name="MyProject">
<!-- 继承 PEAR 标准 -->
<rule ref="PEAR">
<!-- 明确排除不适用于闭源场景的许可证检查 -->
<exclude name="PEAR.Commenting.ClassComment.MissingLicenseTag"/>
</rule>
<!-- 指定待扫描目录 -->
<file>src</file>
<file>tests</file>
<!-- 可选：启用其他实用规则 -->
<rule ref="Generic.PHP.ForbiddenFunctions">
<properties>
<property name="forbiddenFunctions" type="array">
<element key="die">exit</element>
<element key="print_r">var_dump</element>
</property>
</properties>
</rule>
</ruleset>✅ 优势说明：此方式全局生效、语义清晰、零侵入代码，且完全兼容 CI/CD 流程；后续升级 PHPCS 或切换标准（如改用 PSR-12）时，只需同步更新 exclude 列表，无需批量修改源文件注释。
补充建议
- 若你使用的是 PSR12 或 Squiz 等其他标准，同样可通过 -s 查出对应 sniff（如 PSR12.Files.FileHeader.MissingLicenseTag），并依样排除；
- 对于确实需要声明版权归属的闭源项目，可在文件头部使用 @copyright + @author，例如：
/** * My proprietary service class. * * @copyright 2024 Acme Corp. All rights reserved. * @author Jane Doe <jane@acme.com> */
这既满足法律层面的权属标识需求，又不违反开源许可语义。
总之，工具服务于项目实质，而非反向绑架。合理裁剪静态分析规则，是专业 PHP 工程实践的重要一环。
