Class TestSuite
A class to contain test cases and run them with shared fixtures
Property Summary
-
$backupGlobals protected
boolEnable or disable the backup and restoration of the $GLOBALS array.
-
$backupStaticAttributes protected
boolEnable or disable the backup and restoration of static attributes.
-
$foundClasses protected
string[] -
$groups protected
arrayThe test groups of the test suite.
-
$name protected
stringThe name of the test suite.
-
$numTests protected
intThe number of tests in the test suite.
-
$runTestInSeparateProcess protected
bool -
$testCase protected
bool -
$tests protected
Test[]The tests in the test suite.
Method Summary
-
__construct() public
Constructs a new TestSuite:.
-
addTest() public
Adds a test to the suite.
-
addTestDirectory() public
Adds all the files in a directory to the test suite. Does not recursive through directories.
-
addTestDirectoryRecursive() public
Recursively adds all the files in a directory to the test suite.
-
addTestFile() public
Wraps both
addTest()andaddTestSuiteas well as the separate import statements for the user's convenience. -
addTestFiles() public
Wrapper for addTestFile() that adds multiple test files.
-
addTestMethod() protected
-
addTestSuite() public
Adds the tests from the given class to the suite.
-
count() public
Counts the number of test cases that will be run by this test.
-
createResult() protected
Creates a default TestResult object.
-
getGroupDetails() public
-
getGroups() public
Returns the test groups of the suite.
-
getIterator() public
Returns an iterator for this test suite.
-
getName() public
Returns the name of the suite.
-
injectFilter() public
-
markTestSuiteSkipped() public
Mark the test suite as skipped.
-
run() public
Runs the tests and collects their result in a TestResult.
-
setBackupGlobals() public
-
setBackupStaticAttributes() public
-
setBeStrictAboutChangesToGlobalState() public
-
setGroupDetails() public
Set tests groups of the test case.
-
setName() public
-
setRunTestInSeparateProcess() public
-
setTests() public
Set tests of the test suite.
-
testAt() public
Returns the test at the given index.
-
tests() public
Returns the tests as an enumeration.
-
toString() public
Returns a string representation of the test suite.
Method Detail
__construct() ¶ public
__construct(ReflectionClass|string $theClass = '', string $name = '')Constructs a new TestSuite:.
-
PHPUnit\Framework\TestSuite() constructs an empty TestSuite.
-
PHPUnit\Framework\TestSuite(ReflectionClass) constructs a TestSuite from the given class.
-
PHPUnit\Framework\TestSuite(ReflectionClass, String) constructs a TestSuite from the given class with the given name.
-
PHPUnit\Framework\TestSuite(String) either constructs a TestSuite from the given class (if the passed string is the name of an existing class) or constructs an empty TestSuite with the given name.
Parameters
-
ReflectionClass|string$theClass optional -
string$name optional
Throws
ExceptionaddTest() ¶ public
addTest(Test $test, array $groups = []): voidAdds a test to the suite.
Parameters
-
Test$test -
array$groups optional
Returns
voidaddTestDirectory() ¶ public
addTestDirectory(string $directory = '.'): voidAdds all the files in a directory to the test suite. Does not recursive through directories.
Parameters
-
string$directory optional The directory to add tests from.
Returns
voidaddTestDirectoryRecursive() ¶ public
addTestDirectoryRecursive(string $directory = '.'): voidRecursively adds all the files in a directory to the test suite.
Parameters
-
string$directory optional The directory subtree to add tests from.
Returns
voidaddTestFile() ¶ public
addTestFile(string $filename): voidWraps both addTest() and addTestSuite
as well as the separate import statements for the user's convenience.
If the named file cannot be read or there are no new tests that can be
added, a PHPUnit\Framework\WarningTestCase will be created instead,
leaving the current test run untouched.
Parameters
-
string$filename
Returns
voidThrows
ExceptionaddTestFiles() ¶ public
addTestFiles(iterable $fileNames): voidWrapper for addTestFile() that adds multiple test files.
Parameters
-
iterable$fileNames
Returns
voidThrows
ExceptionaddTestMethod() ¶ protected
addTestMethod(ReflectionClass $class, ReflectionMethod $method): voidParameters
-
ReflectionClass$class -
ReflectionMethod$method
Returns
voidThrows
ExceptionaddTestSuite() ¶ public
addTestSuite(object|string $testClass): voidAdds the tests from the given class to the suite.
Parameters
-
object|string$testClass
Returns
voidThrows
Exceptioncount() ¶ public
count(bool $preferCache = false): intCounts the number of test cases that will be run by this test.
Parameters
-
bool$preferCache optional
Returns
intcreateResult() ¶ protected
createResult(): TestResultCreates a default TestResult object.
Returns
TestResultgetIterator() ¶ public
getIterator(): IteratorReturns an iterator for this test suite.
Returns
IteratormarkTestSuiteSkipped() ¶ public
markTestSuiteSkipped(string $message = ''): voidMark the test suite as skipped.
Parameters
-
string$message optional
Returns
voidThrows
SkippedTestSuiteErrorrun() ¶ public
run(?TestResult $result = null): TestResultRuns the tests and collects their result in a TestResult.
Parameters
-
?TestResult$result optional
Returns
TestResultThrows
SebastianBergmann\CodeCoverage\InvalidArgumentExceptionSebastianBergmann\RecursionContext\InvalidArgumentExceptionCodeCoverageExceptionCoveredCodeNotExecutedExceptionMissingCoversAnnotationExceptionRuntimeExceptionUnintentionallyCoveredCodeExceptionWarningsetBackupGlobals() ¶ public
setBackupGlobals(bool $backupGlobals): voidParameters
-
bool$backupGlobals
Returns
voidsetBackupStaticAttributes() ¶ public
setBackupStaticAttributes(bool $backupStaticAttributes): voidParameters
-
bool$backupStaticAttributes
Returns
voidsetBeStrictAboutChangesToGlobalState() ¶ public
setBeStrictAboutChangesToGlobalState(bool $beStrictAboutChangesToGlobalState): voidParameters
-
bool$beStrictAboutChangesToGlobalState
Returns
voidsetGroupDetails() ¶ public
setGroupDetails(array $groups): voidSet tests groups of the test case.
Parameters
-
array$groups
Returns
voidsetRunTestInSeparateProcess() ¶ public
setRunTestInSeparateProcess(bool $runTestInSeparateProcess): voidParameters
-
bool$runTestInSeparateProcess
Returns
voidsetTests() ¶ public
setTests(Test[] $tests): voidSet tests of the test suite.
Parameters
-
Test[]$tests
Returns
voidtestAt() ¶ public
testAt(int $index): false|TestReturns the test at the given index.
Parameters
-
int$index
Returns
false|TesttoString() ¶ public
toString(): stringReturns a string representation of the test suite.
Returns
string