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 秒后停止。即使是非常大的单个文件也能处理。
我的代码会保存在服务器上吗?
不会。代码会在内存中格式化后立即返回给你,不会保存,只会记录请求大小。