# PHP 格式化工具

使用 Prettier PHP 插件，按照接近 PSR-12 规范的一致、易读风格格式化 PHP 代码。粘贴一个以 <?php 开头的文件，即可统一空格、花括号和数组格式，并将方法链和过长的参数列表按打印宽度换行。语法错误会显示解析器提示以及行号和列号，帮助 PHP 开发者在代码审查前整理旧代码。

## 常见问题

### 使用什么格式化工具？

该工具在服务器上使用 @prettier/plugin-php 0.26 运行 Prettier 3。其输出风格接近 PSR-12：默认每级缩进四个空格，类和函数的左花括号另起一行，每行一条语句。

### 代码需要以 <?php 标签开头吗？

需要。插件会格式化 PHP 标签内的代码。标签外的内容会被视为行内 HTML 并原样保留，因此不含 <?php 的代码片段会保持不变。

### 支持哪些 PHP 版本？

它支持现代 PHP 8 语法，包括属性、枚举、match 表达式、箭头函数、命名参数、构造函数属性提升和只读类。较旧的 PHP 5 和 7 代码也能格式化。

### 格式化工具会改变代码的行为吗？

不会。它只会改变排版。少数纯粹的外观改写可能会发生，例如较长的 array() 语法可能会变成等效的短语法 []，但代码行为保持不变。

### 遇到语法错误时会怎样？

格式化会停止，工具会显示解析器提示以及行号和列号，例如缺少右括号。修复该处后重新格式化即可。

### 可以使用制表符或两个空格吗？

可以。选择 2 或 4 个空格，也可以启用制表符。打印宽度范围为 40 到 200 个字符，默认值为 80；它控制函数调用、数组和条件何时换行。

### 注释和文档块会保留吗？

会。行注释、块注释和 PHPDoc 块会保留在所描述代码的旁边，注释文本不会重新排版。

### 可以格式化混合 HTML 和 PHP 的模板吗？

它会格式化此类模板中的 PHP 代码块，并原样保留它们之间的 HTML。对于包含大量模板内容的文件，结果可能仍需手动调整。

### 一次最多可以格式化多少代码？

每个请求最多可处理 1 MB 代码，格式化会在 10 秒后停止。即使是非常大的单个文件也能处理。

### 我的代码会保存在服务器上吗？

不会。代码会在内存中格式化后立即返回给你，不会保存，只会记录请求大小。

在这里投放广告？

[给我们发邮件](mailto:hi@dennn.is?subject=%E5%9C%A8%20OneClick%20Pro%20%E4%B8%8A%E6%8A%95%E6%94%BE%E5%B9%BF%E5%91%8A)

[广告 适用于 WordPress 的智能体就绪型插件套件。](https://sleekwp.com/?ref=oneclickpro)