本文介绍如何通过 PHP_CodeSniffer（PHPCS）配置规则，仅对类属性（properties）强制执行 $snake_case 命名规范，避免误判方法或变量，并推荐基于 WordPress Coding Standards 的可靠解决方案。
本文介绍如何通过 php_codesniffer（phpcs）配置规则，仅对类属性（properties）强制执行 `$snake_case` 命名规范，避免误判方法或变量，并推荐基于 wordpress coding standards 的可靠解决方案。
在 PHP 项目中统一命名风格是代码可维护性的关键一环。虽然 PHPCS 内置标准（如 Squiz、PSR12）提供了通用的变量命名检查，但默认不支持“仅针对属性强制 snake_case”这一精细化策略——例如
✅ 正确做法：引入 WordPress Coding Standards（WPCS） ——它提供了语义更精确的规则：
<rule ref="WordPress.NamingConventions.ValidVariableName.VariableNotSnakeCase"/>
该规则专门检测类属性（public/protected/private）是否违反 snake_case 规范，而对方法名、函数参数、局部变量等完全忽略，完美满足“仅约束属性”的需求。
? 使用前提：
立即学习“PHP免费学习笔记（深入）”；
- 已安装 WPCS：composer require --dev wp-coding-standards/wpcs
- 在 phpcs.xml 或 ruleset.xml 中正确引入：
<?xml version="1.0"?> <ruleset name="MyStandard"> <rule ref="WordPress.NamingConventions.ValidVariableName.VariableNotSnakeCase"/> <!-- 可选：禁用冲突规则 --> <rule ref="Squiz.NamingConventions.ValidVariableName.NotCamelCaps"> <severity>0</severity> </rule> </ruleset>
⚠️ 注意事项：
- WPCS 默认要求属性以 $ 开头且全小写+下划线（如 $user_id, $is_active），不接受 $camelCase 或 $PascalCase；
- 若项目已使用其他标准（如 PSR-12），建议通过
或 0 显式关闭其变量命名规则，避免冲突； - 该规则不检查常量或静态属性命名（如 self::$CACHE_KEY），如需覆盖，需额外启用 WordPress.NamingConventions.ValidConstantName 等规则。
? 小结：PHPCS 官方规则集缺乏上下文感知能力，而 WPCS 提供了经过生产验证的、面向属性的 snake_case 校验器。对于追求命名严谨性的团队，这是目前最直接、稳定且无需自定义 Sniff 的方案。
