PHP 代码美化工具

使用这个 PHP 代码美化工具,把拥挤的代码片段变成易于阅读的内容。它会让每条语句单独占一行,把大括号移到单独的行上,并以 2 或 4 个空格缩进嵌套的代码块。这是一种简单的文本重排,因此适合简短、朴素的代码,而不是整个项目。

如何美化 PHP 代码

  1. 1

    粘贴代码

    把代码片段放入 PHP 代码框。开始标签可写可不写。

  2. 2

    选择缩进

    选择 2 或 4 个空格。4 个空格是 PHP 中的常见选择。

  3. 3

    进入结果

    使用主按钮打开格式化后的输出。

  4. 4

    复制前先阅读

    将结果与原文对照检查,然后使用复制按钮。

这里所说的美化是什么意思

美化工具只改变布局。代码在美化前后应当执行相同的操作。本工具应用了一组简短的布局规则:

  • 每个分号都结束一行。
  • 每个左大括号和每个右大括号都单独占一行。
  • 大括号内的代码按嵌套深度每级缩进一级。
  • 逗号后面跟一个空格。
  • 结果中的空行会被删除。

它不会在运算符周围添加空格,不会重命名任何内容,也不会重新排列代码。

美化前后示例

输入:

<?php class User{private $name;public function getName(){return $this->name;}}

使用 4 个空格的结果:

<?php class User
{
    private $name;
    public function getName()
    {
        return $this->name;
    }
}

注意,如果你把所有内容粘贴在一行上,开始标签会与第一条语句保持在同一行。如果你希望它单独成行,请在输入中把标签放在单独的一行。

何时使用其他工具

本工具把大括号和分号当作普通字符来处理。它不解析 PHP,因此无法遵循项目的编码规范,也无法折行长代码或修正 = 和 + 等运算符周围的间距。注释、heredoc 以及 for (;;) 循环可能会处理错误,因为其中的分号会被当作普通分号。对于整个代码库,请在编辑器或构建流水线中运行已配置的修复工具,本页则用于快速的一次性整理。

美化包含循环的函数

紧凑的输入:

function total($items){$sum=0;foreach($items as $item){$sum+=$item["price"];}return $sum;}

每个大括号都会开启一个新层级,因此循环体位于两级缩进之内,return 则回到一级缩进。从上到下阅读,你现在可以看出循环是在累加 $sum,而函数随后将其返回。在单行版本中,这一点很难看清。

选择 2 还是 4 个空格

4 个空格是 PHP 代码中常见的宽度,也最容易扫读。如果代码嵌套很深,或者你要粘贴的地方很窄(例如聊天消息),可以选择 2 个空格。该设置只改变缩进,从不改变换行的位置。

检查结果

美化后的代码更便于审阅,这正是目的所在。请通读一遍,检查是否缺少或多出了大括号,因为工具会在计数时不报告问题。如果缩进在末尾处出现奇怪的偏移,通常是输入中存在不匹配的大括号。

常见问题

不应该,因为它只移动空白字符。不过,注释和 heredoc 不会被识别,因此请将结果与原文对照,并运行代码进行验证。

本工具不会在运算符周围添加空格。它处理的是大括号和分号处的换行、缩进以及逗号后的空格。

本工具并非为此设计。HTML 部分中的大括号和分号会被当作 PHP 处理,因此请只用于纯 PHP 代码片段。

不需要。无论是否带有 PHP 开始标签,你都可以粘贴代码片段。

相关工具

此工具还提供其他语言版本

使用指南与应用场景