PHPUnit断言引发了异常？

Question

有谁知道是否有assert或类似的东西，可以测试是否在被测试的代码中抛出异常？

Answer 1

<?php 
require_once 'PHPUnit/Framework.php'; 

class ExceptionTest extends PHPUnit_Framework_TestCase 
{ 
    public function testException() 
    { 
     $this->expectException(InvalidArgumentException::class); 
     // or for PHPUnit < 5.2 
     // $this->setExpectedException(InvalidArgumentException::class); 

     //...and then add your test code that generates the exception 
     exampleMethod($anInvalidArgument); 
    } 
} 

expectException() PHPUnit documentation

PHPUnit author article提供测试异常的最佳做法的详细说明。

Answer 2

你也可以使用一个docblock annotation：

class ExceptionTest extends PHPUnit_Framework_TestCase 
{ 
    /** 
    * @expectedException InvalidArgumentException 
    */ 
    public function testException() 
    { 
     ... 
    } 
} 

对于PHP 5.5+（特别是与命名空间中的代码），我现在更喜欢用下面::class

Answer 3

代码将测试异常消息和异常代码。

重要提示：如果预期的异常没有被抛出，它将会失败。

try{ 
    $test->methodWhichWillThrowException();//if this method not throw exception it must be fail too. 
    $this->fail("Expected exception 1162011 not thrown"); 
}catch(MySpecificException $e){ //Not catching a generic Exception or the fail function is also catched 
    $this->assertEquals(1162011, $e->getCode()); 
    $this->assertEquals("Exception Message", $e->getMessage()); 
} 

Answer 4

您可以使用assertException extension在一次测试执行期间声明多个异常。

方法插入到你的测试用例和使用：

public function testSomething() 
{ 
    $test = function() { 
     // some code that has to throw an exception 
    }; 
    $this->assertException($test, 'InvalidArgumentException', 100, 'expected message'); 
} 

我还做了好看的代码爱好者trait ...

Answer 5

public function testException() { 
    try { 
     $this->methodThatThrowsException(); 
     $this->fail("Expected Exception has not been raised."); 
    } catch (Exception $ex) { 
     $this->assertEquals($ex->getMessage(), "Exception message"); 
    } 

} 

Answer 6

如果你在运行PHP 5.5+，您可以使用::class resolution来获取expectException/setExpectedException的课程名称。这提供了几个好处：

• 该名称将完全限定其名称空间（如果有）。
• 它解析为string，因此它可以与任何版本的PHPUnit一起使用。
• 您在IDE中获得代码完成。
• 如果您输错类名称，PHP编译器会发出错误。

实施例：

namespace \My\Cool\Package; 

class AuthTest extends \PHPUnit_Framework_TestCase 
{ 
    public function testLoginFailsForWrongPassword() 
    { 
     $this->expectException(WrongPasswordException::class); 
     Auth::login('Bob', 'wrong'); 
    } 
} 

PHP编译

WrongPasswordException::class 

成

"\My\Cool\Package\WrongPasswordException" 

而不PHPUnit的是明智的。

注意：PHPUnit 5.2 introducedexpectException作为setExpectedException的替代品。

Answer 7

/** 
* @expectedException Exception 
* @expectedExceptionMessage Amount has to be bigger then 0! 
*/ 
public function testDepositNegative() 
{ 
    $this->account->deposit(-7); 
} 

要非常小心约"/**"，注意双 “*”。只写“* *”（asterix）会使你的代码失败。 也请确保您使用的是phpUnit的最新版本。在phpunit的一些早期版本中，@expectedException异常不受支持。我有4.0，它不适合我，我不得不更新到5.5 https://coderwall.com/p/mklvdw/install-phpunit-with-composer与作曲家更新。

Answer 8

的另一种方式可以是follwing：

$this->expectException(\Exception::class); 
$this->expectExceptionMessage('Expected Exception Message'); 

请确保您的测试类范围\化PHPUnit_Framework_TestCase

Answer 9

这里的所有异常的断言，你可以做。请注意，它们全部是可选。

class ExceptionTest extends PHPUnit_Framework_TestCase 
{ 
    public function testException() 
    { 
     // make your exception assertions 
     $this->expectException(InvalidArgumentException::class); 
     // if you use namespaces: 
     // $this->expectException('\Namespace\MyExceptio‌​n'); 
     $this->expectExceptionMessage('message'); 
     $this->expectExceptionMessageRegExp('/essage$/'); 
     $this->expectExceptionCode(123); 
     // code that throws an exception 
     throw new InvalidArgumentException('message', 123); 
    } 

    public function testAnotherException() 
    { 
     // repeat as needed 
     $this->expectException(Exception::class); 
     throw new Exception('Oh no!'); 
    } 
} 

可以找到文档here。

Answer 10

PHPUnit expectException方法非常不方便，因为它允许每个测试方法只测试一个异常。

我做了这个辅助函数来断言某些函数抛出一个异常：

/** 
* Asserts that the given callback throws the given exception. 
* 
* @param string $expectClass The name of the expected exception class 
* @param callable $callback A callback which should throw the exception 
*/ 
protected function assertException(string $expectClass, callable $callback) 
{ 
    try { 
     $callback(); 
    } catch (\Throwable $exception) { 
     $this->assertInstanceOf($expectClass, $exception); 
     return; 
    } 

    $this->fail('No exception was thrown'); 
} 

这种方式添加到您的测试类，并呼吁：

public function testSomething() { 
    $this->assertException(\PDOException::class, function() { 
     new \PDO('bad:param'); 
    }); 
    $this->assertException(\PDOException::class, function() { 
     new \PDO('foo:bar'); 
    }); 
}