README

#PHP_Beautifier 是什么？#

PHP_Beautifier 是一个开源的 PHP 应用程序，遵循 PHP 许可证 3.0 的条款分发。该程序试图自动重新格式化和美化 PHP 4 和 PHP 5 代码。谁需要它？

• 从其他程序员那里获取 PHP 代码并感到有些困惑的开发者
• 无法再阅读自己编写的 PHP 代码的开发者
• 想要分享他们 PHP 代码的开发者

#简短的历史背景#

该程序的第一个版本，PhpBeautify，由 Jens Bierkandt 在 Php 4 上开发。2003 年达到“稳定”状态，是 Php 4 用户推荐的版本。这个版本几乎完美无瑕，但很难升级，并且有一些与奇怪结构（如 Pascal 类型的控制指令和“switch”结构）相关的问题。

随着标记器的稳定和 PHP 5 的到来，需要一个新的程序版本。因此，2004 年由 Claudio Bustos 从头开始开发了新版本的代码，基于 Php Tokenizer 和插件架构。在哪里可以获取 PHP_Beautifier？

PHP_Beautifier 资源分布在三个网站上

• PEAR：下载、变更日志和错误报告
• Github：源代码（GIT）、wiki 和论坛

PHP_Beautifier 的功能

• 版本独立：需要 PHP5 来运行，但可以处理 PHP 4 和 PHP 5 脚本。也应该美化 PHP 3，如果有人测试过，请发送报告）
• 平台无关：应该在支持 PHP 5 的所有平台上工作。已在 Windows 98、2000、XP 和 Linux Gentoo 1.4.6 上进行了测试
• 根据给定的空格数自动缩进 PHP 源代码
• 如果需要，自动换行
• 您可以使用 Web 前端、命令行或直接使用类
• 插件架构，通过使用过滤器。美化的控制权委托给了过滤器。
• 要美化的代码可以对基类和过滤器进行回调。因此，您可以在同一文件中设置美化的选项。见回调
• 批处理。您可以在目录中（递归地，如果您想的话）美化多个文件，并将它们保存在另一个目录中。
• 仅解析 Php 代码。所有其他标记（HTML、注释）都将绕过输出
• HEREDOC 解析不带任何缩进
• 使用花括号索引字符串（例如 $this->myString{1}）不会产生奇怪的缩进
• switch 语句的缩进方式如预期

与 PHP 4 脚本一起工作？将有一个 PHP 4 版本？

此软件包需要 PHP 5 来运行，但可以处理任何 PHP 文件，包括 PHP 4 和 PHP 5 脚本。

在不久的将来，不会。异常的使用、重载和标记器（在 PHP 4 上都是实验性的）以及默认情况下通过引用传递对象可以模拟，但我更愿意将精力集中在 PHP 5 上。但这只会影响软件包的安装；您可以无问题地美化针对 PHP 4 和 PHP 5 编写的脚本。

是否安全使用？

该软件包的源代码本身没有任何问题。我用它处理了一个包含超过40,000行PHP 4源代码的应用程序，自0.0.6版本以来，我没有遇到过任何损坏的文件。

该软件包有一个测试套件来验证所有重要功能。任何错误都有测试来验证修复。

因此，我认为，您可以有信心使用这个应用程序。无论如何，您始终应该定期备份您的文件，并使用某些版本控制系统，如CVS或Subversion。