[b]简介[/b]
有许多 PHP 调试技术可以在编码的时候节约大量时间。一个有效却很基本的调试技术就是打开错误报告。另一个略微高级一点的技术包括使用 print 语句，通过显示在屏幕上实际出现的内容，有助于精确地找出更难发现的 bug。PHPEclipse 是一个 Eclipse 插件，能够强调常见的语法错误，可以与调试器结合起来用于设置断点。
[b]设置[/b]
要学习本文描述的概念，需要 PHP、[color=#000000]Web[/color] [color=#000000]服务器[/color]和 Eclipse。调试器扩展支持的 PHP 版本是 V5.0.3。
我们需要一个 Web 服务器来解析用 PHP 创建的页面并把它们显示到浏览器。本文中使用的是 Apache2。但是，任何 Web 服务器都可以满足要求。
要利用本文中介绍的一些调试技术，需要安装 Eclipse V3.1.1 和插件 PHPEclipse V1.1.8。由于 Eclipse 要求 [color=#000000]Java[/color]? 技术，所以还要[color=#000000]下载[/color]它。
还需要 PHP 的调试器扩展模块。安装它略有些麻烦。请仔细跟随安装调试器扩展的操作说明。现在，先在 php.ini 文件中注释掉那些要求装入和配置 PHP 扩展的行。在需要使用调试器的时候，再取消注释。
请参阅 [color=#000000]参考资料[/color] 获得下载信息。现在介绍出错消息。
[b]出错消息[/b]
出错消息是作为开发人员的第一道防线。谁都不想在一台没有配置成显示出错消息的服务器上用 PHP 开发代码。但是，请记住，当代码调试完成，准备运行的时候，应当确保关闭了错误报告，因为不希望站点的访问者看到出错消息，因为这会给他们提供足够的信息来利用站点的弱点并黑掉站点。
也可以用出错消息为自己服务，因为它们会显示抛出或生成错误的正确代码行。这样，调试就变成在浏览器上查看生成的错误所显示的行号，并在代码中检查这一行。稍后，将会看到 PHPEclipse 插件通过即时地给语法错误加下划线并在保存文件时用红色 “x” 标注语法错误，可在开发和调试过程中提供极大的帮助。
先来看如何在 php.ini 文件中开启错误报告并设置错误报告的级别。然后将学习如何在 Apache 的配置文件中覆盖这些设置。
[b]PHP 的错误报告[/b]
php.ini 文件中有许多配置设置。您应当已经设置好自己的 php.ini 文件并把它放在合适的目录中，就像在 [color=#000000]Linux[/color] 上安装 PHP 和 Apache 2 的文档说明中所示的那样（请参阅 [color=#000000]参考资料[/color]）。在调试 PHP 应用程序时，应当知道两个配置变量。下面是这两个变量及其默认值：
[table=98%,#e3e3e3][tr][td] display_errors = Off error_reporting = E_ALL [/td][/tr][/table]
通过在 php.ini 文件中搜索它们，可以发现这两个变量当前的默认值。display_errors 变量的目的很明显 —— 它告诉 PHP 是否显示错误。默认值是 Off。但是，要让开发过程更加轻松，请把这个值设为 On：
[table=98%,#e3e3e3][tr][td] display_errors = On [/td][/tr][/table]
error_reporting 变量的默认值是 E_ALL。这个设置会显示从不良编码实践到无害提示到出错的所有信息。E_ALL 对于开发过程来说有点太细，因为它在屏幕上为一些小事（例如变量未初始化）也显示提示，会搞糟浏览器的输出。我只想看到错误和不良编码实践，但是不想看到无害的提示。所以，请用以下值代替 error_reporting 的默认值：
[table=98%,#e3e3e3][tr][td] error_reporting = E_ALL & ~E_NOTICE [/td][/tr][/table]
重新启动 Apache，就全部设置好了。接下来，将学习如何在 Apache 上做同样的事。
[b]服务器上的错误报告[/b]
依赖于 Apache 正在做的工作，在 PHP 中打开错误报告可能没法工作，因为在计算机上可能有多个 PHP 版本。有时很难区分 Apache 正在使用哪个 PHP 版本，因为 Apache 只能查看一个 php.ini 文件。不知道 Apache 正在使用哪个 php.ini 文件配置自己是一个安全问题。但是，有一种方法可以在 Apache 中配置 PHP 变量，从而保证设置了正确的出错级别。
而且，最好知道如何在服务器端设置这些配置变量，以否决或抢占 php.ini 文件，从而提供更高级别的安全性。
在配置 Apache 时，应该已经接触过 <apache2-install-dir>/conf/httpd.conf 中 http.conf 文件中的基本配置。
要做在 php.ini 文件中已经做过的事，请把下列各行添加到 httpd.conf，覆盖任何 php.ini 文件：
[table=98%,#e3e3e3][tr][td] php_flag display_errors on php_value error_reporting 2039 [/td][/tr][/table]
这会覆盖在 php.ini 文件中为 display_errors 已经设置的标志，以及 error_reporting 的值。值 2039 代表 E_ALL & ~E_NOTICE。如果愿意采用 E_ALL，请把值设为 2047。同样，还是要重启 Apache。
接下来，要在服务器上测试错误报告。
[b]测试错误报告
[/b] 如果启动了错误报告，会节约许多时间。PHP 中的错误会指向代码中的错误。请创建一个简单的 PHP 文件 test.php，并像清单 1 所示一样定义它。
[b]清单 1. 一个生成错误的简单 PHP[/b]
[table=98%,#e3e3e3][tr][td] <?php print("The next line generates an error.<br>"); printaline("PLEASE?"); print("This will not be displayed due to the above error."); ?> [/td][/tr][/table]
第一个 print() 语句会向 Web 浏览器显示它的内容。但是第二个语句会生成错误并在 Web 页面上显示。这造成最后一个 print() 语句不起作用，如图 1 所示。
[b]图 1. 生成错误[/b]
[img=572,271]http://image.21tx.com/image/20060125/18752.jpg[/img]
现在开启了错误报告！接下来，用 print 语句帮助调试应用程序。
[b]介绍 print 语句[/b]
因为应用程序中的功能性 bug 不会产生错误，所以在所有调试策略中，关于如何正确地放置和使用 print 或 die 语句来调试 PHP 应用程序的知识是一种很好的资产。可以用 print 语句在代码中缩小对问题语句的定位，这些语句在语法上没有错误，也不是 bug，但是从代码的功能上看是 bug。这些是最难发现和调试的 bug，因为它们不会抛出错误。惟一知道的就是在浏览器上显示的内容不是想要的内容，或者想要保存在数据库中的内容根本没有保存。
假设正在处理通过 GET 请求发送过来的表单数据，想向浏览器显示信息，但是出于某种原因，数据没有正确地提交，或者不能正确地从 GET 请求中读出。要调试这类问题，重要的是用 print() 或 die() 语句知道变量的值是什么。
die() 语句会中止程序执行，并在 Web 浏览器上显示文本。如果不想注释掉代码，而且只想显示到出错之前的信息和出错信息，不想显示后面的信息，那么 die() 语句特别有用。
让我们在 PHP 中用 print 语句来测试这个概念
[b]使用 print 语句进行调试[/b]
在我作程序员的那些时候，当我在 Linux? 上开发应用程序时，没有方便的 GUI 可以告诉我 bug 在哪，我迅速地发现我在程序中放的 print 语句越多，我在应用程序中把 bug 的范围缩小到一行的机会越大。请创建另一个 PHP 文件 test2.php，并像清单 2 所示的那样定义它。
[b]清单 2. 显示通过 GET 提交的所有变量[/b]
[table=98%,#e3e3e3][tr][td] <?php $j = ""; print("Lets retrieve all the variables submitted to this "); print("script via a GET request:<br>"); foreach($_GET as $key => $i){ print("$key=$j<br>"); } if($_GET['Submit'] == "Send GET Request") $j = "done!<br>"; ?> <form method="GET"> Name: <input name="name"><br> Email: <input name="email" size="25"><br> <input name="Submit" type="submit" value="Send GET Request"> </form> [/td][/tr][/table]
您可能会非常容易地发现清单 2 中的 bug！您很棒！但请注意这是一个非常简单的脚本，只是作为使用 print 语句进行调试而展示的一个例子而已。这个脚本只是提取 GET 请求中的所有变量，如果有，就把它们显示在浏览器上。还提供了一个表单，用 GET 请求向服务器发送变量以进行测试。请看输出，如图 2 所示。
[b]图 2. test2.php 的输出[/b]
[img=572,264]http://image.21tx.com/image/20060125/18758.jpg[/img]
现在单击 [b]Send GET Request[/b] 按钮，请注意只有 $_GET 请求的键显示在浏览器上，而正确的值都没显示。可以在循环中放一个 print 语句，检验在 foreach 循环中每个元素中是否确实存在数据。请参阅清单 3。
[b]清单 3. 用 print 语句验证代码的功能[/b]
[table=98%,#eeeeee][tr][td] ... foreach($_GET as $key => $i){ print("Correct data? " . $_GET[$key] . "<br>"); print("$key=$j<br>"); } ... [/td][/tr][/table]
放进去的 print 语句是粗体。注意，现在已经知道在 Web 浏览器上显示的 $key 值是正确的，但是由于某些原因，值没有正确地显示。请看新的输出，如图 3 所示。
[b]图 3. 修改后的 test2.php 的输出[/b]
[img=572,305]http://image.21tx.com/image/20060125/18766.jpg[/img]
现在已经知道应用程序正确地从 GET 请求接收到了变量，那么肯定是在代码中有 bug。查看之后注意到，用来显示值的变量 $j 是错误的。在 foreach 语句中指定的是 $i，所以它肯定会有正确的值，但是无意之中输入了 $j。所以通过把 $j 替换成 $i，迅速地修正了错误，重新载入页面之后，就看到了正确的输出，如图 4 所示。
[b]图 4. 修正后的 test2.php 的输出[/b]
[img=572,310]http://image.21tx.com/image/20060125/18771.jpg[/img]
现在可以删除或注释掉刚才添加的 print 语句了，因为已经发现了代码中的 bug。注意，这只是在调试应用程序时可能遇到的许多错误中的一个很小的子集。对于使用数据库时可能遇到的问题，一个好的解决方案是输出 SQL 语句，以确保执行的 SQL 就是想要执行的。
现在要来看看如何使用 Eclipse IDE 和 PHPEclipse 插件及调试器扩展进一步在调试历程中提供帮助。
[b]使用 [/b][b]PHP[/b][b]Eclipse[/b]
您可能用过 Eclipse，但是可能不熟悉它。请参阅 参考资料 获得 Eclipse 平台的介绍。
用于 Eclipse 的 PHPEclipse 插件是用来开发 PHP 应用程序的一个流行工具。请启动 Eclipse 并把工作区目录指定为 Apache 的 www 目录（在我的机器上是 c:\www）。现在单击 [b]File > New > Project[/b]。会弹出 New Project 向导。双击 PHP 文件夹并选择 PHP Project。单击 [b]Next[/b]，输入项目名称 debugArticle，并单击 [b]Finish[/b]。
如果把 Web 服务器设置为在端口 80 上侦听，那么不需要做任何修改。否则，请转到 Navigator 窗口，在 PHP 项目 [b]debugArticle[/b] 上右击，选择 Properties，然后单击 [b]PHP Project Settings[/b]。单击 [b]Configure Workspace Settings[/b] 然后修改合适的 localhost 或者添加 Web 服务器侦听的端口（例如 http://localhost:8080）。单击 [b]Apply[/b] 完成设置。
Navigator 窗口应当显示项目和一个 .project 文件。在项目上右击，就像前面做的那样，只是这次选择 [b]New > PHP File[/b]。用想要创建的 PHP 文件的名称 test3.php 替换 *.php，然后单击 [b]Finish[/b]。在 Eclipse IDE 中应当出现一个新文件。可能需要导航到窗口底部的 PHP 浏览器来查看 PHP 文件的当前输出（参见图 5）。
[b]图 5. Eclipse 的 PHPEclipse 插件[/b]
[img=572,322]http://image.21tx.com/image/20060125/18780.jpg[/img]
注意，只有 Windows? 的用户可以像清单 5 所示的那样使用 PHP 浏览器。通过打开独立浏览器窗口并把浏览器指向测试脚本所在目录，也可以使用同样的功能。
现在来演示这个应用程序，证明它的强大能力。
在 “使用调试器” 一节中，将学习如何用 Eclipse、PHPEclipse 和前面下载的调试器 PHP 扩展来调试 PHP 应用程序。先从学习如何使用它的语法解析功能开始。
[b]语法解析和加下划线[/b]
先从查看 PHPEclipse 如何提供帮助调试 PHP 应用程序的实时语法解析功能开始。要看这个特性的实际应用，先从在 Eclipse 中定义 test3.php 开始，如下所示。
[table=98%,#e3e3e3][tr][td] <?php print(,"Hello World!"); ?> [/td][/tr][/table]
注意，在清单 4 中加下划线的两个字符在 Eclipse 中加了下划线，提示语法不正确。按 [b]Ctrl+S[/b] 保存文件，会在 Eclipse 中显示解析错误：在代码中与解析错误对应的行上会加上红 “x”，如图 6 所示。
[b]图 6. 语法错误强调[/b]
[img=572,322]http://image.21tx.com/image/20060125/18782.jpg[/img]
现在演示 PHP 浏览器。这个窗口提供了当前 PHP 脚本的预览，如图 6 所示。
从上面定义的 test3.php 中删除逗号（,）。按 [b]Ctrl+S[/b] 保存文件，然后观察 PHP 浏览器窗口的更新，显示了 Hello World（参见图 7）。
[b]图 7. 在 PHPEclipse 中预览 PHP 脚本[/b]
[img=572,322]http://image.21tx.com/image/20060125/18788.jpg[/img]
下面是用调试器在 PHP 中设置断点。
[b]使用调试器
[/b] 使用调试器，可以设置断点并查看 PHP 代码到所设断点之前的浏览器输出。然后可以继续代码的执行并查看到下一断点之前的浏览器输出，然后再到下一个，直到 PHP 脚本完成。
现在把 “设置” 一节中在 php.ini 中注释掉的行取消注释，并重新启动 Apache。现在装入了调试器，Eclipse 能够和它挂上了。
现在在 Eclipse 中设计调试环境。请创建新的 test4.php 文件，先保持为空。现在单击 [b]Run > Debug[/b]。在左侧面板中选择 PHP DBG Script，并单击 [b]New[/b]。现在转到 [b]File[/b] 选项卡，输入当前项目 [b]debugArticle[/b] 以及想要调试的文件 [b]test4.php[/b]。现在转到 [b]Environment[/b] 选项卡，然后再到 [b]IntERPreter[/b] 子选项卡。在 PHP 的安装目录中找到 php.exe 文件（我的是 c:\apps\php5.0.3\php.exe）。现在单击 [b]Remote Debug[/b] 子选项卡，选择 [b]Remote Debug[/b]，如果没有使用 Windows，请取消 “Open with DBGSession URL in internal browser box” 复选框。把 Remote Source 路径设置成与要测试的 PHP 脚本的绝对路径（不是 Web 路径）相同（我的设置是 c:\www\debugArticle\test4.php）。现在单击 [b]Debug[/b]。
现在应当装入 Debug 透视图，如图 8 所示。否则，请单击 [b]Window > Open Perspective > Other[/b]，并选择 [b]Debug[/b]。
[b]图 8. Eclipse 中的 Debug 透视图[/b]
[img=600,530]http://image.21tx.com/image/20060125/18790.jpg[/img]
现在可以设置断点了。
对于本文中使用的插件和扩展的版本，断点功能是必需的，因为 PHP 在把输出发送到浏览器之前会缓冲它。除此之外，需要做的不仅仅是设置一个断点把当前显示数据刷新到 Web 浏览器，所以要像下面和图 8 所示那样定义 test4.php。
[b]清单 4. 设置和创建断点[/b]
[table=98%,#e3e3e3][tr][td] <?php function break-point(){ ob_flush(); flush(); sleep(.1); debugBreak(); } print("This will get shown first, "); print("as will this<br>"); breakpoint(); print("This won't get shown until after "); print("continuing the break-point<br>"); breakpoint(); print("END!"); ? [/td][/tr][/table]
breakpoint() 函数会把缓冲的输出和其他缓冲的数据刷新到 Web 浏览器。对 sleep(.1) 的调用是必需的，这样代码中止于 debugBreak() 之前，服务器才有足够的时间把数据刷新到 Web 浏览器，这个函数是前面下载的 PHP 调试器扩展的内部函数。这样，调用 breakpoint() 会把 HTML 块、print() 和 echo() 语句的数据刷新到浏览器，然后中止代码执行。
在像清单 4 那样编写完代码之后，可以打开浏览器并指向 test4.php，或者可以查看 PHP 浏览器窗口（我的是 http://localhost/debugArticle/test4.php）。每次输入和保存文件时，在 PHP 浏览器窗口中就已经启动了调试序列。如果不使用 Windows，请通过浏览器查看 test4.php。在保存了文件之后，用 [b]F8[/b] 或单击 [b]Run > Resume[/b] 继续代码执行。持续这么做，直到最后一行输出是 END! 为止（参见图 9、10 和 11）。
[b]图 9. 初始的到第一个断点的 PHP 浏览器输出[/b]
[img=572,538]http://image.21tx.com/image/20060125/18792.jpg[/img]
请注意图 9 中的 Debug 窗口如何把执行显示为挂起的。
[b]图 10. 第一个断点之后到第二个断点之前的 PHP 浏览器输出[/b]
[img=600,564]http://image.21tx.com/image/20060125/18794.jpg[/img]
图 10 的 Debug 窗口仍然把执行显示为挂起，而第二组数据显示在 PHP 浏览器中。
[b]图 11. 完整的 PHP 浏览器输出[/b]
[img=572,538]http://image.21tx.com/image/20060125/18801.jpg[/img]
注意，图 11 的 Debug 窗口中的代码不再挂起，整个脚本已经执行，如图 11 中的 PHP 浏览器所示。
既然已经看到了用 PHPEclipse 和调试器扩展进行开发的优势，那么很难想像没有它会怎么样。
[b]结束语[/b]
现在已经向 PHP 的调试技术集中添加了错误报告的运用、print 语句、PHPEclipse 和调试器扩展，您可以通过减少每行代码的错误数量，成为更有效的 PHP 编码人员。请参阅 参考资料 获得一些 PHP 教程，可以在上面测试这些新技能。
京公网安备 11010502030800号