120字符场景)
" />
当常量或变量声明语句长度超过120字符时,应将等号 = 保留在首行,而非换行;推荐通过字符串拼接或逻辑拆分实现可读性与格式合规的平衡。
当常量或变量声明语句长度超过120字符时,应将等号 `=` 保留在首行,而非换行;推荐通过字符串拼接或逻辑拆分实现可读性与格式合规的平衡。
在PHP(及其他主流语言)的代码风格实践中,PSR-12 等官方规范虽未明确定义长赋值语句中等号(=)的换行位置,但社区共识与可维护性原则强烈支持:等号必须与左侧变量/常量名保留在同一行。这确保了语句结构清晰、语法意图明确,避免解析歧义和IDE识别异常。
✅ 推荐写法(等号居首行,右侧内容合理折行):
const MY_LONG_LONG_ORIGINAL_CONST_NAME_EXAMPLE =
'Framework\Framework\Class\Service::execute() : execute are unsupported by the Service class';✅ 更优写法(语义化字符串拼接,兼顾可读性与行宽限制):
const MY_LONG_LONG_ORIGINAL_CONST_NAME_EXAMPLE = 'Framework\Framework\Class\Service'
. '::execute() : execute are unsupported by the Service class';该方式将长字符串按语义单元(如命名空间、类名、方法签名)切分,每段独立成行且以 . 显式连接,既满足 ≤120 字符要求,又提升调试与版本比对效率。
❌ 应避免的写法:
const MY_LONG_LONG_ORIGINAL_CONST_NAME_EXAMPLE
= 'Framework\Framework\Class\Service::execute() : execute are unsupported by the Service class';将 = 单独置于第二行会破坏语句完整性,降低扫描效率,且易被误读为语法错误(尤其在无高亮编辑器中)。
? 注意事项:
- 若右侧为数组、闭包或复杂表达式,优先考虑提取为独立变量,而非强行折行;
- 使用静态分析工具(如 PHP_CodeSniffer + PSR12 标准)自动校验行宽与赋值风格;
- 团队应统一约定——建议在
.editorconfig中配置max_line_length = 120,并在代码审查中重点关注赋值结构一致性。
归根结底,代码风格的本质是“降低认知负荷”。保留等号在声明行,是对“谁被赋值”这一核心语义的尊重;而有意识地拆分右侧内容,则是对“值是什么”的清晰传达。

















