PHPUnit\Framework\Constraint\Constraint Class Reference

Inheritance diagram for PHPUnit\Framework\Constraint\Constraint:

Detailed Description

Abstract base class for constraints which can be applied to any value.

Public Member Functions
	evaluate ($other, string $description='', bool $returnResult=false)
	count ()
Public Member Functions inherited from PHPUnit\Framework\SelfDescribing
	toString ()

Protected Member Functions
	exporter ()
	matches ($other)
	fail ($other, $description, ComparisonFailure $comparisonFailure=null)
	additionalFailureDescription ($other)
	failureDescription ($other)

Member Function Documentation

additionalFailureDescription()

PHPUnit\Framework\Constraint\Constraint::additionalFailureDescription (   $other )

protected

Return additional failure description where needed

The function can be overridden to provide additional failure information like a diff

Parameters

mixed

$other

evaluated value or object

Reimplemented in PHPUnit\Framework\Constraint\StringMatchesFormatDescription.

count()

PHPUnit\Framework\Constraint\Constraint::count

(

)

Counts the number of constraint elements.

Reimplemented in PHPUnit\Framework\Constraint\LogicalNot, PHPUnit\Framework\Constraint\LogicalXor, PHPUnit\Framework\Constraint\LogicalAnd, PHPUnit\Framework\Constraint\LogicalOr, PHPUnit\Framework\Constraint\Composite, PHPUnit\Framework\Constraint\IsAnything, and CountConstraint.

evaluate()

PHPUnit\Framework\Constraint\Constraint::evaluate	(		$other,
		string	$description = '',
		bool	$returnResult = false
	)

Evaluates the constraint for parameter $other

If $returnResult is set to false (the default), an exception is thrown in case of a failure. null is returned otherwise.

If $returnResult is true, the result of the evaluation is returned as a boolean value instead: true in case of success, false in case of a failure.

Exceptions

ExpectationFailedException

Reimplemented in PHPUnit\Framework\Constraint\LogicalNot, PHPUnit\Framework\Constraint\IsEqual, PHPUnit\Framework\Constraint\LogicalAnd, PHPUnit\Framework\Constraint\LogicalOr, PHPUnit\Framework\Constraint\LogicalXor, PHPUnit\Framework\Constraint\TraversableContainsOnly, PHPUnit\Framework\Constraint\ArraySubset, PHPUnit\Framework\Constraint\IsIdentical, PHPUnit\Framework\Constraint\Attribute, PHPUnit\Framework\Constraint\Composite, and PHPUnit\Framework\Constraint\IsAnything.

exporter()

PHPUnit\Framework\Constraint\Constraint::exporter ( )

protected

fail()

PHPUnit\Framework\Constraint\Constraint::fail (   $other,   $description, ComparisonFailure  $comparisonFailure = null  )

protected

Throws an exception for the given compared value and test description

Parameters

mixed	$other	evaluated value or object
string	$description	Additional information about the test
ComparisonFailure	$comparisonFailure

Exceptions

ExpectationFailedException

Reimplemented in PHPUnit\Framework\Constraint\JsonMatches.

failureDescription()

PHPUnit\Framework\Constraint\Constraint::failureDescription (   $other )

protected

Returns the description of the failure

The beginning of failure messages is "Failed asserting that" in most cases. This method should return the second part of that sentence.

To provide additional failure information additionalFailureDescription can be used.

Parameters

mixed

$other

evaluated value or object

Exceptions

Reimplemented in PHPUnit\Framework\Constraint\LogicalNot, PHPUnit\Framework\Constraint\IsIdentical, PHPUnit\Framework\Constraint\Count, PHPUnit\Framework\Constraint\ArraySubset, PHPUnit\Framework\Constraint\TraversableContains, PHPUnit\Framework\Constraint\ArrayHasKey, PHPUnit\Framework\Constraint\TraversableContainsEqual, PHPUnit\Framework\Constraint\Attribute, PHPUnit\Framework\Constraint\TraversableContainsIdentical, PHPUnit\Framework\Constraint\ClassHasAttribute, PHPUnit\Framework\Constraint\IsInstanceOf, PHPUnit\Framework\Constraint\ExceptionMessageRegularExpression, PHPUnit\Framework\Constraint\Exception, PHPUnit\Framework\Constraint\ExceptionMessage, PHPUnit\Framework\Constraint\IsJson, PHPUnit\Framework\Constraint\IsEmpty, PHPUnit\Framework\Constraint\ExceptionCode, PHPUnit\Framework\Constraint\StringMatchesFormatDescription, PHPUnit\Framework\Constraint\DirectoryExists, PHPUnit\Framework\Constraint\FileExists, PHPUnit\Framework\Constraint\IsReadable, and PHPUnit\Framework\Constraint\IsWritable.

matches()

PHPUnit\Framework\Constraint\Constraint::matches (   $other )

protected

Evaluates the constraint for parameter $other. Returns true if the constraint is met, false otherwise.

This method can be overridden to implement the evaluation algorithm.

Parameters

mixed

$other

value or object to evaluate @codeCoverageIgnore

Reimplemented in PHPUnit\Framework\Constraint\IsType, PHPUnit\Framework\Constraint\TraversableContains, PHPUnit\Framework\Constraint\StringContains, PHPUnit\Framework\Constraint\ArrayHasKey, PHPUnit\Framework\Constraint\JsonMatches, PHPUnit\Framework\Constraint\RegularExpression, PHPUnit\Framework\Constraint\TraversableContainsEqual, PHPUnit\Framework\Constraint\TraversableContainsIdentical, PHPUnit\Framework\Constraint\ClassHasAttribute, PHPUnit\Framework\Constraint\IsInstanceOf, PHPUnit\Framework\Constraint\StringStartsWith, PHPUnit\Framework\Constraint\GreaterThan, PHPUnit\Framework\Constraint\LessThan, PHPUnit\Framework\Constraint\Exception, PHPUnit\Framework\Constraint\Count, PHPUnit\Framework\Constraint\StringEndsWith, PHPUnit\Framework\Constraint\Callback, PHPUnit\Framework\Constraint\StringMatchesFormatDescription, PHPUnit\Framework\Constraint\ExceptionMessageRegularExpression, PHPUnit\Framework\Constraint\ClassHasStaticAttribute, PHPUnit\Framework\Constraint\ExceptionMessage, PHPUnit\Framework\Constraint\ExceptionCode, PHPUnit\Framework\MockObject\MethodNameConstraint, PHPUnit\Framework\Constraint\DirectoryExists, PHPUnit\Framework\Constraint\FileExists, PHPUnit\Framework\Constraint\IsEmpty, PHPUnit\Framework\Constraint\IsReadable, PHPUnit\Framework\Constraint\IsWritable, PHPUnit\Framework\Constraint\IsFalse, PHPUnit\Framework\Constraint\IsFinite, PHPUnit\Framework\Constraint\IsInfinite, PHPUnit\Framework\Constraint\IsJson, PHPUnit\Framework\Constraint\IsNan, PHPUnit\Framework\Constraint\IsNull, PHPUnit\Framework\Constraint\IsTrue, PHPUnit\Framework\Constraint\ObjectHasAttribute, CountConstraint, NamedConstraint, FalsyConstraint, and TruthyConstraint.

---

The documentation for this class was generated from the following file:

• vendor/phpunit/phpunit/src/Framework/Constraint/Constraint.php