如何让 phpunit 从文件夹中的所有文件运行测试？

Question

根据我的阅读，似乎我应该能够设置一个文件夹，例如tests/ ，将一些带有单元测试类的文件放入其中，然后在该文件上运行 phpunit 并让它找到并运行测试。

无论出于何种原因，在我的安装中（在 OS X 上），它认为文件夹 tests/ 是一个文件，或者看起来是这样的：

$ ls tests
test1.php test2.php
$ phpunit tests/test1.php
PHPUnit 3.5.3 by Sebastian Bergmann.

F

Time: 0 seconds, Memory: 5.00Mb

There was 1 failure:

1) FailingTest::testFail
Your test successfully failed!

/Users/****/tmp/tests/test1.php:4

FAILURES!
Tests: 1, Assertions: 0, Failures: 1.
$ phpunit tests/test2.php
PHPUnit 3.5.3 by Sebastian Bergmann.

.

Time: 0 seconds, Memory: 5.00Mb

OK (1 test, 1 assertion)
$ phpunit tests
PHP Fatal error:  Uncaught exception 'PHPUnit_Framework_Exception' with message 'Neither "tests.php" nor "tests.php" could be opened.' in /usr/local/PEAR/PHPUnit/Util/Skeleton/Test.php:102
Stack trace:
#0 /usr/local/PEAR/PHPUnit/TextUI/Command.php(157): PHPUnit_Util_Skeleton_Test->__construct('tests', '')
#1 /usr/local/PEAR/PHPUnit/TextUI/Command.php(129): PHPUnit_TextUI_Command->run(Array, true)
#2 /usr/local/bin/phpunit(53): PHPUnit_TextUI_Command::main()
#3 {main}
  thrown in /usr/local/PEAR/PHPUnit/Util/Skeleton/Test.php on line 102

Fatal error: Uncaught exception 'PHPUnit_Framework_Exception' with message 'Neither "tests.php" nor "tests.php" could be opened.' in /usr/local/PEAR/PHPUnit/Util/Skeleton/Test.php:102
Stack trace:
#0 /usr/local/PEAR/PHPUnit/TextUI/Command.php(157): PHPUnit_Util_Skeleton_Test->__construct('tests', '')
#1 /usr/local/PEAR/PHPUnit/TextUI/Command.php(129): PHPUnit_TextUI_Command->run(Array, true)
#2 /usr/local/bin/phpunit(53): PHPUnit_TextUI_Command::main()
#3 {main}
  thrown in /usr/local/PEAR/PHPUnit/Util/Skeleton/Test.php on line 102

我希望在 OS X Snow Leopard 上按照这些说明 http://www.newmediacampaigns.com/page/install-pear-phpunit-xdebug-on-macosx-snow-leopard，通过 PEAR 进行相当标准的 phpunit 安装。

$ pear version
PEAR Version: 1.9.1
PHP Version: 5.3.2
Zend Engine Version: 2.3.0
Running on: **** 10.4.0 Darwin Kernel Version 10.4.0: Fri Apr 23 18:28:53 PDT 2010; root:xnu-1504.7.4~1/RELEASE_I386 i386
$ phpunit --version
PHPUnit 3.5.3 by Sebastian Bergmann.

我希望其他人遇到这个问题，这只是一个简单的修复，或者我只是做错了什么？

Answer 1

这不是错误，这是一个特性。

您有一个充满 .php 文件的目录，在您的情况下，它们都包含测试用例。

但是随着您的测试套件的增长，您可能希望在测试目录中包含其他 php 文件，这些文件不包含测试，仅用于支持测试。这些文件不应该由 PHPUnit 本身执行。

这是一种非常常见的情况。

那么 PHPUnit 怎么知道它需要运行哪些文件，哪些不需要呢？ 检查文件名后缀是一种选择 - 默认情况下，PHPUnit 将名称以 Test.php 结尾的所有内容视为测试并忽略其他所有内容。

如果你真的愿意，你可以改变这种行为——通过在你的测试目录中创建一个名为 phpunit.xml 的文件，其中包含以下内容

<?xml version="1.0" encoding="utf-8" ?>
<phpunit>
<testsuite name='Name your suite'>
    <directory suffix='.php'>./</directory>
</testsuite>
</phpunit>

完成后，PHPUnit 将运行所有文件名末尾带有“.php”的文件 （在这种情况下，文件扩展名被认为是文件名的一部分）

但最好习惯于约定并相应地命名您的测试。

Answer 2

在文件夹上运行测试的更简单方法是在所有测试的末尾添加“Test.php”并像这样运行 phpunit 指定你的文件夹

phpunit .

或

phpunit your_test_folder/.

Answer 3

烦人的小怪癖，但我想通了。

至少在默认配置下，测试文件必须以“Test.php”结尾，例如。 fooTest.php，或者测试运行器找不到它们。