How to force a failure with phpunit

Question

Is there a more official way to force a phpunit failure than $this->assertTrue(false)?

score 122 · Accepted Answer · answered Nov 12 '10 at 16:21

122

I believe this should work within a test case:

$this->fail('Message');

answered Nov 12 '10 at 16:21

rr.

6,484
9
40
48

4

The $this->fail() will stop the execution of the test, so this shouldn't be used as a replacement to assertions to display a message if you have multiple assertions in your test. – Prusprus Sep 30 '12 at 18:00
2

Passing an exception to `fail` will result in a nice stacktrace – Koen. Sep 09 '15 at 21:15
is there an opposite function of `$this->fail()`? – emfi May 14 '18 at 09:17
3

@emfi - yes, ````return;````. – HappyDog Aug 27 '18 at 20:54
If you just `return;`, you will probably also need the `@doesNotPerformAssertions` annotation. – Nye Dec 09 '21 at 17:14

Arpan Buch · Answer 2 · 2013-08-23T10:18:26.810

3

Yes, theres a way,

$this->fail("your message");

if you want to see the page u have failed than

print_r(getResponse()->getContent());

edited Aug 23 '13 at 10:18

answered Aug 21 '13 at 11:36

Arpan Buch

1,380
5
19
41

4

`getResponse()` is a framework specific function, which may not be generally available. – bishop Aug 12 '16 at 17:07

score 3 · Answer 3 · answered Apr 22 '16 at 12:18

Another way to do it (especially helpful when writing a testing tool) would be:

use PHPUnit_Framework_ExpectationFailedException as PHPUnitException;

try {
    // something here
} catch (SpecificException $e) {
    // force a fail:
    throw new PHPUnitException("This was not expected.");
}

How to force a failure with phpunit

3 Answers3