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'); 
    }); 
}