php代码规范以psr-12为核心,要求类左花括号独占一行、方法左花括号与声明同行、强制使用4空格缩进、每行不超过120字符、关键字后加空格、命名空间与use后空行,并统一使用大括号包裹所有控制结构以保障可读性与安全性。

PHP 8.1 里大括号本身没有新语法,所谓“优雅”不取决于版本,而取决于你是否统一、可读、防错——尤其在多人协作或长期维护的项目中,随意省略大括号是 bug 温床。
单语句 if/else 必须加花括号
语法允许省略,但实际开发中不该省。比如这个看似无害的写法:
if (isset($user)) echo $user['name'];
一旦后续加一行日志或校验:
if (isset($user)) echo $user['name'];
error_log('user accessed');
第二行就永远执行,和逻辑预期完全脱节。IDE 也很难高亮这种隐性错误。
- 所有
if、else、elseif、for、foreach、while后面,无论几条语句,都强制用{}包裹 - 哪怕只有一行
return或throw,也加上大括号,保持视觉节奏一致 - PHP-CS-Fixer 规则
braces可自动修复这类风格问题
类/方法/函数的大括号必须独占一行
这是 PSR-12 和主流框架(Laravel、Symfony)的通用约定,不是个人偏好:
class UserService
{
public function find(int $id): ?User
{
return $this->repo->findById($id);
}
}
反例(常见于老代码或草稿):
class UserService { public function find(...) { ... } }
问题不止是难看:IDE 折叠失效、git diff 行变更混乱、合并冲突概率升高。
- 类、接口、trait、enum 的
{必须换行,顶格对齐 - 方法、函数的
{同样换行,且与声明行垂直对齐 - PHPStorm 默认支持 PSR-12 格式化,快捷键
Ctrl+Alt+L(Win)或Cmd+Option+L(Mac)一键对齐
HTML 混排时大括号别塞进属性值里
像这样写很危险:
<input value="<?php if ($disabled) { echo 'disabled'; } ?>">
表面没问题,但一旦逻辑变复杂(比如要加 class、data-* 属性),嵌套引号、转义、可读性全崩。更糟的是,某些模板引擎或静态分析工具会误判 PHP 块边界。
- 把条件判断提前到 PHP 块内完成,变量只负责输出
- 用三元运算符仅限极简场景(如
$disabled ? 'disabled' : ''),超过两个分支必须拆成独立块 - 复杂渲染建议交给视图组件或 Blade/Twig 等模板语法,而非原生 PHP 混排
真正容易被忽略的点是:大括号风格一旦选定,就必须靠工具固化。手动维护不可靠,php-cs-fixer + pre-commit hook 才是守住优雅底线的实际手段。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











