今年的英国PHP TestFest于9月11日在曼彻斯特的MadLab举行。我是12位一起学习测试PHP语言的人之一。因此,我认为我将整理本届会议期间遇到的一些事情。
在创建测试之前,需要设置测试环境,您可以通过转到TestFest网站并执行有关设置系统以测试PHP的教程来完成此操作。完成测试环境的设置后,您将有一个包含三个文件夹的文件夹,分别是php52,php53和php-trunk,它们是可以测试的PHP的不同版本,尽管我们将重点介绍php53版本。本文将相同的做法用于其他中继。
设置测试环境时,您要做的最后一件事是设置一个名为TEST_PHP_EXECUTABLE的全局变量。这将指向您要测试的PHP可执行文件,并允许您在同一台计算机上运行PHP服务器并测试PHP。
export TEST_PHP_EXECUTABLE=php53/sapi/cli/php
您可以像现在一样运行PHP测试,但是最好的办法是使用代码覆盖率重新编译PHP,以便每次添加测试时,我们都可以看到我们正在测试的内容以及它在PHP源代码中的运行方式。要在启用代码覆盖率的情况下重新编译PHP,请运行带有enable-gcov标志的configure命令。
./configure --enable-gcov
与其每次都编译和测试所有内容,不如禁用所有内容并仅启用代码覆盖范围,可能会更容易。可以通过使用以下选项来完成。
./configure --disable-all --enable-gcov
一旦配置了PHP实例,就需要再次创建它。由于缺少LTP软件包,我们中的许多人在使PHP无法使用--enable-gcov开关进行编译时遇到了麻烦。如果发生此错误,我们发现可以通过使用sudo apt-get install lcov命令安装lcov库来轻松修复它。当时我正在使用Ubuntu,因此我可以在Synaptic软件包管理器中找到所需的软件包。
编译完PHP后,就可以停止。无需运行make install命令,因为我们将在本地处理PHP可执行文件。
在PHP的每个版本目录中,您都可以找到一个名为run-tests.php的文件。该脚本将允许您运行所有可用的PHP测试,您需要使用刚刚编译的PHP客户端来运行它,如下所示:
sapi/cli/php run-tests.php
这将测试整个代码库,并为整个代码库生成一个代码覆盖率报告。我应该警告您,此操作可能需要花费相当长的时间,因为根据您要查找的版本目录,可以进行7-9,000多个测试。运行测试时,最好一次只运行一个或几个测试,而不是数百个,因为这将帮助您确保测试已经编写完毕。
要仅测试PHP代码的一小部分,您可以运行脚本并传入要测试的目录(甚至文件)的参数。例如,要仅测试sql扩展中可用的测试,您可以执行此操作。
sapi/cli/php run-tests.php ext/spl
Ben Longden非常友好,可以共享一个使用run-tests.php来测试版本目录的脚本,但是随后它还继续生成我们在启用gcov的情况下重新编译PHP时想要创建的代码覆盖率报告。
ROOT='/home/bl/Development/php/php-src/branches/' BRANCH='PHP_5_2' BASE_DIR="$ROOT/$BRANCH" TEST_PHP_EXECUTABLE="$BASE_DIR/sapi/cli/php" TESTS='ext/spl' $TEST_PHP_EXECUTABLE $BASE_DIR/run-tests.php $BASE_DIR/$TESTS lcov -directory $BASE_DIR/$TESTS -c -o tests.info genhtmltests.info-o coverage firefox coverage/index.html
您可以将其保存为所需的任何内容,但是要运行此脚本,您首先需要进行测试。为此,您需要能够读取一点C代码,这是在调用PHP函数时运行的。查看GCOV网站上有关DNS功能的LCOV报告。您会注意到,每一行代码都以两种方式之一着色。蓝线表示代码已由测试执行,红线表示该行尚未由测试执行。未进行颜色编码的行将不会在常规代码执行期间运行,这些注释和语句之类的东西。
我们在PHP测试中运行的实际代码是PHP,因此我们需要以某种方式解密大量的红色和蓝色代码行,并将其转换为可以测试的PHP函数。您需要寻找的是PHP函数包装器,这些将C代码映射到PHP函数调用。以gethostname()DNS函数中的PHP函数为例。
通过给它们提供参数来更改PHP中的许多函数,这些参数由PHP使用C函数进行解析zend_parse_parameters()。因此,如果您在源代码中看到此函数,则可以假定该函数至少带有一个参数。就足以理解如何运行PHP代码而言,重要的参数及其后的所有内容都是该函数的重要组成部分。PHP使用第三个参数来确定已将哪些类型的数据传递给该函数。以PHP函数中的以下示例为例dns_check_record()。
这里的第三个参数是“ s | s”,这意味着可以将两个字符串传递给该函数。每次将字符串传递给此函数时,两个参数均通过引用传递。第一个是实际的字符串本身,第二个是该字符串的长度。因此,由于上面的函数调用包含两个字符串,因此将创建四个变量。
这不是您必须阅读的代码范围,有时,只有仔细阅读了什么PHP函数以及在什么情况下,您才能运行代码的特定部分。但是,有很多红线可以开始使用。
现在我们准备测试一些PHP代码,为此,我们需要创建phpt文件并使用run-tests.php运行它们。这些文件是独立的单元测试文件,每个文件都应用于测试单个操作。该文件分为多个部分,这些部分通过添加不同的标题来创建。解释phpt文件结构的最佳方法是显示一个示例。以下文件用于测试该dns_get_record()函数是否返回数组。
--TEST-- dns_get_record() function - basic type return test --CREDITS-- Philip Norton #!code www.hashbangcode.com --FILE-- <?php var_dump(is_array(dns_get_record("www.example.com"))); ?> --EXPECT-- bool(true)
为了保持一致性,您应该使用以下文件名模板创建测试文件。测试的类型将是基本的,变体,错误或错误之类的东西,并且将用于让另一位测试人员知道该测试将构成哪种类型的东西。例如,基本测试将仅使用默认参数测试功能,该功能的可选参数将包含在变型测试中。
<function_name>_<type>_<number>.phpt
上面的示例可能保存为dns_get_record_basic_001.phpt,因为我们没有将任何可选参数传递给函数调用。我不会在这里详细介绍PHP测试文件,但是,如果您有兴趣,请查看PHP QA网站上的“ PHPT-测试文件布局”页面。
要运行测试,您可以使用标准的run-tests.php,如下所示:
:$ /php53/sapi/cli/php /php53/run-tests.php /php53/svn/testfest2010/
或者,您可以使用上面打印的脚本来运行测试文件,生成代码覆盖率报告并在Firefox中打开它。
要注意的一件事是测试失败时会发生什么。如果发生这种情况,那么测试脚本将创建一堆文件。这是生成的文件及其每个文件的列表。所有这些文件将具有与原始测试文件相同的名称,只是具有不同的扩展名。
diff-这是一个差异文件,它将显示代码运行的预期结果与实际结果之间的差异。
EXP -这是您的PHPT文件的预期部分的内容。
日志-此文件包含运行代码的日志以及失败的原因。
out-这是代码运行的实际输出。
php-此文件包含测试期间运行的实际PHP代码,实质上是测试文件的file部分。
当您再次运行测试时,这些文件将被删除,因此无需手动删除它们。
在我们没时间赶往最近的酒吧之前,我们成功地在一天之间写了30至40个测试。总的来说,这是一天的美好时光,也是有经验的人员在现场掌握PHP测试世界的绝妙方法。即使我参加了去年的PHP TestFest,我实际上还没有编写任何测试,但是我认为这次我可能实际上仍会继续编写测试。
最后,我还要借此机会感谢iBuildings(再次)组织此次活动,甚至免费提供午餐的比萨饼。