在 PHPUnit 中重新运行上次失败的测试

Question

当其中一个测试失败时，您可以使用 --stop-on-failure 标志来中断单元测试。

有没有什么方法可以快速告诉 PHPUnit 重新运行这个失败的测试，而不是手动提供完整路径？

Answer 1

自 PHPUnit 7.3 起，您可以缓存测试结果，然后按缺陷对测试进行排序。

在 phpunit.xml 中，启用 cacheResults：

<?xml version="1.0" encoding="UTF-8"?>
<phpunit cacheResult="true"
         ...>

如果您不想编辑 phpunit.xml，您还可以使用 --cache-result 标志运行测试。

缓存结果时，PHPUnit 将在运行测试后创建一个 .phpunit.result.cache 文件。确保将此文件添加到您的全局 gitignore 文件中。

您可以像这样运行测试以首先运行以前失败的测试：

phpunit --order-by=defects --stop-on-failure

Answer 2

查看 --filter cli 选项。您可以在组织文档和 命令行界面文档。

--过滤器

仅运行名称与给定模式匹配的测试。该模式可以是单个测试的名称，也可以是匹配多个测试名称的正则表达式。

假设您的运行 phpunit Tests/ 和 Tests/Stuff/ThatOneTestClassAgain::testThisWorks 失败：

您的选项是：

phpunit --filter ThatOneTestClassAgain

和

phpunit --filter testThisWorks

或大多数其他有意义的字符串

Answer 3

我发现实现它的方法相当简单，但需要实现日志记录。您设置 phpunit 来记录到 json 文件。然后将 phpunit 命令更改为类似以下内容：

cd /home/vagrant/tests && php -d auto_prepend_file=./tests-prepend.php /usr/local/bin/phpunit

其作用是在执行 phpunit 之前 auto_prepend 一个 php 文件。这样我们就可以捕获 $argsv 并自动向 phpunit 提供所需的过滤命令。

tests-prepend.php
（请务必修改json日志的文件路径）

<?php

global $argv, $argc;
if(empty($argv) === false) {
    // are we re-running?
    $has_rerun = false;
    foreach ($argv as $key => $value) {
        if($value === '--rerun-failures') {
            $has_rerun = true;
            unset($argv[$key]);
            break;
        }
    }
    if($has_rerun === true) {
        // validate the path exists and if so then capture the json data.
        $path = realpath(dirname(__FILE__).'/../logs/report.json');
        if(is_file($path) === true) {
            // special consideration taken here as phpunit does not store the report as a json array.
            $data = json_decode('['.str_replace('}{'.PHP_EOL, '},{'.PHP_EOL, file_get_contents($path).']'), true);
            $failed = array();
            // capture the failures as well as errors but taking care not to capture skipped tests.
            foreach ($data as $event) {
                if($event['event'] === 'test') {
                    if($event['status'] === 'fail') {
                        $failed[] = array($event['test'], 'failed');
                    }
                    elseif($event['status'] === 'error' && $event['trace'][0]['function'] !== 'markTestIncomplete') {
                        $failed[] = array($event['test'], 'error\'d');
                    }
                }
            }
            if(empty($failed) === true) {
                echo 'There are no failed tests to re-run.'.PHP_EOL.PHP_EOL;
                exit;
            }
            else{
                echo '--------------------------------------------------------------------'.PHP_EOL;
                echo 'Re-running the following tests: '.PHP_EOL;
                foreach ($failed as $key => $test_data) {
                    echo ' - '.$test_data[0].' ('.$test_data[1].')'.PHP_EOL;
                    // important to escapre the namespace backslashes.
                    $failed[$key] = addslashes($test_data[0]);
                }
                echo '--------------------------------------------------------------------'.PHP_EOL.PHP_EOL;
            }
            $argv[] = '--filter';
            $argv[] = '/('.implode('|', $failed).')/';
            // important to update the globals in every location.
            $_SERVER['argv'] = $GLOBALS['_SERVER']['argv'] = $GLOBALS['argv'] = $argv = array_values($argv);
            $_SERVER['argc'] = $GLOBALS['_SERVER']['argc'] = $GLOBALS['argc'] = $argc = count($argv);
        }
        else{
            echo 'The last run report log at '.$path.' does not exist so it is not possible to re-run the failed tests. Please re-run the test suite without the --rerun-failures command.'.PHP_EOL.PHP_EOL;
            exit;
        }
    }
}