适用于 PHP 的 NetBeans IDE 支持 PHPUnit 自动测试。通过 PHPUnit,NetBeans IDE 可为 PHP 提供代码覆盖率,这与 IDE 为 Python 和 Ruby 提供的代码覆盖率类似。测试输出将显示在功能丰富的输出窗口中,该窗口与 IDE 的 JUnit、Ruby 和 Python 测试运行器所使用的输出窗口相同。
NetBeans IDE 还支持将 Selenium 可移植测试框架与 PHPUnit 结合使用。Selenium 插件可以从更新中心获取。安装此插件会将 Selenium 服务器添加到 IDE 的已注册服务器中,并将 Selenium 测试选项添加到 PHP 菜单。
目录
要学习本教程,您需要具备以下软件和资源。
软件或资源 | 要求的版本 |
---|---|
NetBeans IDE | PHP 下载包 |
PHP 引擎,包括 PEAR | 版本 5。 |
Web 服务器 | 推荐使用 Apache HTTP Server 2.2。 |
PHP 调试器 | XDebug 2.0 或更高版本 |
PHPUnit | 版本 3.3.0 或更高版本。 |
安装 PHPUnit
请按照 PHPUnit 文档中所述,使用 PEAR 安装 PHPUnit。应安装 PHPUnit 版本 3.3.0 或更高版本。无需任何特殊设置。安装 PHPUnit 之后,NetBeans 便可识别它。请注意,您需要将 PEAR 随 PHP 引擎一起安装。另请注意,PHPUnit 文档中指出 PHPUnit 通常会安装到本地 PEAR 目录。该文档还给出了具体的路径:/usr/lib/php/PHPUnit;但在适用于 Windows 的 XAMPP 上,此路径为XAMPP_HOME/php/PEAR/PHPUnit。
要检查 NetBeans IDE 是否可识别您的 PHPUnit 安装,请打开“工具”>“选项”(在 Mac 上,请打开“NetBeans 首选项”)并查看 "PHP" 窗口。PHPUnit 脚本的路径应显示在“PHPUnit 脚本”字段中。如果此处未显示脚本路径,请进行浏览以找到该路径。
创建并运行 PHPUnit 测试
NetBeans IDE 可以对某个文件中的所有 PHP 类创建并运行 PHPUnit 测试。为确保测试生成器可以正常运行,请为 PHP 文件指定与该文件中的第一类相同的名称。
为某个类创建并运行 PHPUnit 测试:
- 创建一个名为 Calculator 的 PHP 项目。在此项目中,创建一个名为 Calculator.php 的文件。在此文件中,键入或粘贴 PHPUnit 文档的 "Skeleton Generator"(框架生成器)一章中所提供的 Calculator 类。
<?php class Calculator { public function add($a, $b) { return $a + $b; } } ?>
- 添加一个包含 @assert 标注以及一些样例输入和输出的注释块。请注意,本示例中包括一个错误的断言。
<?php class Calculator { /** * @assert (0, 0) == 0 * @assert (0, 1) == 1 * @assert (1, 0) == 1 * @assert (1, 1) == 2 * @assert (1, 2) == 4 */ public function add($a, $b) { return $a + $b; } } ?>
- 在“项目”窗口中,右键单击 "Calculator.php" 节点,然后选择“工具”>“创建 PHPUnit 测试”。请注意,您可以在“源文件”节点的上下文菜单中为项目中的所有文件创建测试。
- 第一次创建测试时,将会打开一个对话框,询问您要存储测试文件的目录。在本示例中,使用“浏览”功能创建了 tests 目录。
- IDE 将在一个名为 CalculatorTest.php 的文件中生成框架测试类,在“项目”窗口中会显示该文件,并在编辑器中将其打开。
请注意,将为每个 @assert 标注创建一个测试。
/** * Generated from @assert (1, 1) == 2. */ public function testAdd4() { $this->assertEquals( 2, $this->object->add(1, 1) ); }
- 您既可以测试单个文件,也可以测试整个项目。要测试项目,请右键单击项目的父节点,然后选择“测试”或按 Alt-F6 组合键。要测试 Calculator.php 文件,请右键单击该文件的节点,然后选择“测试”或按 Ctrl-F6 组合键。本示例只有一个文件,且该文件中只有一个类,因此两种测试结果相同。IDE 会运行测试并在“测试结果”窗口中显示结果。
测试结果的更详细文本版本会显示在“输出”窗口中。
测试结果和 IDE 输出
PHPUnit 测试的结果会显示在 IDE 的“测试结果”和“输出”两个窗口中。“测试结果”窗口包含一个图形窗格和一个简短文本窗格。“输出”窗口提供了输出的更详细文本版本。在此部分,您将详细了解“测试结果”窗口和“输出”窗口。
在“测试结果”窗口中,您可以从下列位置获取有关失败的测试的信息:
- UI 窗格中失败测试的树条目所附带的消息
- 右侧窗格中的文本,其中包括指向失败的测试代码行的链接
- 将光标悬停在 UI 窗格中失败的测试上时显示的工具提示文本
“测试结果”窗口在左侧包括以下按钮:
- 重新运行测试按钮
- 在显示所有测试的结果和仅显示失败测试的结果之间进行切换的按钮
- 导航至下一个测试结果的按钮 ,以及导航至上一个测试结果的按钮
“输出”窗口显示 PHPUnit 脚本的完整输出。当您无法通过“测试结果”窗口中的信息找出错误原因时,该窗口会非常有用。与“测试结果”窗口类似,“输出”窗口包括指向失败的测试类行的链接。此外,该窗口还在左侧包括用于重新运行测试的按钮以及用于打开 PHP 选项窗口的按钮。
代码覆盖率
适用于 PHP 的 NetBeans IDE 提供了代码覆盖率以及 PHPUnit 支持。(IDE 也为 Ruby 和 Python 提供了代码覆盖率)。代码覆盖率检查 PHPUnit 测试是否覆盖了所有方法。在此部分,您将了解如何通过现有 Calculator 类来使用代码覆盖率。
使用代码覆盖率:
- 打开 Calculator.php,然后添加内容与 add 函数相同的 add2 函数。现在,Calculator 类将如下所示:
<?php class Calculator { /** * @assert (0, 0) == 0 * @assert (0, 1) == 1 * @assert (1, 0) == 1 * @assert (1, 1) == 2 * @assert (1, 2) == 4 */ public function add($a, $b) { return $a + $b; } public function add2($a, $b) { return $a + $b; } } ?>
- 右键单击项目节点。从上下文菜单中,选择“代码覆盖率”>“收集并显示代码覆盖率”。缺省情况下,“显示编辑器栏”也会处于选定状态。
- 现在,编辑器会在底部显示代码覆盖率编辑器栏。由于尚未测试代码覆盖率,因此编辑器栏报告覆盖率为 0%。(在单击“清除”以清除测试结果后,编辑器栏也会显示覆盖率为 0%。)
- 单击“测试”以测试打开的文件,或单击“所有测试”以运行项目的所有测试。此时将显示“测试结果”。此外,“代码覆盖率”栏会告知您测试所覆盖的可执行代码语句百分比。在编辑器窗口中,覆盖的代码将以绿色突出显示,未覆盖的代码将以红色突出显示。
- 在编辑器栏中,单击“报告...”。将打开代码覆盖率报告,其中显示了对项目运行的所有测试的结果。使用报告中的按钮,您可以清除结果,再次运行所有测试或取消激活代码覆盖率(单击“完成”)。
- 您可以在项目中添加其他类;删除测试文件,然后重新创建测试文件;接下来,再次查看代码覆盖率报告。此时将会列出新类。在下面的报告中,Calculator 类又有一个函数未包括在测试中。
使用项目特定的配置
在 IDE 中,可以为项目选择以下定制配置:
- 引导文件
- XML 配置文件
- 测试套件
要设置项目特定的配置,请右键单击项目节点或项目的“测试文件”节点,然后选择“属性”。这会打开“属性”对话框。然后选择 PHPUnit 类别。将打开一个对话框,可以在其中选择定制引导、XML 配置或测试套件文件。如果您不熟悉这些文件的结构,可以使用 NetBeans IDE 生成框架。
使用定制类加载器的项目需要引导选项,例如,通过实现 Magic 函数 __autoload()。如果需要预先包含一个文件(如定义项目中的多个类所使用的全局常量的文件),则也需要使用引导选项。
可通过 XML 配置文件定义命令行调用中使用的选项。PHPUnit 手册中提供了完整的介绍。还可以使用 XML 配置文件为测试用例定义 php.ini 设置和全局变量。也可以在 XML 配置文件中设置引导选项。
如果设置定制测试套件,每次选择“运行”>“测试项目”时,都会运行该套件。如果要仅运行一部分测试,或者要使用最近添加(必须手动添加)的 PHPUnit 功能(如数据提供器),该功能特别有用。
请注意,您可以根据需要定义多个测试套件,并通过在项目资源管理器中右键单击文件并选择“运行”来分别运行这些套件。
为防止造成混乱,NetBeans 会通知您是否使用定制测试套件。可以在“测试结果”和“输出”窗口中找到通知。
在 Selenium 框架上运行测试
Selenium 是一种测试 Web 应用程序框架的可移植软件。这些测试可以编写为 HTML 表,或以各种常用的编程语言进行编码,并且可以直接在目前的多数 Web 浏览器中运行。Selenium 可以部署在 Windows、Linux 和 Macintosh 上。有关更多详细信息,请参见 Selenium Web 站点。
NetBeans IDE 具有包含 Selenium 服务器的插件。通过此插件,您可以对 PHP、Web 应用程序或 Maven 项目运行 Selenium 测试。要对 PHP 运行 Selenium 测试,需要将 Testing Selenium 软件包安装到 PHP 引擎。
对 PHP 运行 Selenium 测试:
- 打开命令提示符,然后运行 pear install Testing_Selenium-beta 命令。您需要在 Path 变量中包含 PHP_HOME/php/PEAR。如果成功运行该命令,则将显示以下提示:install ok: channel://pear.php.net/Testing_Selenium-0.4.3。
- 在 IDE 中,打开“工具”>“插件”,然后安装 "Selenium Module for PHP"。
- 在“项目”窗口中,右键单击 Calculator 项目的节点。选择“新建”>“其他”。打开“新建文件”向导。选择 "Selenium",然后单击“下一步”。
- 第一次创建 Selenium 测试时,将会打开一个对话框,要求您设置 Selenium 测试文件的目录。此目录应不同于 PHPUnit 测试文件的目录。否则,每次运行单元测试时,Selenium 测试都会运行。运行 Selenium 之类的功能测试通常比运行单元测试所花费的时间长,因此在每次运行单元测试时,您可能不会希望运行这些测试。
- 接受“名称和位置”页中的缺省设置,然后单击“完成”。将在编辑器中打开新 Selenium 测试文件,并在“项目”窗口中显示该文件。
- 现在,“运行 Selenium 测试”项已添加到项目的上下文菜单中。单击此项,将在与 PHPUnit 测试相同的“测试结果”窗口中显示 Selenium 测试结果。