Class
ConsoleIntegrationTestCase
A test case class intended to make integration tests of cake console commands easier.
Namespace: Cake\TestSuite
Deprecated: 3.7.0 Will be removed in 5.0.0. Use {@link \Cake\TestSuite\ConsoleIntegrationTestTrait} instead
Property Summary
-
$_appArgs protected
array|null
The customized application constructor arguments.
-
$_appClass protected
string|null
The customized application class name.
-
$_configure protected
array
Configure values to restore at end of test.
-
$_err protected
Cake\Console\TestSuite\StubConsoleOutput
Console error output stub
-
$_exitCode protected
int|null
Last exit code
-
$_in protected
Cake\Console\TestSuite\StubConsoleInput
Console input mock
-
$_out protected
Cake\Console\TestSuite\StubConsoleOutput
Console output stub
-
$_tableLocator protected
Cake\ORM\Locator\LocatorInterface|null
Table locator instance
-
$_useCommandRunner protected
bool
Whether to use the CommandRunner
-
$autoFixtures public deprecated
bool
By default, all fixtures attached to this class will be truncated and reloaded after each test. Set this to false to handle manually
-
$backupGlobals protected
?bool
-
$backupGlobalsBlacklist protected deprecated
string[]
-
$backupGlobalsExcludeList protected
string[]
-
$backupStaticAttributes protected
?bool
-
$backupStaticAttributesBlacklist protected deprecated
array<string, array<int, string>>
-
$backupStaticAttributesExcludeList protected
array<string, array<int, string>>
-
$defaultTable protected
string|null
This object's default table alias.
-
$dropTables public deprecated
bool
Control table create/drops on each test method.
-
$fixtureManager public static
Cake\TestSuite\Fixture\FixtureManager|null
The class responsible for managing the creation, loading and removing of fixtures
-
$fixtureStrategy protected
Cake\TestSuite\Fixture\FixtureStrategyInterface|null
-
$fixtures protected
array<string>
Fixtures used by this test case.
-
$preserveGlobalState protected
bool
-
$providedTests protected
list<ExecutionOrderDependency>
-
$runTestInSeparateProcess protected
?bool
Method Summary
-
__construct() public
-
_assertAttributes() protected
Check the attributes as part of an assertTags() check.
-
_getTableClassName() protected
Gets the class name for the table.
-
_normalizePath() protected
Normalize a path for comparison.
-
addFixture() protected
Adds a fixture to this test case.
-
addToAssertionCount() public
-
addWarning() public
-
any() public static
Returns a matcher that matches when the method is executed zero or more times.
-
anything() public static
-
arrayHasKey() public static
-
assertArrayHasKey() public static
Asserts that an array has a specified key.
-
assertArrayNotHasKey() public static
Asserts that an array does not have a specified key.
-
assertClassHasAttribute() public static deprecated
Asserts that a class has a specified attribute.
-
assertClassHasStaticAttribute() public static deprecated
Asserts that a class has a specified static attribute.
-
assertClassNotHasAttribute() public static deprecated
Asserts that a class does not have a specified attribute.
-
assertClassNotHasStaticAttribute() public static deprecated
Asserts that a class does not have a specified static attribute.
-
assertContains() public static
Asserts that a haystack contains a needle.
-
assertContainsEquals() public static
-
assertContainsOnly() public static
Asserts that a haystack contains only values of a given type.
-
assertContainsOnlyInstancesOf() public static
Asserts that a haystack contains only instances of a given class name.
-
assertCount() public static
Asserts the number of elements of an array, Countable or Traversable.
-
assertDirectoryDoesNotExist() public static
Asserts that a directory does not exist.
-
assertDirectoryExists() public static
Asserts that a directory exists.
-
assertDirectoryIsNotReadable() public static
Asserts that a directory exists and is not readable.
-
assertDirectoryIsNotWritable() public static
Asserts that a directory exists and is not writable.
-
assertDirectoryIsReadable() public static
Asserts that a directory exists and is readable.
-
assertDirectoryIsWritable() public static
Asserts that a directory exists and is writable.
-
assertDirectoryNotExists() public static deprecated
Asserts that a directory does not exist.
-
assertDirectoryNotIsReadable() public static deprecated
Asserts that a directory exists and is not readable.
-
assertDirectoryNotIsWritable() public static deprecated
Asserts that a directory exists and is not writable.
-
assertDoesNotMatchRegularExpression() public static
Asserts that a string does not match a given regular expression.
-
assertEmpty() public static
Asserts that a variable is empty.
-
assertEqualXMLStructure() public static deprecated
Asserts that a hierarchy of DOMElements matches.
-
assertEquals() public static
Asserts that two variables are equal.
-
assertEqualsCanonicalizing() public static
Asserts that two variables are equal (canonicalizing).
-
assertEqualsIgnoringCase() public static
Asserts that two variables are equal (ignoring case).
-
assertEqualsSql() public
Assert that a string matches SQL with db-specific characters like quotes removed.
-
assertEqualsWithDelta() public static
Asserts that two variables are equal (with delta).
-
assertErrorContains() public
Asserts
stderr
contains expected output -
assertErrorEmpty() public
Asserts that
stderr
is empty -
assertErrorRegExp() public
Asserts
stderr
contains expected regexp -
assertEventFired() public
Asserts that a global event was fired. You must track events in your event manager for this assertion to work
-
assertEventFiredWith() public
Asserts an event was fired with data
-
assertExitCode() public
Asserts shell exited with the expected code
-
assertExitError() public
Asserts shell exited with Command::CODE_ERROR
-
assertExitSuccess() public
Asserts shell exited with the Command::CODE_SUCCESS
-
assertFalse() public static
Asserts that a condition is false.
-
assertFileDoesNotExist() public static
Asserts that a file does not exist.
-
assertFileEquals() public static
Asserts that the contents of one file is equal to the contents of another file.
-
assertFileEqualsCanonicalizing() public static
Asserts that the contents of one file is equal to the contents of another file (canonicalizing).
-
assertFileEqualsIgnoringCase() public static
Asserts that the contents of one file is equal to the contents of another file (ignoring case).
-
assertFileExists() public static
Asserts that a file exists.
-
assertFileIsNotReadable() public static
Asserts that a file exists and is not readable.
-
assertFileIsNotWritable() public static
Asserts that a file exists and is not writable.
-
assertFileIsReadable() public static
Asserts that a file exists and is readable.
-
assertFileIsWritable() public static
Asserts that a file exists and is writable.
-
assertFileNotEquals() public static
Asserts that the contents of one file is not equal to the contents of another file.
-
assertFileNotEqualsCanonicalizing() public static
Asserts that the contents of one file is not equal to the contents of another file (canonicalizing).
-
assertFileNotEqualsIgnoringCase() public static
Asserts that the contents of one file is not equal to the contents of another file (ignoring case).
-
assertFileNotExists() public static deprecated
Asserts that a file does not exist.
-
assertFileNotIsReadable() public static deprecated
Asserts that a file exists and is not readable.
-
assertFileNotIsWritable() public static deprecated
Asserts that a file exists and is not writable.
-
assertFinite() public static
Asserts that a variable is finite.
-
assertGreaterThan() public static
Asserts that a value is greater than another value.
-
assertGreaterThanOrEqual() public static
Asserts that a value is greater than or equal to another value.
-
assertHtml() public
Asserts HTML tags.
-
assertInfinite() public static
Asserts that a variable is infinite.
-
assertInstanceOf() public static
Asserts that a variable is of a given type.
-
assertIsArray() public static
Asserts that a variable is of type array.
-
assertIsBool() public static
Asserts that a variable is of type bool.
-
assertIsCallable() public static
Asserts that a variable is of type callable.
-
assertIsClosedResource() public static
Asserts that a variable is of type resource and is closed.
-
assertIsFloat() public static
Asserts that a variable is of type float.
-
assertIsInt() public static
Asserts that a variable is of type int.
-
assertIsIterable() public static
Asserts that a variable is of type iterable.
-
assertIsNotArray() public static
Asserts that a variable is not of type array.
-
assertIsNotBool() public static
Asserts that a variable is not of type bool.
-
assertIsNotCallable() public static
Asserts that a variable is not of type callable.
-
assertIsNotClosedResource() public static
Asserts that a variable is not of type resource.
-
assertIsNotFloat() public static
Asserts that a variable is not of type float.
-
assertIsNotInt() public static
Asserts that a variable is not of type int.
-
assertIsNotIterable() public static
Asserts that a variable is not of type iterable.
-
assertIsNotNumeric() public static
Asserts that a variable is not of type numeric.
-
assertIsNotObject() public static
Asserts that a variable is not of type object.
-
assertIsNotReadable() public static
Asserts that a file/dir exists and is not readable.
-
assertIsNotResource() public static
Asserts that a variable is not of type resource.
-
assertIsNotScalar() public static
Asserts that a variable is not of type scalar.
-
assertIsNotString() public static
Asserts that a variable is not of type string.
-
assertIsNotWritable() public static
Asserts that a file/dir exists and is not writable.
-
assertIsNumeric() public static
Asserts that a variable is of type numeric.
-
assertIsObject() public static
Asserts that a variable is of type object.
-
assertIsReadable() public static
Asserts that a file/dir is readable.
-
assertIsResource() public static
Asserts that a variable is of type resource.
-
assertIsScalar() public static
Asserts that a variable is of type scalar.
-
assertIsString() public static
Asserts that a variable is of type string.
-
assertIsWritable() public static
Asserts that a file/dir exists and is writable.
-
assertJson() public static
Asserts that a string is a valid JSON string.
-
assertJsonFileEqualsJsonFile() public static
Asserts that two JSON files are equal.
-
assertJsonFileNotEqualsJsonFile() public static
Asserts that two JSON files are not equal.
-
assertJsonStringEqualsJsonFile() public static
Asserts that the generated JSON encoded object and the content of the given file are equal.
-
assertJsonStringEqualsJsonString() public static
Asserts that two given JSON encoded objects or arrays are equal.
-
assertJsonStringNotEqualsJsonFile() public static
Asserts that the generated JSON encoded object and the content of the given file are not equal.
-
assertJsonStringNotEqualsJsonString() public static
Asserts that two given JSON encoded objects or arrays are not equal.
-
assertLessThan() public static
Asserts that a value is smaller than another value.
-
assertLessThanOrEqual() public static
Asserts that a value is smaller than or equal to another value.
-
assertMatchesRegularExpression() public static
Asserts that a string matches a given regular expression.
-
assertNan() public static
Asserts that a variable is nan.
-
assertNotContains() public static
Asserts that a haystack does not contain a needle.
-
assertNotContainsEquals() public static
-
assertNotContainsOnly() public static
Asserts that a haystack does not contain only values of a given type.
-
assertNotCount() public static
Asserts the number of elements of an array, Countable or Traversable.
-
assertNotEmpty() public static
Asserts that a variable is not empty.
-
assertNotEquals() public static
Asserts that two variables are not equal.
-
assertNotEqualsCanonicalizing() public static
Asserts that two variables are not equal (canonicalizing).
-
assertNotEqualsIgnoringCase() public static
Asserts that two variables are not equal (ignoring case).
-
assertNotEqualsWithDelta() public static
Asserts that two variables are not equal (with delta).
-
assertNotFalse() public static
Asserts that a condition is not false.
-
assertNotInstanceOf() public static
Asserts that a variable is not of a given type.
-
assertNotIsReadable() public static deprecated
Asserts that a file/dir exists and is not readable.
-
assertNotIsWritable() public static deprecated
Asserts that a file/dir exists and is not writable.
-
assertNotNull() public static
Asserts that a variable is not null.
-
assertNotRegExp() public static deprecated
Asserts that a string does not match a given regular expression.
-
assertNotSame() public static
Asserts that two variables do not have the same type and value. Used on objects, it asserts that two variables do not reference the same object.
-
assertNotSameSize() public static
Assert that the size of two arrays (or
Countable
orTraversable
objects) is not the same. -
assertNotTrue() public static
Asserts that a condition is not true.
-
assertNotWithinRange() protected static
Compatibility function to test if a value is not between an acceptable range.
-
assertNull() public static
Asserts that a variable is null.
-
assertObjectEquals() public static
-
assertObjectHasAttribute() public static deprecated
Asserts that an object has a specified attribute.
-
assertObjectHasProperty() public static
Asserts that an object has a specified property.
-
assertObjectNotHasAttribute() public static deprecated
Asserts that an object does not have a specified attribute.
-
assertObjectNotHasProperty() public static
Asserts that an object does not have a specified property.
-
assertOutputContains() public
Asserts
stdout
contains expected output -
assertOutputContainsRow() protected
Check that a row of cells exists in the output.
-
assertOutputEmpty() public
Asserts that
stdout
is empty -
assertOutputNotContains() public
Asserts
stdout
does not contain expected output -
assertOutputRegExp() public
Asserts
stdout
contains expected regexp -
assertPathEquals() protected static
Compatibility function to test paths.
-
assertPostConditions() protected
Performs assertions shared by all tests of a test case.
-
assertPreConditions() protected
Performs assertions shared by all tests of a test case.
-
assertRegExp() public static deprecated
Asserts that a string matches a given regular expression.
-
assertRegExpSql() public
Assertion for comparing a regex pattern against a query having its identifiers quoted. It accepts queries quoted with the characters
<
and>
. If the third parameter is set to true, it will alter the pattern to both accept quoted and unquoted queries -
assertSame() public static
Asserts that two variables have the same type and value. Used on objects, it asserts that two variables reference the same object.
-
assertSameSize() public static
Assert that the size of two arrays (or
Countable
orTraversable
objects) is the same. -
assertStringContainsString() public static
-
assertStringContainsStringIgnoringCase() public static
-
assertStringEndsNotWith() public static
Asserts that a string ends not with a given suffix.
-
assertStringEndsWith() public static
Asserts that a string ends with a given suffix.
-
assertStringEqualsFile() public static
Asserts that the contents of a string is equal to the contents of a file.
-
assertStringEqualsFileCanonicalizing() public static
Asserts that the contents of a string is equal to the contents of a file (canonicalizing).
-
assertStringEqualsFileIgnoringCase() public static
Asserts that the contents of a string is equal to the contents of a file (ignoring case).
-
assertStringMatchesFormat() public static
Asserts that a string matches a given format string.
-
assertStringMatchesFormatFile() public static
Asserts that a string matches a given format file.
-
assertStringNotContainsString() public static
-
assertStringNotContainsStringIgnoringCase() public static
-
assertStringNotEqualsFile() public static
Asserts that the contents of a string is not equal to the contents of a file.
-
assertStringNotEqualsFileCanonicalizing() public static
Asserts that the contents of a string is not equal to the contents of a file (canonicalizing).
-
assertStringNotEqualsFileIgnoringCase() public static
Asserts that the contents of a string is not equal to the contents of a file (ignoring case).
-
assertStringNotMatchesFormat() public static
Asserts that a string does not match a given format string.
-
assertStringNotMatchesFormatFile() public static
Asserts that a string does not match a given format string.
-
assertStringStartsNotWith() public static
Asserts that a string starts not with a given prefix.
-
assertStringStartsWith() public static
Asserts that a string starts with a given prefix.
-
assertTextContains() public
Assert that a string contains another string, ignoring differences in newlines. Helpful for doing cross platform tests of blocks of text.
-
assertTextEndsNotWith() public
Asserts that a string ends not with a given prefix, ignoring differences in newlines. Helpful for doing cross platform tests of blocks of text.
-
assertTextEndsWith() public
Asserts that a string ends with a given prefix, ignoring differences in newlines. Helpful for doing cross platform tests of blocks of text.
-
assertTextEquals() public
Assert text equality, ignoring differences in newlines. Helpful for doing cross platform tests of blocks of text.
-
assertTextNotContains() public
Assert that a text doesn't contain another text, ignoring differences in newlines. Helpful for doing cross platform tests of blocks of text.
-
assertTextNotEquals() public
Assert text equality, ignoring differences in newlines. Helpful for doing cross platform tests of blocks of text.
-
assertTextStartsNotWith() public
Asserts that a string starts not with a given prefix, ignoring differences in newlines. Helpful for doing cross platform tests of blocks of text.
-
assertTextStartsWith() public
Asserts that a string starts with a given prefix, ignoring differences in newlines. Helpful for doing cross platform tests of blocks of text.
-
assertThat() public static
Evaluates a PHPUnit\Framework\Constraint matcher object.
-
assertTrue() public static
Asserts that a condition is true.
-
assertWithinRange() protected static
Compatibility function to test if a value is between an acceptable range.
-
assertXmlFileEqualsXmlFile() public static
Asserts that two XML files are equal.
-
assertXmlFileNotEqualsXmlFile() public static
Asserts that two XML files are not equal.
-
assertXmlStringEqualsXmlFile() public static
Asserts that two XML documents are equal.
-
assertXmlStringEqualsXmlString() public static
Asserts that two XML documents are equal.
-
assertXmlStringNotEqualsXmlFile() public static
Asserts that two XML documents are not equal.
-
assertXmlStringNotEqualsXmlString() public static
Asserts that two XML documents are not equal.
-
at() public static deprecated
Returns a matcher that matches when the method is executed at the given index.
-
atLeast() public static
Returns a matcher that matches when the method is executed at least N times.
-
atLeastOnce() public static
Returns a matcher that matches when the method is executed at least once.
-
atMost() public static
Returns a matcher that matches when the method is executed at most N times.
-
callback() public static
-
classHasAttribute() public static deprecated
-
classHasStaticAttribute() public static deprecated
-
cleanupConsoleTrait() public
Cleans state to get ready for the next test
-
cleanupContainer() public
Clears any mocks that were defined and cleans up application class configuration.
-
clearPlugins() public
Clear all plugins from the global plugin collection.
-
commandStringToArgs() protected
Creates an $argv array from a command string
-
configApplication() public
Configure the application class to use in integration tests.
-
containsEqual() public static
-
containsIdentical() public static
-
containsOnly() public static
-
containsOnlyInstancesOf() public static
-
count() public
-
countOf() public static
-
createApp() protected
Create an application instance.
-
createConfiguredMock() protected
Returns a configured mock object for the specified class.
-
createMock() protected
Returns a mock object for the specified class.
-
createPartialMock() protected
Returns a partial mock object for the specified class.
-
createResult() protected
Creates a default TestResult object.
-
createStub() protected
Makes configurable stub for the specified class.
-
createTestProxy() protected
Returns a test proxy for the specified class.
-
dataName() public
-
deprecated() public
Helper method for check deprecation methods
-
directoryExists() public static
-
doesNotPerformAssertions() public
-
doubledTypes() public
-
equalTo() public static
-
equalToCanonicalizing() public static
-
equalToIgnoringCase() public static
-
equalToWithDelta() public static
-
exactly() public static
Returns a matcher that matches when the method is executed exactly $count times.
-
exec() public
Runs CLI integration test
-
expectDeprecation() public deprecated
-
expectDeprecationMessage() public deprecated
-
expectDeprecationMessageMatches() public deprecated
-
expectError() public deprecated
-
expectErrorMessage() public deprecated
-
expectErrorMessageMatches() public deprecated
-
expectException() public
-
expectExceptionCode() public
-
expectExceptionMessage() public
-
expectExceptionMessageMatches() public
-
expectExceptionObject() public
Sets up an expectation for an exception to be raised by the code under test. Information for expected exception class, expected exception message, and expected exception code are retrieved from a given Exception object.
-
expectNotToPerformAssertions() public
-
expectNotice() public deprecated
-
expectNoticeMessage() public deprecated
-
expectNoticeMessageMatches() public deprecated
-
expectOutputRegex() public
-
expectOutputString() public
-
expectWarning() public deprecated
-
expectWarningMessage() public deprecated
-
expectWarningMessageMatches() public deprecated
-
fail() public static
Fails a test with the given message.
-
fetchTable() public
Convenience method to get a table instance.
-
fileExists() public static
-
getActualOutput() public
-
getActualOutputForAssertion() public
-
getCount() public static
Return the current assertion count.
-
getDataSetAsString() public
-
getExpectedException() public
-
getExpectedExceptionCode() public
-
getExpectedExceptionMessage() public
-
getExpectedExceptionMessageRegExp() public
-
getFixtureStrategy() protected
Returns fixture strategy used by these tests.
-
getFixtures() public
Get the fixtures this test should use.
-
getGroups() public
-
getMockBuilder() public
Returns a builder object to create mock objects using a fluent interface.
-
getMockClass() protected deprecated
Mocks the specified class and returns the name of the mocked class.
-
getMockForAbstractClass() protected
Returns a mock object for the specified abstract class with all abstract methods of the class mocked. Concrete methods are not mocked by default. To mock concrete methods, use the 7th parameter ($mockedMethods).
-
getMockForModel() public
Mock a model, maintain fixtures and table association
-
getMockForTrait() protected
Returns a mock object for the specified trait with all abstract methods of the trait mocked. Concrete methods to mock can be specified with the
$mockedMethods
parameter. -
getMockFromWsdl() protected
Returns a mock object based on the given WSDL file.
-
getName() public
-
getNumAssertions() public
Returns the number of assertions performed by this test.
-
getObjectForTrait() protected
Returns an object for the specified trait.
-
getProvidedData() public
Gets the data set of a TestCase.
-
getResult() public
-
getSize() public
Returns the size of the test.
-
getStatus() public
-
getStatusMessage() public
-
getTableLocator() public
Gets the table locator.
-
getTestResultObject() public
-
greaterThan() public static
-
greaterThanOrEqual() public static
-
hasExpectationOnOutput() public
-
hasFailed() public
-
hasOutput() public
-
hasSize() public
-
identicalTo() public static
-
iniSet() protected
This method is a wrapper for the ini_set() function that automatically resets the modified php.ini setting to its original value after the test is run.
-
isEmpty() public static
-
isFalse() public static
-
isFinite() public static
-
isInIsolation() public
-
isInfinite() public static
-
isInstanceOf() public static
-
isJson() public static
-
isLarge() public
-
isMedium() public
-
isNan() public static
-
isNull() public static
-
isReadable() public static
-
isSmall() public
-
isTrue() public static
-
isType() public static
-
isWritable() public static
-
lessThan() public static
-
lessThanOrEqual() public static
-
loadFixtures() public deprecated
Chooses which fixtures to load for a given test
-
loadPlugins() public
Load plugins into a simulated application.
-
loadRoutes() public
Load routes for the application.
-
logicalAnd() public static
-
logicalNot() public static
-
logicalOr() public static
-
logicalXor() public static
-
makeRunner() protected
Builds the appropriate command dispatcher
-
markAsRisky() public
-
markTestIncomplete() public static
Mark the test as incomplete.
-
markTestSkipped() public static
Mark the test as skipped.
-
matches() public static
-
matchesRegularExpression() public static
-
mockService() public
Add a mocked service to the container.
-
modifyContainer() public
Wrap the application's container with one containing mocks.
-
never() public static
Returns a matcher that matches when the method is never executed.
-
objectEquals() public static
-
objectHasAttribute() public static deprecated
-
onConsecutiveCalls() public static
-
onNotSuccessfulTest() protected
This method is called when a test method did not execute successfully.
-
once() public static
Returns a matcher that matches when the method is executed exactly once.
-
prophesize() protected deprecated
-
provides() public
Returns the normalized test name as class::method.
-
recordDoubledType() protected
-
registerComparator() public
-
registerMockObject() public
-
removeMockService() public
Remove a mocked service to the container.
-
removePlugins() public
Remove plugins from the global plugin collection.
-
requires() public
Returns a list of normalized dependency names, class::method.
-
resetCount() public static
Reset the assertion counter.
-
returnArgument() public static
-
returnCallback() public static
-
returnSelf() public static
Returns the current object.
-
returnValue() public static
-
returnValueMap() public static
-
run() public
Runs the test case and collects the results in a TestResult object. If no TestResult object is passed a new one will be created.
-
runBare() public
-
runTest() protected
Override to run the test and assert its state.
-
setAppNamespace() public static
Set the app namespace
-
setBackupGlobals() public
-
setBackupStaticAttributes() public
-
setBeStrictAboutChangesToGlobalState() public
-
setDependencies() public
-
setDependencyInput() public
-
setGroups() public
-
setInIsolation() public
-
setLocale() protected
This method is a wrapper for the setlocale() function that automatically resets the locale to its original value after the test is run.
-
setName() public
-
setOutputCallback() public
-
setPreserveGlobalState() public
-
setRegisterMockObjectsFromTestArgumentsRecursively() public
-
setResult() public
-
setRunClassInSeparateProcess() public
-
setRunTestInSeparateProcess() public
-
setTableLocator() public
Sets the table locator.
-
setTestResultObject() public
-
setUp() protected
Setup the test case, backup the static object values so they can be restored. Specifically backs up the contents of Configure and paths in App if they have not already been backed up.
-
setUpBeforeClass() public static
This method is called before the first test of this test class is run.
-
setupFixtures() protected
Initialized and loads any use fixtures.
-
skipIf() public
Overrides SimpleTestCase::skipIf to provide a boolean return value
-
skipUnless() protected
Compatibility function for skipping.
-
sortId() public
-
stringContains() public static
-
stringEndsWith() public static
-
stringStartsWith() public static
-
tearDown() protected
teardown any static object changes and restore them.
-
tearDownAfterClass() public static
This method is called after the last test of this test class is run.
-
teardownFixtures() protected
Unloads any use fixtures.
-
throwException() public static
-
toString() public
Returns a string representation of the test case.
-
useCommandRunner() public
Set this test case to use the CommandRunner rather than the legacy ShellDispatcher
-
usesDataProvider() public
-
withErrorReporting() public
Helper method for tests that needs to use error_reporting()
Method Detail
__construct() ¶ public
__construct(?string $name = null, array $data = [], int|string $dataName = '')
Parameters
-
?string
$name optional -
array
$data optional -
int|string
$dataName optional
_assertAttributes() ¶ protected
_assertAttributes(array<string, mixed> $assertions, string $string, bool $fullDebug = false, array|string $regex = ''): string|false
Check the attributes as part of an assertTags() check.
Parameters
-
array<string, mixed>
$assertions Assertions to run.
-
string
$string The HTML string to check.
-
bool
$fullDebug optional Whether more verbose output should be used.
-
array|string
$regex optional Full regexp from
assertHtml
Returns
string|false
_getTableClassName() ¶ protected
_getTableClassName(string $alias, array<string, mixed> $options): string
Gets the class name for the table.
Parameters
-
string
$alias The model to get a mock for.
-
array<string, mixed>
$options The config data for the mock's constructor.
Returns
string
Throws
Cake\ORM\Exception\MissingTableClassException
_normalizePath() ¶ protected
_normalizePath(string $path): string
Normalize a path for comparison.
Parameters
-
string
$path Path separated by "/" slash.
Returns
string
addFixture() ¶ protected
addFixture(string $fixture): $this
Adds a fixture to this test case.
Examples:
- core.Tags
- app.MyRecords
- plugin.MyPluginName.MyModelName
Use this method inside your test cases' {@link getFixtures()} method to build up the fixture list.
Parameters
-
string
$fixture Fixture
Returns
$this
addToAssertionCount() ¶ public
addToAssertionCount(int $count): void
Parameters
-
int
$count
Returns
void
any() ¶ public static
any(): AnyInvokedCountMatcher
Returns a matcher that matches when the method is executed zero or more times.
Returns
AnyInvokedCountMatcher
arrayHasKey() ¶ public static
arrayHasKey(int|string $key): ArrayHasKey
Parameters
-
int|string
$key
Returns
ArrayHasKey
assertArrayHasKey() ¶ public static
assertArrayHasKey(int|string $key, array|ArrayAccess $array, string $message = ''): void
Asserts that an array has a specified key.
Parameters
-
int|string
$key -
array|ArrayAccess
$array -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
Exception
ExpectationFailedException
assertArrayNotHasKey() ¶ public static
assertArrayNotHasKey(int|string $key, array|ArrayAccess $array, string $message = ''): void
Asserts that an array does not have a specified key.
Parameters
-
int|string
$key -
array|ArrayAccess
$array -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
Exception
ExpectationFailedException
assertClassHasAttribute() ¶ public static
assertClassHasAttribute(string $attributeName, string $className, string $message = ''): void
Asserts that a class has a specified attribute.
Parameters
-
string
$attributeName -
string
$className -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
Exception
ExpectationFailedException
assertClassHasStaticAttribute() ¶ public static
assertClassHasStaticAttribute(string $attributeName, string $className, string $message = ''): void
Asserts that a class has a specified static attribute.
Parameters
-
string
$attributeName -
string
$className -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
Exception
ExpectationFailedException
assertClassNotHasAttribute() ¶ public static
assertClassNotHasAttribute(string $attributeName, string $className, string $message = ''): void
Asserts that a class does not have a specified attribute.
Parameters
-
string
$attributeName -
string
$className -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
Exception
ExpectationFailedException
assertClassNotHasStaticAttribute() ¶ public static
assertClassNotHasStaticAttribute(string $attributeName, string $className, string $message = ''): void
Asserts that a class does not have a specified static attribute.
Parameters
-
string
$attributeName -
string
$className -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
Exception
ExpectationFailedException
assertContains() ¶ public static
assertContains(mixed $needle, iterable $haystack, string $message = ''): void
Asserts that a haystack contains a needle.
Parameters
-
$needle
-
iterable
$haystack -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
Exception
ExpectationFailedException
assertContainsEquals() ¶ public static
assertContainsEquals(mixed $needle, iterable $haystack, string $message = ''): void
Parameters
-
$needle
-
iterable
$haystack -
string
$message optional
Returns
void
assertContainsOnly() ¶ public static
assertContainsOnly(string $type, iterable $haystack, ?bool $isNativeType = null, string $message = ''): void
Asserts that a haystack contains only values of a given type.
Parameters
-
string
$type -
iterable
$haystack -
?bool
$isNativeType optional -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertContainsOnlyInstancesOf() ¶ public static
assertContainsOnlyInstancesOf(string $className, iterable $haystack, string $message = ''): void
Asserts that a haystack contains only instances of a given class name.
Parameters
-
string
$className -
iterable
$haystack -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertCount() ¶ public static
assertCount(int $expectedCount, Countable|iterable $haystack, string $message = ''): void
Asserts the number of elements of an array, Countable or Traversable.
Parameters
-
int
$expectedCount -
Countable|iterable
$haystack -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
Exception
ExpectationFailedException
assertDirectoryDoesNotExist() ¶ public static
assertDirectoryDoesNotExist(string $directory, string $message = ''): void
Asserts that a directory does not exist.
Parameters
-
string
$directory Directory
-
string
$message optional Message
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
assertDirectoryExists() ¶ public static
assertDirectoryExists(string $directory, string $message = ''): void
Asserts that a directory exists.
Parameters
-
string
$directory -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertDirectoryIsNotReadable() ¶ public static
assertDirectoryIsNotReadable(string $directory, string $message = ''): void
Asserts that a directory exists and is not readable.
Parameters
-
string
$directory -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertDirectoryIsNotWritable() ¶ public static
assertDirectoryIsNotWritable(string $directory, string $message = ''): void
Asserts that a directory exists and is not writable.
Parameters
-
string
$directory -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertDirectoryIsReadable() ¶ public static
assertDirectoryIsReadable(string $directory, string $message = ''): void
Asserts that a directory exists and is readable.
Parameters
-
string
$directory -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertDirectoryIsWritable() ¶ public static
assertDirectoryIsWritable(string $directory, string $message = ''): void
Asserts that a directory exists and is writable.
Parameters
-
string
$directory -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertDirectoryNotExists() ¶ public static
assertDirectoryNotExists(string $directory, string $message = ''): void
Asserts that a directory does not exist.
Parameters
-
string
$directory -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertDirectoryNotIsReadable() ¶ public static
assertDirectoryNotIsReadable(string $directory, string $message = ''): void
Asserts that a directory exists and is not readable.
Parameters
-
string
$directory -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertDirectoryNotIsWritable() ¶ public static
assertDirectoryNotIsWritable(string $directory, string $message = ''): void
Asserts that a directory exists and is not writable.
Parameters
-
string
$directory -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertDoesNotMatchRegularExpression() ¶ public static
assertDoesNotMatchRegularExpression(string $pattern, string $string, string $message = ''): void
Asserts that a string does not match a given regular expression.
Parameters
-
string
$pattern Regex pattern
-
string
$string String to test
-
string
$message optional Message
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
assertEmpty() ¶ public static
assertEmpty(mixed $actual, string $message = ''): void
Asserts that a variable is empty.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertEqualXMLStructure() ¶ public static
assertEqualXMLStructure(DOMElement $expectedElement, DOMElement $actualElement, bool $checkAttributes = false, string $message = ''): void
Asserts that a hierarchy of DOMElements matches.
Parameters
-
DOMElement
$expectedElement -
DOMElement
$actualElement -
bool
$checkAttributes optional -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
AssertionFailedError
ExpectationFailedException
assertEquals() ¶ public static
assertEquals(mixed $expected, mixed $actual, string $message = ''): void
Asserts that two variables are equal.
Parameters
-
$expected
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertEqualsCanonicalizing() ¶ public static
assertEqualsCanonicalizing(mixed $expected, mixed $actual, string $message = ''): void
Asserts that two variables are equal (canonicalizing).
Parameters
-
$expected
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertEqualsIgnoringCase() ¶ public static
assertEqualsIgnoringCase(mixed $expected, mixed $actual, string $message = ''): void
Asserts that two variables are equal (ignoring case).
Parameters
-
$expected
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertEqualsSql() ¶ public
assertEqualsSql(string $expected, string $actual, string $message = ''): void
Assert that a string matches SQL with db-specific characters like quotes removed.
Parameters
-
string
$expected The expected sql
-
string
$actual The sql to compare
-
string
$message optional The message to display on failure
Returns
void
assertEqualsWithDelta() ¶ public static
assertEqualsWithDelta(mixed $expected, mixed $actual, float $delta, string $message = ''): void
Asserts that two variables are equal (with delta).
Parameters
-
$expected
-
$actual
-
float
$delta -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertErrorContains() ¶ public
assertErrorContains(string $expected, string $message = ''): void
Asserts stderr
contains expected output
Parameters
-
string
$expected Expected output
-
string
$message optional Failure message
Returns
void
assertErrorEmpty() ¶ public
assertErrorEmpty(string $message = ''): void
Asserts that stderr
is empty
Parameters
-
string
$message optional The message to output when the assertion fails.
Returns
void
assertErrorRegExp() ¶ public
assertErrorRegExp(string $pattern, string $message = ''): void
Asserts stderr
contains expected regexp
Parameters
-
string
$pattern Expected pattern
-
string
$message optional Failure message
Returns
void
assertEventFired() ¶ public
assertEventFired(string $name, Cake\Event\EventManager|null $eventManager = null, string $message = ''): void
Asserts that a global event was fired. You must track events in your event manager for this assertion to work
Parameters
-
string
$name Event name
-
Cake\Event\EventManager|null
$eventManager optional Event manager to check, defaults to global event manager
-
string
$message optional Assertion failure message
Returns
void
assertEventFiredWith() ¶ public
assertEventFiredWith(string $name, string $dataKey, mixed $dataValue, Cake\Event\EventManager|null $eventManager = null, string $message = ''): void
Asserts an event was fired with data
If a third argument is passed, that value is used to compare with the value in $dataKey
Parameters
-
string
$name Event name
-
string
$dataKey Data key
-
mixed
$dataValue Data value
-
Cake\Event\EventManager|null
$eventManager optional Event manager to check, defaults to global event manager
-
string
$message optional Assertion failure message
Returns
void
assertExitCode() ¶ public
assertExitCode(int $expected, string $message = ''): void
Asserts shell exited with the expected code
Parameters
-
int
$expected Expected exit code
-
string
$message optional Failure message
Returns
void
assertExitError() ¶ public
assertExitError(string $message = ''): void
Asserts shell exited with Command::CODE_ERROR
Parameters
-
string
$message optional Failure message
Returns
void
assertExitSuccess() ¶ public
assertExitSuccess(string $message = ''): void
Asserts shell exited with the Command::CODE_SUCCESS
Parameters
-
string
$message optional Failure message
Returns
void
assertFalse() ¶ public static
assertFalse(mixed $condition, string $message = ''): void
Asserts that a condition is false.
Parameters
-
$condition
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertFileDoesNotExist() ¶ public static
assertFileDoesNotExist(string $filename, string $message = ''): void
Asserts that a file does not exist.
Parameters
-
string
$filename Filename
-
string
$message optional Message
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
assertFileEquals() ¶ public static
assertFileEquals(string $expected, string $actual, string $message = ''): void
Asserts that the contents of one file is equal to the contents of another file.
Parameters
-
string
$expected -
string
$actual -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertFileEqualsCanonicalizing() ¶ public static
assertFileEqualsCanonicalizing(string $expected, string $actual, string $message = ''): void
Asserts that the contents of one file is equal to the contents of another file (canonicalizing).
Parameters
-
string
$expected -
string
$actual -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertFileEqualsIgnoringCase() ¶ public static
assertFileEqualsIgnoringCase(string $expected, string $actual, string $message = ''): void
Asserts that the contents of one file is equal to the contents of another file (ignoring case).
Parameters
-
string
$expected -
string
$actual -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertFileExists() ¶ public static
assertFileExists(string $filename, string $message = ''): void
Asserts that a file exists.
Parameters
-
string
$filename -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertFileIsNotReadable() ¶ public static
assertFileIsNotReadable(string $file, string $message = ''): void
Asserts that a file exists and is not readable.
Parameters
-
string
$file -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertFileIsNotWritable() ¶ public static
assertFileIsNotWritable(string $file, string $message = ''): void
Asserts that a file exists and is not writable.
Parameters
-
string
$file -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertFileIsReadable() ¶ public static
assertFileIsReadable(string $file, string $message = ''): void
Asserts that a file exists and is readable.
Parameters
-
string
$file -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertFileIsWritable() ¶ public static
assertFileIsWritable(string $file, string $message = ''): void
Asserts that a file exists and is writable.
Parameters
-
string
$file -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertFileNotEquals() ¶ public static
assertFileNotEquals(string $expected, string $actual, string $message = ''): void
Asserts that the contents of one file is not equal to the contents of another file.
Parameters
-
string
$expected -
string
$actual -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertFileNotEqualsCanonicalizing() ¶ public static
assertFileNotEqualsCanonicalizing(string $expected, string $actual, string $message = ''): void
Asserts that the contents of one file is not equal to the contents of another file (canonicalizing).
Parameters
-
string
$expected -
string
$actual -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertFileNotEqualsIgnoringCase() ¶ public static
assertFileNotEqualsIgnoringCase(string $expected, string $actual, string $message = ''): void
Asserts that the contents of one file is not equal to the contents of another file (ignoring case).
Parameters
-
string
$expected -
string
$actual -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertFileNotExists() ¶ public static
assertFileNotExists(string $filename, string $message = ''): void
Asserts that a file does not exist.
Parameters
-
string
$filename -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertFileNotIsReadable() ¶ public static
assertFileNotIsReadable(string $file, string $message = ''): void
Asserts that a file exists and is not readable.
Parameters
-
string
$file -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertFileNotIsWritable() ¶ public static
assertFileNotIsWritable(string $file, string $message = ''): void
Asserts that a file exists and is not writable.
Parameters
-
string
$file -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertFinite() ¶ public static
assertFinite(mixed $actual, string $message = ''): void
Asserts that a variable is finite.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertGreaterThan() ¶ public static
assertGreaterThan(mixed $expected, mixed $actual, string $message = ''): void
Asserts that a value is greater than another value.
Parameters
-
$expected
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertGreaterThanOrEqual() ¶ public static
assertGreaterThanOrEqual(mixed $expected, mixed $actual, string $message = ''): void
Asserts that a value is greater than or equal to another value.
Parameters
-
$expected
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertHtml() ¶ public
assertHtml(array $expected, string $string, bool $fullDebug = false): bool
Asserts HTML tags.
Takes an array $expected and generates a regex from it to match the provided $string. Samples for $expected:
Checks for an input tag with a name attribute (contains any non-empty value) and an id attribute that contains 'my-input':
['input' => ['name', 'id' => 'my-input']]
Checks for two p elements with some text in them:
[
['p' => true],
'textA',
'/p',
['p' => true],
'textB',
'/p'
]
You can also specify a pattern expression as part of the attribute values, or the tag being defined, if you prepend the value with preg: and enclose it with slashes, like so:
[
['input' => ['name', 'id' => 'preg:/FieldName\d+/']],
'preg:/My\s+field/'
]
Important: This function is very forgiving about whitespace and also accepts any permutation of attribute order. It will also allow whitespace between specified tags.
Parameters
-
array
$expected An array, see above
-
string
$string An HTML/XHTML/XML string
-
bool
$fullDebug optional Whether more verbose output should be used.
Returns
bool
assertInfinite() ¶ public static
assertInfinite(mixed $actual, string $message = ''): void
Asserts that a variable is infinite.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertInstanceOf() ¶ public static
assertInstanceOf(string $expected, mixed $actual, string $message = ''): void
Asserts that a variable is of a given type.
Parameters
-
string
$expected -
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
Exception
ExpectationFailedException
assertIsArray() ¶ public static
assertIsArray(mixed $actual, string $message = ''): void
Asserts that a variable is of type array.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsBool() ¶ public static
assertIsBool(mixed $actual, string $message = ''): void
Asserts that a variable is of type bool.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsCallable() ¶ public static
assertIsCallable(mixed $actual, string $message = ''): void
Asserts that a variable is of type callable.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsClosedResource() ¶ public static
assertIsClosedResource(mixed $actual, string $message = ''): void
Asserts that a variable is of type resource and is closed.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsFloat() ¶ public static
assertIsFloat(mixed $actual, string $message = ''): void
Asserts that a variable is of type float.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsInt() ¶ public static
assertIsInt(mixed $actual, string $message = ''): void
Asserts that a variable is of type int.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsIterable() ¶ public static
assertIsIterable(mixed $actual, string $message = ''): void
Asserts that a variable is of type iterable.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsNotArray() ¶ public static
assertIsNotArray(mixed $actual, string $message = ''): void
Asserts that a variable is not of type array.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsNotBool() ¶ public static
assertIsNotBool(mixed $actual, string $message = ''): void
Asserts that a variable is not of type bool.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsNotCallable() ¶ public static
assertIsNotCallable(mixed $actual, string $message = ''): void
Asserts that a variable is not of type callable.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsNotClosedResource() ¶ public static
assertIsNotClosedResource(mixed $actual, string $message = ''): void
Asserts that a variable is not of type resource.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsNotFloat() ¶ public static
assertIsNotFloat(mixed $actual, string $message = ''): void
Asserts that a variable is not of type float.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsNotInt() ¶ public static
assertIsNotInt(mixed $actual, string $message = ''): void
Asserts that a variable is not of type int.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsNotIterable() ¶ public static
assertIsNotIterable(mixed $actual, string $message = ''): void
Asserts that a variable is not of type iterable.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsNotNumeric() ¶ public static
assertIsNotNumeric(mixed $actual, string $message = ''): void
Asserts that a variable is not of type numeric.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsNotObject() ¶ public static
assertIsNotObject(mixed $actual, string $message = ''): void
Asserts that a variable is not of type object.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsNotReadable() ¶ public static
assertIsNotReadable(string $filename, string $message = ''): void
Asserts that a file/dir exists and is not readable.
Parameters
-
string
$filename -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsNotResource() ¶ public static
assertIsNotResource(mixed $actual, string $message = ''): void
Asserts that a variable is not of type resource.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsNotScalar() ¶ public static
assertIsNotScalar(mixed $actual, string $message = ''): void
Asserts that a variable is not of type scalar.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsNotString() ¶ public static
assertIsNotString(mixed $actual, string $message = ''): void
Asserts that a variable is not of type string.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsNotWritable() ¶ public static
assertIsNotWritable(string $filename, string $message = ''): void
Asserts that a file/dir exists and is not writable.
Parameters
-
string
$filename -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsNumeric() ¶ public static
assertIsNumeric(mixed $actual, string $message = ''): void
Asserts that a variable is of type numeric.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsObject() ¶ public static
assertIsObject(mixed $actual, string $message = ''): void
Asserts that a variable is of type object.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsReadable() ¶ public static
assertIsReadable(string $filename, string $message = ''): void
Asserts that a file/dir is readable.
Parameters
-
string
$filename -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsResource() ¶ public static
assertIsResource(mixed $actual, string $message = ''): void
Asserts that a variable is of type resource.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsScalar() ¶ public static
assertIsScalar(mixed $actual, string $message = ''): void
Asserts that a variable is of type scalar.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsString() ¶ public static
assertIsString(mixed $actual, string $message = ''): void
Asserts that a variable is of type string.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertIsWritable() ¶ public static
assertIsWritable(string $filename, string $message = ''): void
Asserts that a file/dir exists and is writable.
Parameters
-
string
$filename -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertJson() ¶ public static
assertJson(string $actualJson, string $message = ''): void
Asserts that a string is a valid JSON string.
Parameters
-
string
$actualJson -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertJsonFileEqualsJsonFile() ¶ public static
assertJsonFileEqualsJsonFile(string $expectedFile, string $actualFile, string $message = ''): void
Asserts that two JSON files are equal.
Parameters
-
string
$expectedFile -
string
$actualFile -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertJsonFileNotEqualsJsonFile() ¶ public static
assertJsonFileNotEqualsJsonFile(string $expectedFile, string $actualFile, string $message = ''): void
Asserts that two JSON files are not equal.
Parameters
-
string
$expectedFile -
string
$actualFile -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertJsonStringEqualsJsonFile() ¶ public static
assertJsonStringEqualsJsonFile(string $expectedFile, string $actualJson, string $message = ''): void
Asserts that the generated JSON encoded object and the content of the given file are equal.
Parameters
-
string
$expectedFile -
string
$actualJson -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertJsonStringEqualsJsonString() ¶ public static
assertJsonStringEqualsJsonString(string $expectedJson, string $actualJson, string $message = ''): void
Asserts that two given JSON encoded objects or arrays are equal.
Parameters
-
string
$expectedJson -
string
$actualJson -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertJsonStringNotEqualsJsonFile() ¶ public static
assertJsonStringNotEqualsJsonFile(string $expectedFile, string $actualJson, string $message = ''): void
Asserts that the generated JSON encoded object and the content of the given file are not equal.
Parameters
-
string
$expectedFile -
string
$actualJson -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertJsonStringNotEqualsJsonString() ¶ public static
assertJsonStringNotEqualsJsonString(string $expectedJson, string $actualJson, string $message = ''): void
Asserts that two given JSON encoded objects or arrays are not equal.
Parameters
-
string
$expectedJson -
string
$actualJson -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertLessThan() ¶ public static
assertLessThan(mixed $expected, mixed $actual, string $message = ''): void
Asserts that a value is smaller than another value.
Parameters
-
$expected
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertLessThanOrEqual() ¶ public static
assertLessThanOrEqual(mixed $expected, mixed $actual, string $message = ''): void
Asserts that a value is smaller than or equal to another value.
Parameters
-
$expected
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertMatchesRegularExpression() ¶ public static
assertMatchesRegularExpression(string $pattern, string $string, string $message = ''): void
Asserts that a string matches a given regular expression.
Parameters
-
string
$pattern Regex pattern
-
string
$string String to test
-
string
$message optional Message
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
assertNan() ¶ public static
assertNan(mixed $actual, string $message = ''): void
Asserts that a variable is nan.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertNotContains() ¶ public static
assertNotContains(mixed $needle, iterable $haystack, string $message = ''): void
Asserts that a haystack does not contain a needle.
Parameters
-
$needle
-
iterable
$haystack -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
Exception
ExpectationFailedException
assertNotContainsEquals() ¶ public static
assertNotContainsEquals(mixed $needle, iterable $haystack, string $message = ''): void
Parameters
-
$needle
-
iterable
$haystack -
string
$message optional
Returns
void
assertNotContainsOnly() ¶ public static
assertNotContainsOnly(string $type, iterable $haystack, ?bool $isNativeType = null, string $message = ''): void
Asserts that a haystack does not contain only values of a given type.
Parameters
-
string
$type -
iterable
$haystack -
?bool
$isNativeType optional -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertNotCount() ¶ public static
assertNotCount(int $expectedCount, Countable|iterable $haystack, string $message = ''): void
Asserts the number of elements of an array, Countable or Traversable.
Parameters
-
int
$expectedCount -
Countable|iterable
$haystack -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
Exception
ExpectationFailedException
assertNotEmpty() ¶ public static
assertNotEmpty(mixed $actual, string $message = ''): void
Asserts that a variable is not empty.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertNotEquals() ¶ public static
assertNotEquals(mixed $expected, mixed $actual, string $message = ''): void
Asserts that two variables are not equal.
Parameters
-
$expected
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertNotEqualsCanonicalizing() ¶ public static
assertNotEqualsCanonicalizing(mixed $expected, mixed $actual, string $message = ''): void
Asserts that two variables are not equal (canonicalizing).
Parameters
-
$expected
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertNotEqualsIgnoringCase() ¶ public static
assertNotEqualsIgnoringCase(mixed $expected, mixed $actual, string $message = ''): void
Asserts that two variables are not equal (ignoring case).
Parameters
-
$expected
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertNotEqualsWithDelta() ¶ public static
assertNotEqualsWithDelta(mixed $expected, mixed $actual, float $delta, string $message = ''): void
Asserts that two variables are not equal (with delta).
Parameters
-
$expected
-
$actual
-
float
$delta -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertNotFalse() ¶ public static
assertNotFalse(mixed $condition, string $message = ''): void
Asserts that a condition is not false.
Parameters
-
$condition
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertNotInstanceOf() ¶ public static
assertNotInstanceOf(string $expected, mixed $actual, string $message = ''): void
Asserts that a variable is not of a given type.
Parameters
-
string
$expected -
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
Exception
ExpectationFailedException
assertNotIsReadable() ¶ public static
assertNotIsReadable(string $filename, string $message = ''): void
Asserts that a file/dir exists and is not readable.
Parameters
-
string
$filename -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertNotIsWritable() ¶ public static
assertNotIsWritable(string $filename, string $message = ''): void
Asserts that a file/dir exists and is not writable.
Parameters
-
string
$filename -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertNotNull() ¶ public static
assertNotNull(mixed $actual, string $message = ''): void
Asserts that a variable is not null.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertNotRegExp() ¶ public static
assertNotRegExp(string $pattern, string $string, string $message = ''): void
Asserts that a string does not match a given regular expression.
Parameters
-
string
$pattern -
string
$string -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertNotSame() ¶ public static
assertNotSame(mixed $expected, mixed $actual, string $message = ''): void
Asserts that two variables do not have the same type and value. Used on objects, it asserts that two variables do not reference the same object.
Parameters
-
$expected
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertNotSameSize() ¶ public static
assertNotSameSize(Countable|iterable $expected, Countable|iterable $actual, string $message = ''): void
Assert that the size of two arrays (or Countable
or Traversable
objects)
is not the same.
Parameters
-
Countable|iterable
$expected -
Countable|iterable
$actual -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
Exception
ExpectationFailedException
assertNotTrue() ¶ public static
assertNotTrue(mixed $condition, string $message = ''): void
Asserts that a condition is not true.
Parameters
-
$condition
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertNotWithinRange() ¶ protected static
assertNotWithinRange(float $expected, float $result, float $margin, string $message = ''): void
Compatibility function to test if a value is not between an acceptable range.
Parameters
-
float
$expected -
float
$result -
float
$margin the rage of acceptation
-
string
$message optional the text to display if the assertion is not correct
Returns
void
assertNull() ¶ public static
assertNull(mixed $actual, string $message = ''): void
Asserts that a variable is null.
Parameters
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertObjectEquals() ¶ public static
assertObjectEquals(object $expected, object $actual, string $method = 'equals', string $message = ''): void
Parameters
-
object
$expected -
object
$actual -
string
$method optional -
string
$message optional
Returns
void
Throws
ExpectationFailedException
assertObjectHasAttribute() ¶ public static
assertObjectHasAttribute(string $attributeName, object $object, string $message = ''): void
Asserts that an object has a specified attribute.
Parameters
-
string
$attributeName -
object
$object -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
Exception
ExpectationFailedException
assertObjectHasProperty() ¶ public static
assertObjectHasProperty(string $propertyName, object $object, string $message = ''): void
Asserts that an object has a specified property.
Parameters
-
string
$propertyName -
object
$object -
string
$message optional
Returns
void
Throws
ExpectationFailedException
assertObjectNotHasAttribute() ¶ public static
assertObjectNotHasAttribute(string $attributeName, object $object, string $message = ''): void
Asserts that an object does not have a specified attribute.
Parameters
-
string
$attributeName -
object
$object -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
Exception
ExpectationFailedException
assertObjectNotHasProperty() ¶ public static
assertObjectNotHasProperty(string $propertyName, object $object, string $message = ''): void
Asserts that an object does not have a specified property.
Parameters
-
string
$propertyName -
object
$object -
string
$message optional
Returns
void
Throws
ExpectationFailedException
assertOutputContains() ¶ public
assertOutputContains(string $expected, string $message = ''): void
Asserts stdout
contains expected output
Parameters
-
string
$expected Expected output
-
string
$message optional Failure message
Returns
void
assertOutputContainsRow() ¶ protected
assertOutputContainsRow(array $row, string $message = ''): void
Check that a row of cells exists in the output.
Parameters
-
array
$row Row of cells to ensure exist in the output.
-
string
$message optional Failure message.
Returns
void
assertOutputEmpty() ¶ public
assertOutputEmpty(string $message = ''): void
Asserts that stdout
is empty
Parameters
-
string
$message optional The message to output when the assertion fails.
Returns
void
assertOutputNotContains() ¶ public
assertOutputNotContains(string $expected, string $message = ''): void
Asserts stdout
does not contain expected output
Parameters
-
string
$expected Expected output
-
string
$message optional Failure message
Returns
void
assertOutputRegExp() ¶ public
assertOutputRegExp(string $pattern, string $message = ''): void
Asserts stdout
contains expected regexp
Parameters
-
string
$pattern Expected pattern
-
string
$message optional Failure message
Returns
void
assertPathEquals() ¶ protected static
assertPathEquals(string $expected, string $result, string $message = ''): void
Compatibility function to test paths.
Parameters
-
string
$expected -
string
$result -
string
$message optional the text to display if the assertion is not correct
Returns
void
assertPostConditions() ¶ protected
assertPostConditions(): void
Performs assertions shared by all tests of a test case.
This method is called between test and tearDown().
Returns
void
assertPreConditions() ¶ protected
assertPreConditions(): void
Performs assertions shared by all tests of a test case.
This method is called between setUp() and test.
Returns
void
assertRegExp() ¶ public static
assertRegExp(string $pattern, string $string, string $message = ''): void
Asserts that a string matches a given regular expression.
Parameters
-
string
$pattern -
string
$string -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertRegExpSql() ¶ public
assertRegExpSql(string $pattern, string $actual, bool $optional = false): void
Assertion for comparing a regex pattern against a query having its identifiers
quoted. It accepts queries quoted with the characters <
and >
. If the third
parameter is set to true, it will alter the pattern to both accept quoted and
unquoted queries
Parameters
-
string
$pattern The expected sql pattern
-
string
$actual The sql to compare
-
bool
$optional optional Whether quote characters (marked with <>) are optional
Returns
void
assertSame() ¶ public static
assertSame(mixed $expected, mixed $actual, string $message = ''): void
Asserts that two variables have the same type and value. Used on objects, it asserts that two variables reference the same object.
Parameters
-
$expected
-
$actual
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertSameSize() ¶ public static
assertSameSize(Countable|iterable $expected, Countable|iterable $actual, string $message = ''): void
Assert that the size of two arrays (or Countable
or Traversable
objects)
is the same.
Parameters
-
Countable|iterable
$expected -
Countable|iterable
$actual -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
Exception
ExpectationFailedException
assertStringContainsString() ¶ public static
assertStringContainsString(string $needle, string $haystack, string $message = ''): void
Parameters
-
string
$needle -
string
$haystack -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertStringContainsStringIgnoringCase() ¶ public static
assertStringContainsStringIgnoringCase(string $needle, string $haystack, string $message = ''): void
Parameters
-
string
$needle -
string
$haystack -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertStringEndsNotWith() ¶ public static
assertStringEndsNotWith(string $suffix, string $string, string $message = ''): void
Asserts that a string ends not with a given suffix.
Parameters
-
string
$suffix -
string
$string -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertStringEndsWith() ¶ public static
assertStringEndsWith(string $suffix, string $string, string $message = ''): void
Asserts that a string ends with a given suffix.
Parameters
-
string
$suffix -
string
$string -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertStringEqualsFile() ¶ public static
assertStringEqualsFile(string $expectedFile, string $actualString, string $message = ''): void
Asserts that the contents of a string is equal to the contents of a file.
Parameters
-
string
$expectedFile -
string
$actualString -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertStringEqualsFileCanonicalizing() ¶ public static
assertStringEqualsFileCanonicalizing(string $expectedFile, string $actualString, string $message = ''): void
Asserts that the contents of a string is equal to the contents of a file (canonicalizing).
Parameters
-
string
$expectedFile -
string
$actualString -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertStringEqualsFileIgnoringCase() ¶ public static
assertStringEqualsFileIgnoringCase(string $expectedFile, string $actualString, string $message = ''): void
Asserts that the contents of a string is equal to the contents of a file (ignoring case).
Parameters
-
string
$expectedFile -
string
$actualString -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertStringMatchesFormat() ¶ public static
assertStringMatchesFormat(string $format, string $string, string $message = ''): void
Asserts that a string matches a given format string.
Parameters
-
string
$format -
string
$string -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertStringMatchesFormatFile() ¶ public static
assertStringMatchesFormatFile(string $formatFile, string $string, string $message = ''): void
Asserts that a string matches a given format file.
Parameters
-
string
$formatFile -
string
$string -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertStringNotContainsString() ¶ public static
assertStringNotContainsString(string $needle, string $haystack, string $message = ''): void
Parameters
-
string
$needle -
string
$haystack -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertStringNotContainsStringIgnoringCase() ¶ public static
assertStringNotContainsStringIgnoringCase(string $needle, string $haystack, string $message = ''): void
Parameters
-
string
$needle -
string
$haystack -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertStringNotEqualsFile() ¶ public static
assertStringNotEqualsFile(string $expectedFile, string $actualString, string $message = ''): void
Asserts that the contents of a string is not equal to the contents of a file.
Parameters
-
string
$expectedFile -
string
$actualString -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertStringNotEqualsFileCanonicalizing() ¶ public static
assertStringNotEqualsFileCanonicalizing(string $expectedFile, string $actualString, string $message = ''): void
Asserts that the contents of a string is not equal to the contents of a file (canonicalizing).
Parameters
-
string
$expectedFile -
string
$actualString -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertStringNotEqualsFileIgnoringCase() ¶ public static
assertStringNotEqualsFileIgnoringCase(string $expectedFile, string $actualString, string $message = ''): void
Asserts that the contents of a string is not equal to the contents of a file (ignoring case).
Parameters
-
string
$expectedFile -
string
$actualString -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertStringNotMatchesFormat() ¶ public static
assertStringNotMatchesFormat(string $format, string $string, string $message = ''): void
Asserts that a string does not match a given format string.
Parameters
-
string
$format -
string
$string -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertStringNotMatchesFormatFile() ¶ public static
assertStringNotMatchesFormatFile(string $formatFile, string $string, string $message = ''): void
Asserts that a string does not match a given format string.
Parameters
-
string
$formatFile -
string
$string -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertStringStartsNotWith() ¶ public static
assertStringStartsNotWith(string $prefix, string $string, string $message = ''): void
Asserts that a string starts not with a given prefix.
Parameters
-
string
$prefix -
string
$string -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertStringStartsWith() ¶ public static
assertStringStartsWith(string $prefix, string $string, string $message = ''): void
Asserts that a string starts with a given prefix.
Parameters
-
string
$prefix -
string
$string -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertTextContains() ¶ public
assertTextContains(string $needle, string $haystack, string $message = '', bool $ignoreCase = false): void
Assert that a string contains another string, ignoring differences in newlines. Helpful for doing cross platform tests of blocks of text.
Parameters
-
string
$needle The string to search for.
-
string
$haystack The string to search through.
-
string
$message optional The message to display on failure.
-
bool
$ignoreCase optional Whether the search should be case-sensitive.
Returns
void
assertTextEndsNotWith() ¶ public
assertTextEndsNotWith(string $suffix, string $string, string $message = ''): void
Asserts that a string ends not with a given prefix, ignoring differences in newlines. Helpful for doing cross platform tests of blocks of text.
Parameters
-
string
$suffix The suffix to not find.
-
string
$string The string to search.
-
string
$message optional The message to use for failure.
Returns
void
assertTextEndsWith() ¶ public
assertTextEndsWith(string $suffix, string $string, string $message = ''): void
Asserts that a string ends with a given prefix, ignoring differences in newlines. Helpful for doing cross platform tests of blocks of text.
Parameters
-
string
$suffix The suffix to find.
-
string
$string The string to search.
-
string
$message optional The message to use for failure.
Returns
void
assertTextEquals() ¶ public
assertTextEquals(string $expected, string $result, string $message = ''): void
Assert text equality, ignoring differences in newlines. Helpful for doing cross platform tests of blocks of text.
Parameters
-
string
$expected The expected value.
-
string
$result The actual value.
-
string
$message optional The message to use for failure.
Returns
void
assertTextNotContains() ¶ public
assertTextNotContains(string $needle, string $haystack, string $message = '', bool $ignoreCase = false): void
Assert that a text doesn't contain another text, ignoring differences in newlines. Helpful for doing cross platform tests of blocks of text.
Parameters
-
string
$needle The string to search for.
-
string
$haystack The string to search through.
-
string
$message optional The message to display on failure.
-
bool
$ignoreCase optional Whether the search should be case-sensitive.
Returns
void
assertTextNotEquals() ¶ public
assertTextNotEquals(string $expected, string $result, string $message = ''): void
Assert text equality, ignoring differences in newlines. Helpful for doing cross platform tests of blocks of text.
Parameters
-
string
$expected The expected value.
-
string
$result The actual value.
-
string
$message optional The message to use for failure.
Returns
void
assertTextStartsNotWith() ¶ public
assertTextStartsNotWith(string $prefix, string $string, string $message = ''): void
Asserts that a string starts not with a given prefix, ignoring differences in newlines. Helpful for doing cross platform tests of blocks of text.
Parameters
-
string
$prefix The prefix to not find.
-
string
$string The string to search.
-
string
$message optional The message to use for failure.
Returns
void
assertTextStartsWith() ¶ public
assertTextStartsWith(string $prefix, string $string, string $message = ''): void
Asserts that a string starts with a given prefix, ignoring differences in newlines. Helpful for doing cross platform tests of blocks of text.
Parameters
-
string
$prefix The prefix to check for.
-
string
$string The string to search in.
-
string
$message optional The message to use for failure.
Returns
void
assertThat() ¶ public static
assertThat(mixed $value, Constraint $constraint, string $message = ''): void
Evaluates a PHPUnit\Framework\Constraint matcher object.
Parameters
-
$value
-
Constraint
$constraint -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertTrue() ¶ public static
assertTrue(mixed $condition, string $message = ''): void
Asserts that a condition is true.
Parameters
-
$condition
-
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertWithinRange() ¶ protected static
assertWithinRange(float $expected, float $result, float $margin, string $message = ''): void
Compatibility function to test if a value is between an acceptable range.
Parameters
-
float
$expected -
float
$result -
float
$margin the rage of acceptation
-
string
$message optional the text to display if the assertion is not correct
Returns
void
assertXmlFileEqualsXmlFile() ¶ public static
assertXmlFileEqualsXmlFile(string $expectedFile, string $actualFile, string $message = ''): void
Asserts that two XML files are equal.
Parameters
-
string
$expectedFile -
string
$actualFile -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
Exception
ExpectationFailedException
assertXmlFileNotEqualsXmlFile() ¶ public static
assertXmlFileNotEqualsXmlFile(string $expectedFile, string $actualFile, string $message = ''): void
Asserts that two XML files are not equal.
Parameters
-
string
$expectedFile -
string
$actualFile -
string
$message optional
Returns
void
Throws
PHPUnit\Util\Exception
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
assertXmlStringEqualsXmlFile() ¶ public static
assertXmlStringEqualsXmlFile(string $expectedFile, DOMDocument|string $actualXml, string $message = ''): void
Asserts that two XML documents are equal.
Parameters
-
string
$expectedFile -
DOMDocument|string
$actualXml -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
Xml\Exception
assertXmlStringEqualsXmlString() ¶ public static
assertXmlStringEqualsXmlString(DOMDocument|string $expectedXml, DOMDocument|string $actualXml, string $message = ''): void
Asserts that two XML documents are equal.
Parameters
-
DOMDocument|string
$expectedXml -
DOMDocument|string
$actualXml -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
Xml\Exception
assertXmlStringNotEqualsXmlFile() ¶ public static
assertXmlStringNotEqualsXmlFile(string $expectedFile, DOMDocument|string $actualXml, string $message = ''): void
Asserts that two XML documents are not equal.
Parameters
-
string
$expectedFile -
DOMDocument|string
$actualXml -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
Xml\Exception
assertXmlStringNotEqualsXmlString() ¶ public static
assertXmlStringNotEqualsXmlString(DOMDocument|string $expectedXml, DOMDocument|string $actualXml, string $message = ''): void
Asserts that two XML documents are not equal.
Parameters
-
DOMDocument|string
$expectedXml -
DOMDocument|string
$actualXml -
string
$message optional
Returns
void
Throws
SebastianBergmann\RecursionContext\InvalidArgumentException
ExpectationFailedException
Xml\Exception
at() ¶ public static
at(int $index): InvokedAtIndexMatcher
Returns a matcher that matches when the method is executed at the given index.
Parameters
-
int
$index
Returns
InvokedAtIndexMatcher
atLeast() ¶ public static
atLeast(int $requiredInvocations): InvokedAtLeastCountMatcher
Returns a matcher that matches when the method is executed at least N times.
Parameters
-
int
$requiredInvocations
Returns
InvokedAtLeastCountMatcher
atLeastOnce() ¶ public static
atLeastOnce(): InvokedAtLeastOnceMatcher
Returns a matcher that matches when the method is executed at least once.
Returns
InvokedAtLeastOnceMatcher
atMost() ¶ public static
atMost(int $allowedInvocations): InvokedAtMostCountMatcher
Returns a matcher that matches when the method is executed at most N times.
Parameters
-
int
$allowedInvocations
Returns
InvokedAtMostCountMatcher
callback() ¶ public static
callback(callable $callback): Callback
Parameters
-
callable
$callback
Returns
Callback
classHasAttribute() ¶ public static
classHasAttribute(string $attributeName): ClassHasAttribute
Parameters
-
string
$attributeName
Returns
ClassHasAttribute
classHasStaticAttribute() ¶ public static
classHasStaticAttribute(string $attributeName): ClassHasStaticAttribute
Parameters
-
string
$attributeName
Returns
ClassHasStaticAttribute
cleanupConsoleTrait() ¶ public
cleanupConsoleTrait(): void
Cleans state to get ready for the next test
Returns
void
cleanupContainer() ¶ public
cleanupContainer(): void
Clears any mocks that were defined and cleans up application class configuration.
Returns
void
clearPlugins() ¶ public
clearPlugins(): void
Clear all plugins from the global plugin collection.
Useful in test case teardown methods.
Returns
void
commandStringToArgs() ¶ protected
commandStringToArgs(string $command): array<string>
Creates an $argv array from a command string
Parameters
-
string
$command Command string
Returns
array<string>
configApplication() ¶ public
configApplication(string $class, array|null $constructorArgs): void
Configure the application class to use in integration tests.
Parameters
-
string
$class The application class name.
-
array|null
$constructorArgs The constructor arguments for your application class.
Returns
void
containsEqual() ¶ public static
containsEqual(mixed $value): TraversableContainsEqual
Parameters
-
$value
Returns
TraversableContainsEqual
containsIdentical() ¶ public static
containsIdentical(mixed $value): TraversableContainsIdentical
Parameters
-
$value
Returns
TraversableContainsIdentical
containsOnly() ¶ public static
containsOnly(string $type): TraversableContainsOnly
Parameters
-
string
$type
Returns
TraversableContainsOnly
containsOnlyInstancesOf() ¶ public static
containsOnlyInstancesOf(string $className): TraversableContainsOnly
Parameters
-
string
$className
Returns
TraversableContainsOnly
createApp() ¶ protected
createApp(): Cake\Core\HttpApplicationInterface|Cake\Core\ConsoleApplicationInterface
Create an application instance.
Uses the configuration set in configApplication()
.
Returns
Cake\Core\HttpApplicationInterface|Cake\Core\ConsoleApplicationInterface
createConfiguredMock() ¶ protected
createConfiguredMock(string $originalClassName, array $configuration): MockObject
Returns a configured mock object for the specified class.
Parameters
-
string
$originalClassName -
array
$configuration
Returns
MockObject
createMock() ¶ protected
createMock(string $originalClassName): MockObject
Returns a mock object for the specified class.
Parameters
-
string
$originalClassName
Returns
MockObject
createPartialMock() ¶ protected
createPartialMock(string $originalClassName, string[] $methods): MockObject
Returns a partial mock object for the specified class.
Parameters
-
string
$originalClassName -
string[]
$methods
Returns
MockObject
createResult() ¶ protected
createResult(): TestResult
Creates a default TestResult object.
Returns
TestResult
createStub() ¶ protected
createStub(string $originalClassName): Stub
Makes configurable stub for the specified class.
Parameters
-
string
$originalClassName
Returns
Stub
createTestProxy() ¶ protected
createTestProxy(string $originalClassName, array $constructorArguments = []): MockObject
Returns a test proxy for the specified class.
Parameters
-
string
$originalClassName -
array
$constructorArguments optional
Returns
MockObject
deprecated() ¶ public
deprecated(callable $callable): void
Helper method for check deprecation methods
Parameters
-
callable
$callable callable function that will receive asserts
Returns
void
equalToCanonicalizing() ¶ public static
equalToCanonicalizing(mixed $value): IsEqualCanonicalizing
Parameters
-
$value
Returns
IsEqualCanonicalizing
equalToIgnoringCase() ¶ public static
equalToIgnoringCase(mixed $value): IsEqualIgnoringCase
Parameters
-
$value
Returns
IsEqualIgnoringCase
equalToWithDelta() ¶ public static
equalToWithDelta(mixed $value, float $delta): IsEqualWithDelta
Parameters
-
$value
-
float
$delta
Returns
IsEqualWithDelta
exactly() ¶ public static
exactly(int $count): InvokedCountMatcher
Returns a matcher that matches when the method is executed exactly $count times.
Parameters
-
int
$count
Returns
InvokedCountMatcher
exec() ¶ public
exec(string $command, array $input = []): void
Runs CLI integration test
Parameters
-
string
$command Command to run
-
array
$input optional Input values to pass to an interactive shell
Returns
void
Throws
Cake\Console\TestSuite\MissingConsoleInputException
RuntimeException
expectDeprecationMessage() ¶ public
expectDeprecationMessage(string $message): void
Parameters
-
string
$message
Returns
void
expectDeprecationMessageMatches() ¶ public
expectDeprecationMessageMatches(string $regularExpression): void
Parameters
-
string
$regularExpression
Returns
void
expectErrorMessage() ¶ public
expectErrorMessage(string $message): void
Parameters
-
string
$message
Returns
void
expectErrorMessageMatches() ¶ public
expectErrorMessageMatches(string $regularExpression): void
Parameters
-
string
$regularExpression
Returns
void
expectException() ¶ public
expectException(string $exception): void
Parameters
-
string
$exception
Returns
void
expectExceptionCode() ¶ public
expectExceptionCode(int|string $code): void
Parameters
-
int|string
$code
Returns
void
expectExceptionMessage() ¶ public
expectExceptionMessage(string $message): void
Parameters
-
string
$message
Returns
void
expectExceptionMessageMatches() ¶ public
expectExceptionMessageMatches(string $regularExpression): void
Parameters
-
string
$regularExpression
Returns
void
expectExceptionObject() ¶ public
expectExceptionObject(Exception $exception): void
Sets up an expectation for an exception to be raised by the code under test. Information for expected exception class, expected exception message, and expected exception code are retrieved from a given Exception object.
Parameters
-
Exception
$exception
Returns
void
expectNoticeMessage() ¶ public
expectNoticeMessage(string $message): void
Parameters
-
string
$message
Returns
void
expectNoticeMessageMatches() ¶ public
expectNoticeMessageMatches(string $regularExpression): void
Parameters
-
string
$regularExpression
Returns
void
expectOutputRegex() ¶ public
expectOutputRegex(string $expectedRegex): void
Parameters
-
string
$expectedRegex
Returns
void
expectOutputString() ¶ public
expectOutputString(string $expectedString): void
Parameters
-
string
$expectedString
Returns
void
expectWarningMessage() ¶ public
expectWarningMessage(string $message): void
Parameters
-
string
$message
Returns
void
expectWarningMessageMatches() ¶ public
expectWarningMessageMatches(string $regularExpression): void
Parameters
-
string
$regularExpression
Returns
void
fail() ¶ public static
fail(string $message = ''): void
Fails a test with the given message.
Parameters
-
string
$message optional
Returns
void
Throws
AssertionFailedError
fetchTable() ¶ public
fetchTable(string|null $alias = null, array<string, mixed> $options = []): Cake\ORM\Table
Convenience method to get a table instance.
Parameters
-
string|null
$alias optional The alias name you want to get. Should be in CamelCase format. If
null
then the value of $defaultTable property is used.-
array<string, mixed>
$options optional The options you want to build the table with. If a table has already been loaded the registry options will be ignored.
Returns
Cake\ORM\Table
Throws
Cake\Core\Exception\CakeException
If `$alias` argument and `$defaultTable` property both are `null`.
See Also
getDataSetAsString() ¶ public
getDataSetAsString(bool $includeData = true): string
Parameters
-
bool
$includeData optional
Returns
string
getExpectedExceptionCode() ¶ public
getExpectedExceptionCode(): null|int|string
Returns
null|int|string
getExpectedExceptionMessageRegExp() ¶ public
getExpectedExceptionMessageRegExp(): ?string
Returns
?string
getFixtureStrategy() ¶ protected
getFixtureStrategy(): Cake\TestSuite\Fixture\FixtureStrategyInterface
Returns fixture strategy used by these tests.
Returns
Cake\TestSuite\Fixture\FixtureStrategyInterface
getFixtures() ¶ public
getFixtures(): array<string>
Get the fixtures this test should use.
Returns
array<string>
getMockBuilder() ¶ public
getMockBuilder(string $className): MockBuilder
Returns a builder object to create mock objects using a fluent interface.
Parameters
-
string
$className
Returns
MockBuilder
getMockClass() ¶ protected
getMockClass(string $originalClassName, null|array $methods = [], array $arguments = [], string $mockClassName = '', bool $callOriginalConstructor = false, bool $callOriginalClone = true, bool $callAutoload = true, bool $cloneArguments = false): string
Mocks the specified class and returns the name of the mocked class.
Parameters
-
string
$originalClassName -
null|array
$methods optional $methods
-
array
$arguments optional -
string
$mockClassName optional -
bool
$callOriginalConstructor optional -
bool
$callOriginalClone optional -
bool
$callAutoload optional -
bool
$cloneArguments optional
Returns
string
getMockForAbstractClass() ¶ protected
getMockForAbstractClass(string $originalClassName, array $arguments = [], string $mockClassName = '', bool $callOriginalConstructor = true, bool $callOriginalClone = true, bool $callAutoload = true, array $mockedMethods = [], bool $cloneArguments = false): MockObject
Returns a mock object for the specified abstract class with all abstract methods of the class mocked. Concrete methods are not mocked by default. To mock concrete methods, use the 7th parameter ($mockedMethods).
Parameters
-
string
$originalClassName -
array
$arguments optional -
string
$mockClassName optional -
bool
$callOriginalConstructor optional -
bool
$callOriginalClone optional -
bool
$callAutoload optional -
array
$mockedMethods optional -
bool
$cloneArguments optional
Returns
MockObject
getMockForModel() ¶ public
getMockForModel(string $alias, array<string> $methods = [], array<string, mixed> $options = []): Cake\ORM\Table|PHPUnit\Framework\MockObject\MockObject
Mock a model, maintain fixtures and table association
Parameters
-
string
$alias The model to get a mock for.
-
array<string>
$methods optional The list of methods to mock
-
array<string, mixed>
$options optional The config data for the mock's constructor.
Returns
Cake\ORM\Table|PHPUnit\Framework\MockObject\MockObject
Throws
Cake\ORM\Exception\MissingTableClassException
getMockForTrait() ¶ protected
getMockForTrait(string $traitName, array $arguments = [], string $mockClassName = '', bool $callOriginalConstructor = true, bool $callOriginalClone = true, bool $callAutoload = true, array $mockedMethods = [], bool $cloneArguments = false): MockObject
Returns a mock object for the specified trait with all abstract methods
of the trait mocked. Concrete methods to mock can be specified with the
$mockedMethods
parameter.
Parameters
-
string
$traitName -
array
$arguments optional -
string
$mockClassName optional -
bool
$callOriginalConstructor optional -
bool
$callOriginalClone optional -
bool
$callAutoload optional -
array
$mockedMethods optional -
bool
$cloneArguments optional
Returns
MockObject
getMockFromWsdl() ¶ protected
getMockFromWsdl(string $wsdlFile, string $originalClassName = '', string $mockClassName = '', array $methods = [], bool $callOriginalConstructor = true, array $options = []): MockObject
Returns a mock object based on the given WSDL file.
Parameters
-
string
$wsdlFile -
string
$originalClassName optional -
string
$mockClassName optional -
array
$methods optional -
bool
$callOriginalConstructor optional -
array
$options optional
Returns
MockObject
getName() ¶ public
getName(bool $withDataSet = true): string
Parameters
-
bool
$withDataSet optional
Returns
string
Throws
InvalidArgumentException
getNumAssertions() ¶ public
getNumAssertions(): int
Returns the number of assertions performed by this test.
Returns
int
getObjectForTrait() ¶ protected
getObjectForTrait(string $traitName, array $arguments = [], string $traitClassName = '', bool $callOriginalConstructor = true, bool $callOriginalClone = true, bool $callAutoload = true): object
Returns an object for the specified trait.
Parameters
-
string
$traitName -
array
$arguments optional -
string
$traitClassName optional -
bool
$callOriginalConstructor optional -
bool
$callOriginalClone optional -
bool
$callAutoload optional
Returns
object
getSize() ¶ public
getSize(): int
Returns the size of the test.
Returns
int
Throws
InvalidArgumentException
getTableLocator() ¶ public
getTableLocator(): Cake\ORM\Locator\LocatorInterface
Gets the table locator.
Returns
Cake\ORM\Locator\LocatorInterface
greaterThan() ¶ public static
greaterThan(mixed $value): GreaterThan
Parameters
-
$value
Returns
GreaterThan
greaterThanOrEqual() ¶ public static
greaterThanOrEqual(mixed $value): LogicalOr
Parameters
-
$value
Returns
LogicalOr
identicalTo() ¶ public static
identicalTo(mixed $value): IsIdentical
Parameters
-
$value
Returns
IsIdentical
iniSet() ¶ protected
iniSet(string $varName, string $newValue): void
This method is a wrapper for the ini_set() function that automatically resets the modified php.ini setting to its original value after the test is run.
Parameters
-
string
$varName -
string
$newValue
Returns
void
Throws
Exception
isInstanceOf() ¶ public static
isInstanceOf(string $className): IsInstanceOf
Parameters
-
string
$className
Returns
IsInstanceOf
lessThanOrEqual() ¶ public static
lessThanOrEqual(mixed $value): LogicalOr
Parameters
-
$value
Returns
LogicalOr
loadFixtures() ¶ public
loadFixtures(): void
Chooses which fixtures to load for a given test
Each parameter is a model name that corresponds to a fixture, i.e. 'Posts', 'Authors', etc. Passing no parameters will cause all fixtures on the test case to load.
Returns
void
Throws
RuntimeException
when no fixture manager is available.
See Also
loadPlugins() ¶ public
loadPlugins(array<string, mixed> $plugins = []): Cake\Http\BaseApplication
Load plugins into a simulated application.
Useful to test how plugins being loaded/not loaded interact with other elements in CakePHP or applications.
Parameters
-
array<string, mixed>
$plugins optional List of Plugins to load.
Returns
Cake\Http\BaseApplication
loadRoutes() ¶ public
loadRoutes(array|null $appArgs = null): void
Load routes for the application.
If no application class can be found an exception will be raised.
Routes for plugins will not be loaded. Use loadPlugins()
or use
Cake\TestSuite\IntegrationTestCaseTrait
to better simulate all routes
and plugins being loaded.
Parameters
-
array|null
$appArgs optional Constructor parameters for the application class.
Returns
void
logicalNot() ¶ public static
logicalNot(Constraint $constraint): LogicalNot
Parameters
-
Constraint
$constraint
Returns
LogicalNot
makeRunner() ¶ protected
makeRunner(): Cake\Console\CommandRunner|Cake\Console\TestSuite\LegacyCommandRunner
Builds the appropriate command dispatcher
Returns
Cake\Console\CommandRunner|Cake\Console\TestSuite\LegacyCommandRunner
markTestIncomplete() ¶ public static
markTestIncomplete(string $message = ''): void
Mark the test as incomplete.
Parameters
-
string
$message optional
Returns
void
Throws
IncompleteTestError
markTestSkipped() ¶ public static
markTestSkipped(string $message = ''): void
Mark the test as skipped.
Parameters
-
string
$message optional
Returns
void
Throws
SkippedTestError
SyntheticSkippedError
matches() ¶ public static
matches(string $string): StringMatchesFormatDescription
Parameters
-
string
$string
Returns
StringMatchesFormatDescription
matchesRegularExpression() ¶ public static
matchesRegularExpression(string $pattern): RegularExpression
Parameters
-
string
$pattern
Returns
RegularExpression
mockService() ¶ public
mockService(string $class, Closure $factory): $this
Add a mocked service to the container.
When the container is created the provided classname will be mapped to the factory function. The factory function will be used to create mocked services.
Parameters
-
string
$class The class or interface you want to define.
-
Closure
$factory The factory function for mocked services.
Returns
$this
modifyContainer() ¶ public
modifyContainer(Cake\Event\EventInterface $event, Cake\Core\ContainerInterface $container): Cake\Core\ContainerInterface|null
Wrap the application's container with one containing mocks.
If any mocked services are defined, the application's container will be replaced with one containing mocks. The original container will be set as a delegate to the mock container.
Parameters
-
Cake\Event\EventInterface
$event The event
-
Cake\Core\ContainerInterface
$container The container to wrap.
Returns
Cake\Core\ContainerInterface|null
never() ¶ public static
never(): InvokedCountMatcher
Returns a matcher that matches when the method is never executed.
Returns
InvokedCountMatcher
objectEquals() ¶ public static
objectEquals(object $object, string $method = 'equals'): ObjectEquals
Parameters
-
object
$object -
string
$method optional
Returns
ObjectEquals
objectHasAttribute() ¶ public static
objectHasAttribute(mixed $attributeName): ObjectHasAttribute
Parameters
-
$attributeName
Returns
ObjectHasAttribute
onConsecutiveCalls() ¶ public static
onConsecutiveCalls(mixed ...$args): ConsecutiveCallsStub
Parameters
-
...$args
Returns
ConsecutiveCallsStub
onNotSuccessfulTest() ¶ protected
onNotSuccessfulTest(Throwable $t): void
This method is called when a test method did not execute successfully.
Parameters
-
Throwable
$t
Returns
void
Throws
Throwable
once() ¶ public static
once(): InvokedCountMatcher
Returns a matcher that matches when the method is executed exactly once.
Returns
InvokedCountMatcher
prophesize() ¶ protected
prophesize(?string $classOrInterface = null): ObjectProphecy
Parameters
-
?string
$classOrInterface optional
Returns
ObjectProphecy
Throws
ClassNotFoundException
DoubleException
InterfaceNotFoundException
provides() ¶ public
provides(): list<ExecutionOrderDependency>
Returns the normalized test name as class::method.
Returns
list<ExecutionOrderDependency>
recordDoubledType() ¶ protected
recordDoubledType(string $originalClassName): void
Parameters
-
string
$originalClassName
Returns
void
registerComparator() ¶ public
registerComparator(Comparator $comparator): void
Parameters
-
Comparator
$comparator
Returns
void
registerMockObject() ¶ public
registerMockObject(MockObject $mockObject): void
Parameters
-
MockObject
$mockObject
Returns
void
removeMockService() ¶ public
removeMockService(string $class): $this
Remove a mocked service to the container.
Parameters
-
string
$class The class or interface you want to remove.
Returns
$this
removePlugins() ¶ public
removePlugins(array<string> $names = []): void
Remove plugins from the global plugin collection.
Useful in test case teardown methods.
Parameters
-
array<string>
$names optional A list of plugins you want to remove.
Returns
void
requires() ¶ public
requires(): list<ExecutionOrderDependency>
Returns a list of normalized dependency names, class::method.
This list can differ from the raw dependencies as the resolver has no need for the [!][shallow]clone prefix that is filtered out during normalization.
Returns
list<ExecutionOrderDependency>
returnArgument() ¶ public static
returnArgument(int $argumentIndex): ReturnArgumentStub
Parameters
-
int
$argumentIndex
Returns
ReturnArgumentStub
returnCallback() ¶ public static
returnCallback(mixed $callback): ReturnCallbackStub
Parameters
-
$callback
Returns
ReturnCallbackStub
returnSelf() ¶ public static
returnSelf(): ReturnSelfStub
Returns the current object.
This method is useful when mocking a fluent interface.
Returns
ReturnSelfStub
returnValue() ¶ public static
returnValue(mixed $value): ReturnStub
Parameters
-
$value
Returns
ReturnStub
returnValueMap() ¶ public static
returnValueMap(array $valueMap): ReturnValueMapStub
Parameters
-
array
$valueMap
Returns
ReturnValueMapStub
run() ¶ public
run(?TestResult $result = null): TestResult
Runs the test case and collects the results in a TestResult object. If no TestResult object is passed a new one will be created.
Parameters
-
?TestResult
$result optional
Returns
TestResult
Throws
SebastianBergmann\CodeCoverage\InvalidArgumentException
CodeCoverageException
InvalidArgumentException
UnintentionallyCoveredCodeException
UtilException
runTest() ¶ protected
runTest()
Override to run the test and assert its state.
Throws
SebastianBergmann\ObjectEnumerator\InvalidArgumentException
AssertionFailedError
Exception
ExpectationFailedException
Throwable
setAppNamespace() ¶ public static
setAppNamespace(string $appNamespace = 'TestApp'): string|null
Set the app namespace
Parameters
-
string
$appNamespace optional The app namespace, defaults to "TestApp".
Returns
string|null
setBackupGlobals() ¶ public
setBackupGlobals(?bool $backupGlobals): void
Parameters
-
?bool
$backupGlobals
Returns
void
setBackupStaticAttributes() ¶ public
setBackupStaticAttributes(?bool $backupStaticAttributes): void
Parameters
-
?bool
$backupStaticAttributes
Returns
void
setBeStrictAboutChangesToGlobalState() ¶ public
setBeStrictAboutChangesToGlobalState(?bool $beStrictAboutChangesToGlobalState): void
Parameters
-
?bool
$beStrictAboutChangesToGlobalState
Returns
void
setDependencies() ¶ public
setDependencies(list<ExecutionOrderDependency> $dependencies): void
Parameters
-
list<ExecutionOrderDependency>
$dependencies
Returns
void
setDependencyInput() ¶ public
setDependencyInput(array $dependencyInput): void
Parameters
-
array
$dependencyInput
Returns
void
setInIsolation() ¶ public
setInIsolation(bool $inIsolation): void
Parameters
-
bool
$inIsolation
Returns
void
setLocale() ¶ protected
setLocale(mixed ...$args): void
This method is a wrapper for the setlocale() function that automatically resets the locale to its original value after the test is run.
Parameters
-
...$args
Returns
void
Throws
Exception
setOutputCallback() ¶ public
setOutputCallback(callable $callback): void
Parameters
-
callable
$callback
Returns
void
setPreserveGlobalState() ¶ public
setPreserveGlobalState(bool $preserveGlobalState): void
Parameters
-
bool
$preserveGlobalState
Returns
void
setRegisterMockObjectsFromTestArgumentsRecursively() ¶ public
setRegisterMockObjectsFromTestArgumentsRecursively(bool $flag): void
Parameters
-
bool
$flag
Returns
void
setRunClassInSeparateProcess() ¶ public
setRunClassInSeparateProcess(bool $runClassInSeparateProcess): void
Parameters
-
bool
$runClassInSeparateProcess
Returns
void
setRunTestInSeparateProcess() ¶ public
setRunTestInSeparateProcess(bool $runTestInSeparateProcess): void
Parameters
-
bool
$runTestInSeparateProcess
Returns
void
setTableLocator() ¶ public
setTableLocator(Cake\ORM\Locator\LocatorInterface $tableLocator): $this
Sets the table locator.
Parameters
-
Cake\ORM\Locator\LocatorInterface
$tableLocator LocatorInterface instance.
Returns
$this
setTestResultObject() ¶ public
setTestResultObject(TestResult $result): void
Parameters
-
TestResult
$result
Returns
void
setUp() ¶ protected
setUp(): void
Setup the test case, backup the static object values so they can be restored. Specifically backs up the contents of Configure and paths in App if they have not already been backed up.
Returns
void
setUpBeforeClass() ¶ public static
setUpBeforeClass(): void
This method is called before the first test of this test class is run.
Returns
void
setupFixtures() ¶ protected
setupFixtures(): void
Initialized and loads any use fixtures.
Returns
void
skipIf() ¶ public
skipIf(bool $shouldSkip, string $message = ''): bool
Overrides SimpleTestCase::skipIf to provide a boolean return value
Parameters
-
bool
$shouldSkip Whether the test should be skipped.
-
string
$message optional The message to display.
Returns
bool
skipUnless() ¶ protected
skipUnless(bool $condition, string $message = ''): bool
Compatibility function for skipping.
Parameters
-
bool
$condition Condition to trigger skipping
-
string
$message optional Message for skip
Returns
bool
stringContains() ¶ public static
stringContains(string $string, bool $case = true): StringContains
Parameters
-
string
$string -
bool
$case optional
Returns
StringContains
stringEndsWith() ¶ public static
stringEndsWith(string $suffix): StringEndsWith
Parameters
-
string
$suffix
Returns
StringEndsWith
stringStartsWith() ¶ public static
stringStartsWith(mixed $prefix): StringStartsWith
Parameters
-
$prefix
Returns
StringStartsWith
tearDown() ¶ protected
tearDown(): void
teardown any static object changes and restore them.
Returns
void
tearDownAfterClass() ¶ public static
tearDownAfterClass(): void
This method is called after the last test of this test class is run.
Returns
void
throwException() ¶ public static
throwException(Throwable $exception): ExceptionStub
Parameters
-
Throwable
$exception
Returns
ExceptionStub
toString() ¶ public
toString(): string
Returns a string representation of the test case.
Returns
string
Throws
Exception
InvalidArgumentException
useCommandRunner() ¶ public
useCommandRunner(): void
Set this test case to use the CommandRunner rather than the legacy ShellDispatcher
Returns
void
withErrorReporting() ¶ public
withErrorReporting(int $errorLevel, callable $callable): void
Helper method for tests that needs to use error_reporting()
Parameters
-
int
$errorLevel value of error_reporting() that needs to use
-
callable
$callable callable function that will receive asserts
Returns
void
Property Detail
$autoFixtures ¶ public deprecated
By default, all fixtures attached to this class will be truncated and reloaded after each test. Set this to false to handle manually
Type
bool
$dropTables ¶ public deprecated
Control table create/drops on each test method.
If true, tables will still be dropped at the end of each test runner execution.
Type
bool
$fixtureManager ¶ public static
The class responsible for managing the creation, loading and removing of fixtures
Type
Cake\TestSuite\Fixture\FixtureManager|null