PHP8.0大括号写法如何格式化代码-php教程-PHP中文网

php 8.0 要求大括号严格遵循 psr-12：class/interface/trait 左括号独占一行，function/if/for 等左括号须与声明同行，右括号独占且垂直对齐；php-cs-fixer 需显式配置 braces 规则。

php8.0大括号写法如何格式化代码

PHP 8.0 中大括号 {} 的写法必须严格遵循 PSR-12 规范，否则自动格式化工具（如 PHP-CS-Fixer）会报错或产生意外换行，尤其在 if、function、class 等结构中。

PSR-12 要求的花括号位置不能混用

PHP 8.0 不再容忍“K&R 风格”（即左花括号跟在关键字后不换行）与“BSD/Allman 风格”（左花括号独占一行）混用。PSR-12 明确规定：

class、trait、interface 的左花括号 必须独占一行，例如：class User { ❌ 错误；class User\n{ ✅ 正确
function、if、for、foreach、while 的左花括号 必须跟在声明行末尾，中间无换行，例如：function index() { ✅；function index()\n{ ❌（PSR-12 明确禁止）
右花括号 } 必须独占一行，且与对应结构体起始行**垂直对齐**（不是缩进对齐）

PHP-CS-Fixer 自动修复时的关键配置项

若用 php-cs-fixer 格式化，仅启用 @PSR12 规则集还不够，需显式指定花括号行为，否则可能保留旧风格：

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

确保 braces 规则启用，并设置 "position_after_functions_and_others": "next"（强制函数后换行）
禁用 no_unused_imports 类规则干扰格式化流程

配置示例片段（.php-cs-fixer.php）：

return (new PhpCsFixer\Config())<br>    ->setRules([<br>        '@PSR12' => true,<br>        'braces' => [<br>            'allow_single_line_anonymous_class_with_empty_body' => true,<br>            'position_after_functions_and_others' => 'next',<br>        ],<br>    ])

模板中 PHP 标签内大括号易被忽略的缩进陷阱

在混合 HTML 的 PHP 模板（如 .php 视图文件）中，{ 和 } 本身不输出，但其前后空白会影响 HTML 渲染。常见错误：

写成：<?php if ($user) { ?><div>Hi</div> <?php } ?> → { 前的空格会被当成文本输出
正确做法是让 <?php 紧贴上一行末尾：例如 <ul><?php foreach ($items as $item) { ?></ul>，而非 <ul>\n <?php foreach ($items as $item) { ?> </ul>
使用替代语法（if: / endif;）可规避大括号缩进问题，但需确认模板引擎支持（如原生 PHP、Blade、Twig）

真正难处理的是嵌套多层控制结构时，IDE 自动缩进和 PSR-12 要求的花括号位置存在隐性冲突——比如 if 后换行写 { 是非法的，但 IDE 可能默认这么做。务必以 php-cs-fixer --dry-run 预检，而不是依赖编辑器实时提示。