PHP 代码格式化程序和美化器
指导
PHP 代码格式化程序和美化器
即时使用行业标准样式预设格式化和美化您的PHP代码。粘贴混乱或格式不一致的PHP，即可获得符合PSR-12、Laravel或WordPress编码标准的干净输出 — 完全控制缩进、大括号放置和行长度。
如何使用
将您的PHP代码粘贴到输入区域。选择一个样式预设以自动配置格式化选项，或手动调整缩进宽度、大括号样式和行长度。格式化后的代码会在输出面板中即时更新 — 一键复制。
特征
- 样式预设 – 一键式格式化，支持PSR-12 (PHP标准)、Laravel和WordPress编码标准配置。
- PHP特定的大括号规则 – PSR-12 对类和方法使用下一行大括号，但对控制结构使用同一行大括号。WordPress 在所有地方使用同一行大括号。每个预设会自动应用正确的约定。
- 数组格式化 – 处理短数组语法 ("
[]") 和传统array()语法，并进行适当的缩进。 - 可配置缩进 – 在 2 个空格、4 个空格或制表符之间进行选择。WordPress 默认为制表符；PSR-12 和 Laravel 默认为 4 个空格。
- 控制结构间距 – 强制在关键字后添加适当的间距，例如
if,for,foreach,while， 和switch. - 空行规范化 – 方法、属性和类部分之间保持一致的间距。
- 实时格式化 – 在您键入或更改任何选项时，输出会即时更新。
何时使用此工具
在清理用于拉取请求的PHP代码、在框架之间移动代码时在样式指南之间进行转换，或标准化项目格式时使用此工具。在将WordPress插件代码重新格式化为符合WordPress标准，或将旧PHP代码转换为符合PSR-12标准时，它特别有用。
常问问题
-
什么是PSR-12以及它对PHP为何重要？
PSR-12是由PHP-FIG (框架互操作性小组)发布的扩展编码风格指南。它定义了代码格式规则，包括缩进、大括号放置、行长度和间距。PSR-12之所以重要，是因为它提供了一个通用标准 — 当遵循PSR-12时，来自不同框架和库的代码看起来一致，从而减少了代码审查和协作期间的认知负担。
-
PSR-12与WordPress编码标准有何不同？
最大的区别在于缩进和大括号放置。PSR-12使用4空格缩进，并将开大括号放在类和方法的下一行（但控制结构放在同一行）。WordPress对所有内容使用制表符进行缩进，并将开大括号放在同一行。WordPress还有独特的规则，如Yoda条件（先比较常量）和特定的数组格式化偏好。
-
PHP代码应该使用空格还是制表符？
PSR-12要求每个缩进级别使用4个空格 — 这是大多数现代PHP框架（包括Laravel和Symfony）的标准。WordPress编码标准要求使用制表符。PHP社区存在分歧，但PSR-12和空格在新的项目中更为广泛采用。关键是在项目内保持一致：切勿在同一代码库中混合使用制表符和空格。
-
什么是PHP-CS-Fixer，它与手动格式化相比如何？
PHP-CS-Fixer是一个命令行工具，可以自动修复PHP代码以遵循PSR-12或自定义规则集等编码标准。与手动格式化不同，它使用正确的PHP解析器来理解代码结构，正确处理heredoc、复杂表达式和多行参数等边缘情况。它可以集成到CI管道和编辑器插件中，以便在保存时自动格式化。
