PHPunit - 测试自定义错误处理类

Question

我想测试我组合在一起的自定义错误处理类，但这本身就带来了一些问题。

首先，由于在测试中设置自定义 error_handler 会覆盖 PHPUnits error_handling ，因此每次更改为自定义实现并进行测试时都必须调用 Restore_error_handler() ，以便任何后续测试都具有 phpunits error_handling 。虽然我承认没有尝试过，也许 PHPUnit 在每次测试后都会重置自己，但我对此表示怀疑。

我有各种配置要在不同的条件下进行测试，即 E_ERROR 、 E_WARNING 等。

然后我有了模拟 error_handler 的想法，但我对测试的模拟方面仍然很陌生。快速的谷歌搜索让我找到了类似的方法，这是以可能适合我的需求的方式修改和实现的想法......

//Create mock with error_handler method
$errorH = $this->getMock ('ErrorHandler', array ('error_handler'));

// error handler should be called at least once
$errorH->expects ($this->atLeastOnce())->method ('error_handler');

// Mock will  need to be configured (here?) and tested 
// against specific error_handling settings 
//  not implemented yet nor needed for this post.

//set mock as error handler for duration of this test
set_error_handler (array($errorH, 'error_handler'));

//test current mock error handler configuration 
// for different conditions-> NOTICE / WARNING / ERROR

// Give phpunit's toy back!
restore_error_handler ();

这是一种有效的方法吗？

Answer 1

无需测试 PHP 的 set_error_handler() 函数。您只关心您的错误处理类是否有效。将 PHP 解释器的测试留给 PHP 开发人员。 :) 像对待任何其他类一样对待您的类：实例化它并调用它的方法，传递参数来测试不同的条件。

例如，假设您的错误处理程序如下所示：

class ErrorHandler
{
    private $logger;

    private $mode;

    public function __construct($mode, $logger) {
        $this->mode = $mode;
        $this->logger = $logger;
    }

    public function handleError($code, $message, $file='', $line=0, $context=array()) {
        if ($code = E_WARNING && $this->mode == 'dev') {
            // warnings are logged in development mode
            $this->logger->log($message, Logger::WARN);
        }
        ...
    }
}

您可以使用模拟记录器来测试上述一项功能，而无需调用 set_error_handler() 或触发实际的 PHP 错误。相反，就像 PHP 在这些条件下所做的那样调用您的错误处理程序：

function testWarningsAreLoggedInDevelopment() {
    $logger = $this->getMock('Logger', array('log'));
    $logger->expects($this->once())
           ->method('log')
           ->with('message', Logger::WARN);
    $handler = new ErrorHandler('dev', $logger);
    $handler->handleError(E_WARNING, 'message');
}

美妙之处在于，如果您的错误处理程序由于错误而触发 PHP 错误，PHPUnit 将捕获它并使测试失败。如果您用自己的处理程序替换 PHPUnit 的处理程序，则可能会进入无限循环，因为 PHP 一遍又一遍地调用您的处理程序，直到解释器因堆栈溢出或内存不足而终止。

Answer 2

David 的答案的一个变体是仅调用 set_error_handler() 如果 PHPUnit 没有运行。有时这是更合适的，具体取决于您的代码的架构方式、您构建的框架、向后兼容性等。

error-handler.php：

// This constant is defined in your `phpunit.xml`, and can be named anything. There are several other ways to detect it as well, see https://stackoverflow.com/questions/10253240/how-to-determine-if-phpunit-tests-are-running
if ( ! defined( 'RUNNING_PHPUNIT_TESTS' ) || ! RUNNING_PHPUNIT_TESTS ) {
    set_error_handler( 'handle_error' );
}

function handle_error( $error_code, $error_message, $file, $line ) {
    if ( foo() ) {
        // stuff...
    }

    return false;
}

function foo() {
    return $whatever;
}

然后，tests/ test-error-handler.php 可以像测试任何其他函数一样测试 foo() 。当 PHPUnit 加载 error-handler.php 时，set_error_handler() 将不会被调用，因此您不必担心您的错误处理程序会干扰 PHPUnit 的错误处理程序。

核心思想仍然是相同的：在包含要测试的文件时，您不希望出现任何副作用（PSR 1.2.3）。