Return to Answer

If you're running on PHP 5.5+, you can use ::class resolution to obtain the name of the class with expectException/setExpectedException. This provides several benefits:

• The name will be fully-qualified with its namespace (if any).
• It resolves to a string so it will work with any version of PHPUnit.
• You get code-completion in your IDE.
• The PHP compiler will emit an error if you mistype the class name.

Example:

namespace \My\Cool\Package;

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

PHP compiles

WrongPasswordException::class

into

"\My\Cool\Package\WrongPasswordException"

without PHPUnit being the wiser.

Note: PHPUnit 5.2 introduced expectException as a replacement for setExpectedException.

If you're running on PHP 5.5+, you can use ::class resolution to obtain the name of the class with expectException/setExpectedException. This provides several benefits:

• The name will be fully-qualified with its namespace (if any).
• It resolves to a string so it will work with any version of PHPUnit.
• You get code-completion in your IDE.
• The PHP compiler will emit an error if you mistype the class name.

Example:

namespace \My\Cool\Package;

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

PHP compiles

WrongPasswordException::class

into

"\My\Cool\Package\WrongPasswordException"

without PHPUnit being the wiser.

Note: PHPUnit 5.2 introduced expectException as a replacement for setExpectedException.

If you're running on PHP 5.5+, you can use ::class resolution to obtain the name of the class with expectException (Introduced in PHPUnit >= 5.2). This provides several benefits:

• The name will be fully-qualified with its namespace (if any).
• It resolves to a string so it will work with any version of PHPUnit.
• You get code-completion in your IDE.
• The PHP compiler will emit an error if you mistype the class name.

Example:

namespace \My\Cool\Package;

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

PHP compiles

WrongPasswordException::class

into

"\My\Cool\Package\WrongPasswordException"

without PHPUnit being the wiser.

Note: As expectException method was introduced with PHPUnit 5.2. You have to use setExpectedException in older versions.

If you're running on PHP 5.5+, you can use ::class resolution to obtain the name of the class with expectException/setExpectedException. This provides several benefits:

• The name will be fully-qualified with its namespace (if any).
• It resolves to a string so it will work with any version of PHPUnit.
• You get code-completion in your IDE.
• The PHP compiler will emit an error if you mistype the class name.

Example:

namespace \My\Cool\Package;

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

PHP compiles

WrongPasswordException::class

into

"\My\Cool\Package\WrongPasswordException"

without PHPUnit being the wiser.

Note: PHPUnit 5.2 introduced expectException as a replacement for setExpectedException.

If you're running on PHP 5.5 and above, you can use ::class resolution to obtain the name of the class with expectException*. This provides several benefits:

• The name will be fully-qualified with its namespace (if any).
• It resolves to a string so it will work with any version of PHPUnit.
• You get code-completion in your IDE.
• The PHP compiler will emit an error if you mistype the class name.

Example:

namespace \My\Cool\Package;

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

PHP compiles

WrongPasswordException::class

into

"\My\Cool\Package\WrongPasswordException"

without PHPUnit being the wiser.

* You must use setExpectedException in older versions of PHPUnit.

If you're running on PHP 5.5+, you can use ::class resolution to obtain the name of the class with expectException (Introduced in PHPUnit >= 5.2). This provides several benefits:

• The name will be fully-qualified with its namespace (if any).
• It resolves to a string so it will work with any version of PHPUnit.
• You get code-completion in your IDE.
• The PHP compiler will emit an error if you mistype the class name.

Example:

namespace \My\Cool\Package;

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

PHP compiles

WrongPasswordException::class

into

"\My\Cool\Package\WrongPasswordException"

without PHPUnit being the wiser.

Note: As expectException method was introduced with PHPUnit 5.2. You have to use setExpectedException in older versions.