Class
IntegrationTestCase

A test case class intended to make integration tests of your controllers easier.

This test class provides a number of helper methods and features that make dispatching requests and checking their responses simpler. It favours full integration tests over mock objects as you can test more of your code easily and avoid some of the maintenance pitfalls that mock objects create.

Abstract
Namespace: Cake\TestSuite
Deprecated: 3.7.0 Will be removed in 5.0.0. Use {@link \Cake\TestSuite\IntegrationTestTrait} 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.
$_controller protected

Cake\Controller\Controller

The controller used in the last request.
$_cookie protected

array

Cookie data to use in the next request.
$_cookieEncryptionKey protected

string|null
$_csrfToken protected

bool

Boolean flag for whether or not the request should have a CSRF token added.
$_exception protected

Throwable|null

The exception being thrown if the case.
$_flashMessages protected

array|null

Stored flash messages before render
$_layoutName protected

string

The last rendered layout
$_request protected

array

The data used to build the next request.
$_requestSession protected

Cake\Http\Session

The session instance from the last request
$_response protected

Psr\Http\Message\ResponseInterface

The response for the most recent request.
$_retainFlashMessages protected

bool

Boolean flag for whether or not the request should re-store flash messages
$_securityToken protected

bool

Boolean flag for whether or not the request should have a SecurityComponent token added.
$_session protected

array

Session data to use in the next request.
$_tableLocator protected

Cake\ORM\Locator\LocatorInterface|null

Table locator instance
$_unlockedFields protected

string[]

List of fields that are excluded from field validation.
$_validCiphers protected

string[]

Valid cipher names for encrypted cookies.
$_viewName protected

string

The last rendered view
$autoFixtures public

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

string[]
$backupStaticAttributes protected

?bool
$backupStaticAttributesBlacklist protected

array<string, array<int, string>>
$dropTables public

bool

Control table create/drops on each test method.
$fixtureManager public

Cake\TestSuite\Fixture\FixtureManager|null

The class responsible for managing the creation, loading and removing of fixtures
$fixtures protected

string[]

Fixtures used by this test case.
$preserveGlobalState protected

bool
$runTestInSeparateProcess protected

?bool

Method Summary

__construct() public
_addTokens() protected

Add the CSRF and Security Component tokens if necessary.
_assertAttributes() protected

Check the attributes as part of an assertTags() check.
_buildRequest() protected

Creates a request object with the configured options and parameters.
_castToString() protected

Recursively casts all data to string as that is how data would be POSTed in the real world
_checkCipher() protected

Helper method for validating encryption cipher names.
_decode() protected

Decodes and decrypts a single value.
_decrypt() protected

Decrypts $value using public $type method in Security class
_encrypt() protected

Encrypts $value using public $type method in Security class
_explode() protected

Explode method to return array from string set in CookieComponent::_implode() Maintains reading backwards compatibility with 1.x CookieComponent::_implode().
_getBodyAsString() protected

Get the response body as string
_getCookieEncryptionKey() protected

Returns the encryption key to be used.
_getTableClassName() protected

Gets the class name for the table.
_handleError() protected

Attempts to render an error response for a given exception.
_implode() protected

Implode method to keep keys are multidimensional arrays
_makeDispatcher() protected

Get the correct dispatcher instance.
_normalizePath() protected

Normalize a path for comparison.
_sendRequest() protected

Creates and send the request into a Dispatcher instance.
_url() protected

Creates a valid request url and parameter array more like Request::_url()
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.
assertArraySubset() public static deprecated

Asserts that an array has a specified subset.
assertAttributeContains() public static deprecated

Asserts that a haystack that is stored in a static attribute of a class or an attribute of an object contains a needle.
assertAttributeContainsOnly() public static deprecated

Asserts that a haystack that is stored in a static attribute of a class or an attribute of an object contains only values of a given type.
assertAttributeCount() public static deprecated

Asserts the number of elements of an array, Countable or Traversable that is stored in an attribute.
assertAttributeEmpty() public static deprecated

Asserts that a static attribute of a class or an attribute of an object is empty.
assertAttributeEquals() public static deprecated

Asserts that a variable is equal to an attribute of an object.
assertAttributeGreaterThan() public static deprecated

Asserts that an attribute is greater than another value.
assertAttributeGreaterThanOrEqual() public static deprecated

Asserts that an attribute is greater than or equal to another value.
assertAttributeInstanceOf() public static deprecated

Asserts that an attribute is of a given type.
assertAttributeInternalType() public static deprecated

Asserts that an attribute is of a given type.
assertAttributeLessThan() public static deprecated

Asserts that an attribute is smaller than another value.
assertAttributeLessThanOrEqual() public static deprecated

Asserts that an attribute is smaller than or equal to another value.
assertAttributeNotContains() public static deprecated

Asserts that a haystack that is stored in a static attribute of a class or an attribute of an object does not contain a needle.
assertAttributeNotContainsOnly() public static deprecated

Asserts that a haystack that is stored in a static attribute of a class or an attribute of an object does not contain only values of a given type.
assertAttributeNotCount() public static deprecated

Asserts the number of elements of an array, Countable or Traversable that is stored in an attribute.
assertAttributeNotEmpty() public static deprecated

Asserts that a static attribute of a class or an attribute of an object is not empty.
assertAttributeNotEquals() public static deprecated

Asserts that a variable is not equal to an attribute of an object.
assertAttributeNotInstanceOf() public static deprecated

Asserts that an attribute is of a given type.
assertAttributeNotInternalType() public static deprecated

Asserts that an attribute is of a given type.
assertAttributeNotSame() public static deprecated

Asserts that a variable and an attribute of an object do not have the same type and value.
assertAttributeSame() public static deprecated

Asserts that a variable and an attribute of an object have the same type and value.
assertClassHasAttribute() public static

Asserts that a class has a specified attribute.
assertClassHasStaticAttribute() public static

Asserts that a class has a specified static attribute.
assertClassNotHasAttribute() public static

Asserts that a class does not have a specified attribute.
assertClassNotHasStaticAttribute() public static

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.
assertContentType() public

Asserts content type
assertCookie() public

Asserts cookie values
assertCookieEncrypted() public

Asserts cookie values which are encrypted by the CookieComponent.
assertCookieNotSet() public

Asserts a cookie has not been set in the response
assertCount() public static

Asserts the number of elements of an array, Countable or Traversable.
assertDirectoryExists() public static

Asserts that a directory exists.
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

Asserts that a directory does not exist.
assertDirectoryNotIsReadable() public static

Asserts that a directory exists and is not readable.
assertDirectoryNotIsWritable() public static

Asserts that a directory exists and is not writable.
assertEmpty() public static

Asserts that a variable is empty.
assertEqualXMLStructure() public static

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).
assertEqualsWithDelta() public static

Asserts that two variables are equal (with delta).
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
assertFalse() public static

Asserts that a condition is false.
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.
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

Asserts that a file does not exist.
assertFileNotIsReadable() public static

Asserts that a file exists and is not readable.
assertFileNotIsWritable() public static

Asserts that a file exists and is not writable.
assertFileResponse() public

Asserts that a file with the given name was sent in the response
assertFinite() public static

Asserts that a variable is finite.
assertFlashElement() public

Asserts a flash element was set
assertFlashElementAt() public

Asserts a flash element was set at a certain index
assertFlashMessage() public

Asserts a flash message was set
assertFlashMessageAt() public

Asserts a flash message was set at a certain index
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.
assertHeader() public

Asserts response headers
assertHeaderContains() public

Asserts response header contains a string
assertHeaderNotContains() public

Asserts response header does not contain a string
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.
assertInternalType() public static deprecated

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.
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.
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.
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.
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.
assertLayout() public

Asserts that the search string was in the layout name.
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.
assertNan() public static

Asserts that a variable is nan.
assertNoRedirect() public

Asserts that the Location header is not set.
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.
assertNotInternalType() public static deprecated

Asserts that a variable is not of a given type.
assertNotIsReadable() public static

Asserts that a file/dir exists and is not readable.
assertNotIsWritable() public static

Asserts that a file/dir exists and is not writable.
assertNotNull() public static

Asserts that a variable is not null.
assertNotRegExp() public static

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 or Traversable 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.
assertObjectHasAttribute() public static

Asserts that an object has a specified attribute.
assertObjectNotHasAttribute() public static

Asserts that an object does not have a specified attribute.
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.
assertRedirect() public

Asserts that the Location header is correct. Comparison is made against a full URL.
assertRedirectContains() public

Asserts that the Location header contains a substring
assertRedirectEquals() public

Asserts that the Location header is correct. Comparison is made against exactly the URL provided.
assertRedirectNotContains() public

Asserts that the Location header does not contain a substring
assertRegExp() public static

Asserts that a string matches a given regular expression.
assertResponseCode() public

Asserts a specific response status code.
assertResponseContains() public

Asserts content exists in the response body.
assertResponseEmpty() public

Assert response content is empty.
assertResponseEquals() public

Asserts content in the response body equals.
assertResponseError() public

Asserts that the response status code is in the 4xx range.
assertResponseFailure() public

Asserts that the response status code is in the 5xx range.
assertResponseNotContains() public

Asserts content does not exist in the response body.
assertResponseNotEmpty() public

Assert response content is not empty.
assertResponseNotEquals() public

Asserts content in the response body not equals.
assertResponseNotRegExp() public

Asserts that the response body does not match a given regular expression.
assertResponseOk() public

Asserts that the response status code is in the 2xx range.
assertResponseRegExp() public

Asserts that the response body matches a given regular expression.
assertResponseSuccess() public

Asserts that the response status code is in the 2xx/3xx range.
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 or Traversable objects) is the same.
assertSession() public

Asserts session contents
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.
assertTemplate() public

Asserts that the search string was in the template name.
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

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.
attribute() public static deprecated
attributeEqualTo() public static deprecated
callback() public static
classHasAttribute() public static
classHasStaticAttribute() public static
cleanup() public

Clears the state used for requests.
clearPlugins() public

Clear all plugins from the global plugin collection.
configApplication() public

Configure the application class to use in integration tests.
configRequest() public

Configures the data for the next request.
contains() public static deprecated
containsEqual() public static
containsIdentical() public static
containsOnly() public static
containsOnlyInstancesOf() public static
controllerSpy() public

Adds additional event spies to the controller/view event manager.
cookie() public

Sets a request cookie for future requests.
cookieEncrypted() public

Sets a encrypted request cookie for future requests.
count() public
countOf() public static
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.
dataDescription() public
dataName() public
delete() public

Performs a DELETE request using the current request data.
deprecated() public

Helper method for check deprecation methods
directoryExists() public static
disableErrorHandlerMiddleware() public

Disable the error handler middleware.
doesNotPerformAssertions() public
doubledTypes() public
enableCsrfToken() public

Calling this method will add a CSRF token to the request.
enableRetainFlashMessages() public

Calling this method will re-store flash messages into the test session after being removed by the FlashHelper
enableSecurityToken() public

Calling this method will enable a SecurityComponent compatible token to be added to request data. This lets you easily test actions protected by SecurityComponent.
equalTo() public static
exactly() public static

Returns a matcher that matches when the method is executed exactly $count times.
expectDeprecation() public
expectDeprecationMessage() public
expectDeprecationMessageMatches() public
expectError() public
expectErrorMessage() public
expectErrorMessageMatches() public
expectException() public
expectExceptionCode() public
expectExceptionMessage() public
expectExceptionMessageMatches() public
expectExceptionMessageRegExp() public deprecated
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
expectNoticeMessage() public
expectNoticeMessageMatches() public
expectOutputRegex() public
expectOutputString() public
expectWarning() public
expectWarningMessage() public
expectWarningMessageMatches() public
extractExceptionMessage() protected

Extract verbose message for existing exception
extractVerboseMessage() protected

Inspect controller to extract possible causes of the failed assertion
fail() public static

Fails a test with the given message.
fileExists() public static
get() public

Performs a GET request using the current request data.
getActualOutput() public
getActualOutputForAssertion() public
getAnnotations() public
getCount() public static

Return the current assertion count.
getDataSetAsString() public
getDependencies() public
getDependencyInput() public
getExpectedException() public
getExpectedExceptionCode() public
getExpectedExceptionMessage() public
getExpectedExceptionMessageRegExp() public
getFixtures() public

Gets fixtures.
getGroups() public
getMockBuilder() public

Returns a builder object to create mock objects using a fluent interface.
getMockClass() protected

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.
getObjectAttribute() public static deprecated

Returns the value of an object's attribute. This also works for attributes that are declared protected or private.
getObjectForTrait() protected

Returns an object for the specified trait.
getProvidedData() public

Gets the data set of a TestCase.
getResult() public
getSession() protected
getSize() public

Returns the size of the test.
getStaticAttribute() public static deprecated

Returns the value of a static attribute. This also works for attributes that are declared protected or private.
getStatus() public
getStatusMessage() public
getTableLocator() public

Gets the table locator.
getTestResultObject() public
greaterThan() public static
greaterThanOrEqual() public static
hasDependencies() public
hasExpectationOnOutput() public
hasFailed() public
hasOutput() public
hasSize() public
head() public

Performs a HEAD request using the current request data.
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

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
markAsRisky() public
markTestIncomplete() public static

Mark the test as incomplete.
markTestSkipped() public static

Mark the test as skipped.
matches() public static
matchesRegularExpression() public static
never() public static

Returns a matcher that matches when the method is never executed.
objectHasAttribute() public static
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.
options() public

Performs an OPTIONS request using the current request data.
patch() public

Performs a PATCH request using the current request data.
post() public

Performs a POST request using the current request data.
prophesize() protected
put() public

Performs a PUT request using the current request data.
readAttribute() public static deprecated

Returns the value of an attribute of a class or an object. This also works for attributes that are declared protected or private.
registerComparator() public
registerMockObject() public
removePlugins() public

Remove plugins from the global plugin collection.
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.
session() public

Sets session data.
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
setUnlockedFields() public

Set list of fields that are excluded from field validation.
setUp() public

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.
setUseErrorHandler() public deprecated
skipIf() public

Overrides SimpleTestCase::skipIf to provide a boolean return value
skipUnless() protected

Compatibility function for skipping.
stringContains() public static
stringEndsWith() public static
stringStartsWith() public static
tearDown() public

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.
throwException() public static
toString() public

Returns a string representation of the test case.
useHttpServer() public

No-op method.
usesDataProvider() public
viewVariable() public

Fetches a view variable by name.
withErrorReporting() public

Helper method for tests that needs to use error_reporting()

Method Detail

__construct() ¶ public

__construct(string $name = null, array $data = [], string $dataName = '')

Parameters

string $name optional
array $data optional
string $dataName optional

_addTokens() ¶ protected

_addTokens(string $url, array $data): array

Add the CSRF and Security Component tokens if necessary.

Parameters

string $url: The URL the form is being submitted on.
array $data: The request body data.

Returns

array

The request body with tokens added.

_assertAttributes() ¶ protected

_assertAttributes(array $assertions, string $string, bool $fullDebug = false, array|string $regex = ''): string|false

Check the attributes as part of an assertTags() check.

Parameters

array $assertions: Assertions to run.
string $string: The HTML string to check.
bool $fullDebug optional: Whether or not more verbose output should be used.
array|string $regex optional: Full regexp from assertHtml

Returns

string|false

_buildRequest() ¶ protected

_buildRequest(string $url, string $method, string|array $data = []): array

Creates a request object with the configured options and parameters.

Parameters

string $url: The URL
string $method: The HTTP method
string|array $data optional: The request data.

Returns

array

The request context

_castToString() ¶ protected

_castToString(array $data): array

Recursively casts all data to string as that is how data would be POSTed in the real world

Parameters

array $data: POST data

Returns

array

_checkCipher() ¶ protected

_checkCipher(string $encrypt): void

Helper method for validating encryption cipher names.

Parameters

string $encrypt: The cipher name.

Returns

void

Throws

RuntimeException
When an invalid cipher is provided.

_decode() ¶ protected

_decode(string $value, string|false $encrypt, string|null $key): string|array

Decodes and decrypts a single value.

Parameters

string $value: The value to decode & decrypt.
string|false $encrypt: The encryption cipher to use.
string|null $key: Used as the security salt if specified.

Returns

string|array

Decoded values.

_decrypt() ¶ protected

_decrypt(string[]|string $values, string|false $mode, string|null $key = null): string|array

Decrypts $value using public $type method in Security class

Parameters

string[]|string $values: Values to decrypt
string|false $mode: Encryption mode
string|null $key optional: Used as the security salt if specified.

Returns

string|array

Decrypted values

_encrypt() ¶ protected

_encrypt(string|array $value, string|false $encrypt, string|null $key = null): string

Encrypts $value using public $type method in Security class

Parameters

string|array $value: Value to encrypt
string|false $encrypt: Encryption mode to use. False disabled encryption.
string|null $key optional: Used as the security salt if specified.

Returns

string

Encoded values

_explode() ¶ protected

_explode(string $string): string|array

Explode method to return array from string set in CookieComponent::_implode() Maintains reading backwards compatibility with 1.x CookieComponent::_implode().

Parameters

string $string: A string containing JSON encoded data, or a bare string.

Returns

string|array

Map of key and values

_getBodyAsString() ¶ protected

_getBodyAsString(): string

Get the response body as string

Returns

string

The response body.

_getCookieEncryptionKey() ¶ protected

_getCookieEncryptionKey(): string

Returns the encryption key to be used.

Returns

string

_getTableClassName() ¶ protected

_getTableClassName(string $alias, array $options): string

Gets the class name for the table.

Parameters

string $alias: The model to get a mock for.
array $options: The config data for the mock's constructor.

Returns

string

Throws

Cake\ORM\Exception\MissingTableClassException

_handleError() ¶ protected

_handleError(Throwable $exception): void

Attempts to render an error response for a given exception.

This method will attempt to use the configured exception renderer. If that class does not exist, the built-in renderer will be used.

Parameters

Throwable $exception: Exception to handle.

Returns

void

_implode() ¶ protected

_implode(array $array): string

Implode method to keep keys are multidimensional arrays

Parameters

array $array: Map of key and values

Returns

string

A json encoded string.

_makeDispatcher() ¶ protected

_makeDispatcher(): Cake\TestSuite\MiddlewareDispatcher

Get the correct dispatcher instance.

Returns

Cake\TestSuite\MiddlewareDispatcher

A dispatcher instance

_normalizePath() ¶ protected

_normalizePath(string $path): string

Normalize a path for comparison.

Parameters

string $path: Path separated by "/" slash.

Returns

string

Normalized path separated by DIRECTORY_SEPARATOR.

_sendRequest() ¶ protected

_sendRequest(string|array $url, string $method, string|array $data = []): void

Creates and send the request into a Dispatcher instance.

Receives and stores the response for future inspection.

Parameters

string|array $url: The URL
string $method: The HTTP method
string|array $data optional: The request data.

Returns

void

Throws

PHPUnit\Exception|Throwable

_url() ¶ protected

_url(string $url): array

Creates a valid request url and parameter array more like Request::_url()

Parameters

string $url: The URL

Returns

array

Qualified URL, the query parameters, and host data

addToAssertionCount() ¶ public

addToAssertionCount(int $count): void

Parameters

int $count

Returns

void

addWarning() ¶ public

addWarning(string $warning): void

Parameters

string $warning

Returns

void

any() ¶ public static

any(): AnyInvokedCountMatcher

Returns a matcher that matches when the method is executed zero or more times.

Returns

AnyInvokedCountMatcher

anything() ¶ public static

anything(): IsAnything

Returns

IsAnything

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

assertArraySubset() ¶ public static

assertArraySubset(array|ArrayAccess $subset, array|ArrayAccess $array, bool $checkForObjectIdentity = false, string $message = ''): void

Asserts that an array has a specified subset.

Parameters

array|ArrayAccess $subset
array|ArrayAccess $array
bool $checkForObjectIdentity optional
string $message optional

Returns

void

Throws

SebastianBergmann\RecursionContext\InvalidArgumentException

Exception

ExpectationFailedException

assertAttributeContains() ¶ public static

assertAttributeContains(mixed $needle, string $haystackAttributeName, object|string $haystackClassOrObject, string $message = '', bool $ignoreCase = false, bool $checkForObjectIdentity = true, bool $checkForNonObjectIdentity = false): void

Asserts that a haystack that is stored in a static attribute of a class or an attribute of an object contains a needle.

Parameters

$needle
string $haystackAttributeName
object|string $haystackClassOrObject
string $message optional
bool $ignoreCase optional
bool $checkForObjectIdentity optional
bool $checkForNonObjectIdentity optional

Returns

void

Throws

SebastianBergmann\RecursionContext\InvalidArgumentException

Exception

ExpectationFailedException

assertAttributeContainsOnly() ¶ public static

assertAttributeContainsOnly(string $type, string $haystackAttributeName, object|string $haystackClassOrObject, ?bool $isNativeType = null, string $message = ''): void

Asserts that a haystack that is stored in a static attribute of a class or an attribute of an object contains only values of a given type.

Parameters

string $type
string $haystackAttributeName
object|string $haystackClassOrObject
?bool $isNativeType optional
string $message optional

Returns

void

Throws

SebastianBergmann\RecursionContext\InvalidArgumentException

Exception

ExpectationFailedException

assertAttributeCount() ¶ public static

assertAttributeCount(int $expectedCount, string $haystackAttributeName, object|string $haystackClassOrObject, string $message = ''): void

Asserts the number of elements of an array, Countable or Traversable that is stored in an attribute.

Parameters

int $expectedCount
string $haystackAttributeName
object|string $haystackClassOrObject
string $message optional

Returns

void

Throws

SebastianBergmann\RecursionContext\InvalidArgumentException

Exception

ExpectationFailedException

assertAttributeEmpty() ¶ public static

assertAttributeEmpty(string $haystackAttributeName, object|string $haystackClassOrObject, string $message = ''): void

Asserts that a static attribute of a class or an attribute of an object is empty.

Parameters

string $haystackAttributeName
object|string $haystackClassOrObject
string $message optional

Returns

void

Throws

SebastianBergmann\RecursionContext\InvalidArgumentException

Exception

ExpectationFailedException

assertAttributeEquals() ¶ public static

assertAttributeEquals(mixed $expected, string $actualAttributeName, object|string $actualClassOrObject, string $message = '', float $delta = 0.0, int $maxDepth = 10, bool $canonicalize = false, bool $ignoreCase = false): void

Asserts that a variable is equal to an attribute of an object.

Parameters

$expected
string $actualAttributeName
object|string $actualClassOrObject
string $message optional
float $delta optional
int $maxDepth optional
bool $canonicalize optional
bool $ignoreCase optional

Returns

void

Throws

SebastianBergmann\RecursionContext\InvalidArgumentException

Exception

ExpectationFailedException

assertAttributeGreaterThan() ¶ public static

assertAttributeGreaterThan(mixed $expected, string $actualAttributeName, object|string $actualClassOrObject, string $message = ''): void

Asserts that an attribute is greater than another value.

Parameters

$expected
string $actualAttributeName
object|string $actualClassOrObject
string $message optional

Returns

void

Throws

SebastianBergmann\RecursionContext\InvalidArgumentException

Exception

ExpectationFailedException

assertAttributeGreaterThanOrEqual() ¶ public static

assertAttributeGreaterThanOrEqual(mixed $expected, string $actualAttributeName, object|string $actualClassOrObject, string $message = ''): void

Asserts that an attribute is greater than or equal to another value.

Parameters

$expected
string $actualAttributeName
object|string $actualClassOrObject
string $message optional

Returns

void

Throws

SebastianBergmann\RecursionContext\InvalidArgumentException

Exception

ExpectationFailedException

assertAttributeInstanceOf() ¶ public static

assertAttributeInstanceOf(string $expected, string $attributeName, object|string $classOrObject, string $message = ''): void

Asserts that an attribute is of a given type.

Parameters

string $expected
string $attributeName
object|string $classOrObject
string $message optional

Returns

void

Throws

SebastianBergmann\RecursionContext\InvalidArgumentException

Exception

ExpectationFailedException

assertAttributeInternalType() ¶ public static

assertAttributeInternalType(string $expected, string $attributeName, object|string $classOrObject, string $message = ''): void

Asserts that an attribute is of a given type.

Parameters

string $expected
string $attributeName
object|string $classOrObject
string $message optional

Returns

void

Throws

SebastianBergmann\RecursionContext\InvalidArgumentException

Exception

ExpectationFailedException

assertAttributeLessThan() ¶ public static

assertAttributeLessThan(mixed $expected, string $actualAttributeName, object|string $actualClassOrObject, string $message = ''): void

Asserts that an attribute is smaller than another value.

Parameters

$expected
string $actualAttributeName
object|string $actualClassOrObject
string $message optional

Returns

void

Throws

SebastianBergmann\RecursionContext\InvalidArgumentException

Exception

ExpectationFailedException

assertAttributeLessThanOrEqual() ¶ public static

assertAttributeLessThanOrEqual(mixed $expected, string $actualAttributeName, object|string $actualClassOrObject, string $message = ''): void

Asserts that an attribute is smaller than or equal to another value.

Parameters

$expected
string $actualAttributeName
object|string $actualClassOrObject
string $message optional

Returns

void

Throws

SebastianBergmann\RecursionContext\InvalidArgumentException

Exception

ExpectationFailedException

assertAttributeNotContains() ¶ public static

assertAttributeNotContains(mixed $needle, string $haystackAttributeName, object|string $haystackClassOrObject, string $message = '', bool $ignoreCase = false, bool $checkForObjectIdentity = true, bool $checkForNonObjectIdentity = false): void

Asserts that a haystack that is stored in a static attribute of a class or an attribute of an object does not contain a needle.

Parameters

$needle
string $haystackAttributeName
object|string $haystackClassOrObject
string $message optional
bool $ignoreCase optional
bool $checkForObjectIdentity optional
bool $checkForNonObjectIdentity optional

Returns

void

Throws

SebastianBergmann\RecursionContext\InvalidArgumentException

Exception

ExpectationFailedException

assertAttributeNotContainsOnly() ¶ public static

assertAttributeNotContainsOnly(string $type, string $haystackAttributeName, object|string $haystackClassOrObject, ?bool $isNativeType = null, string $message = ''): void

Asserts that a haystack that is stored in a static attribute of a class or an attribute of an object does not contain only values of a given type.

Parameters

string $type
string $haystackAttributeName
object|string $haystackClassOrObject
?bool $isNativeType optional
string $message optional

Returns

void

Throws

SebastianBergmann\RecursionContext\InvalidArgumentException

Exception

ExpectationFailedException

assertAttributeNotCount() ¶ public static

assertAttributeNotCount(int $expectedCount, string $haystackAttributeName, object|string $haystackClassOrObject, string $message = ''): void

Asserts the number of elements of an array, Countable or Traversable that is stored in an attribute.

Parameters

int $expectedCount
string $haystackAttributeName
object|string $haystackClassOrObject
string $message optional

Returns

void

Throws

SebastianBergmann\RecursionContext\InvalidArgumentException

Exception

ExpectationFailedException

assertAttributeNotEmpty() ¶ public static

assertAttributeNotEmpty(string $haystackAttributeName, object|string $haystackClassOrObject, string $message = ''): void

Asserts that a static attribute of a class or an attribute of an object is not empty.

Parameters

string $haystackAttributeName
object|string $haystackClassOrObject
string $message optional

Returns

void

Throws

SebastianBergmann\RecursionContext\InvalidArgumentException

Exception

ExpectationFailedException

assertAttributeNotEquals() ¶ public static

assertAttributeNotEquals(mixed $expected, string $actualAttributeName, object|string $actualClassOrObject, string $message = '', float $delta = 0.0, int $maxDepth = 10, bool $canonicalize = false, bool $ignoreCase = false): void

Asserts that a variable is not equal to an attribute of an object.

Parameters

$expected
string $actualAttributeName
object|string $actualClassOrObject
string $message optional
float $delta optional
int $maxDepth optional
bool $canonicalize optional
bool $ignoreCase optional

Returns

void

Throws

SebastianBergmann\RecursionContext\InvalidArgumentException

Exception

ExpectationFailedException

assertAttributeNotInstanceOf() ¶ public static

assertAttributeNotInstanceOf(string $expected, string $attributeName, object|string $classOrObject, string $message = ''): void

Asserts that an attribute is of a given type.

Parameters

string $expected
string $attributeName
object|string $classOrObject
string $message optional

Returns

void

Throws

SebastianBergmann\RecursionContext\InvalidArgumentException

Exception

ExpectationFailedException

assertAttributeNotInternalType() ¶ public static

assertAttributeNotInternalType(string $expected, string $attributeName, object|string $classOrObject, string $message = ''): void

Asserts that an attribute is of a given type.

Parameters

string $expected
string $attributeName
object|string $classOrObject
string $message optional

Returns

void

Throws

SebastianBergmann\RecursionContext\InvalidArgumentException

Exception

ExpectationFailedException

assertAttributeNotSame() ¶ public static

assertAttributeNotSame(mixed $expected, string $actualAttributeName, object|string $actualClassOrObject, string $message = ''): void

Asserts that a variable and an attribute of an object do not have the same type and value.

Parameters

$expected
string $actualAttributeName
object|string $actualClassOrObject
string $message optional

Returns

void

Throws

SebastianBergmann\RecursionContext\InvalidArgumentException

Exception

ExpectationFailedException

assertAttributeSame() ¶ public static

assertAttributeSame(mixed $expected, string $actualAttributeName, object|string $actualClassOrObject, string $message = ''): void

Asserts that a variable and an attribute of an object have the same type and value.

Parameters

$expected
string $actualAttributeName
object|string $actualClassOrObject
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, mixed $haystack, string $message = '', bool $ignoreCase = false, bool $checkForObjectIdentity = true, bool $checkForNonObjectIdentity = false): void

Asserts that a haystack contains a needle.

Parameters

$needle
$haystack
string $message optional
bool $ignoreCase optional
bool $checkForObjectIdentity optional
bool $checkForNonObjectIdentity 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

assertContentType() ¶ public

assertContentType(string $type, string $message = ''): void

Asserts content type

Parameters

string $type: The content-type to check for.
string $message optional: The failure message that will be appended to the generated message.

Returns

void

assertCookie() ¶ public

assertCookie(mixed $expected, string $name, string $message = ''): void

Asserts cookie values

Parameters

mixed $expected: The expected contents.
string $name: The cookie name.
string $message optional: The failure message that will be appended to the generated message.

Returns

void

assertCookieEncrypted() ¶ public

assertCookieEncrypted(mixed $expected, string $name, string $encrypt = 'aes', string|null $key = null, string $message = ''): void

Asserts cookie values which are encrypted by the CookieComponent.

The difference from assertCookie() is this decrypts the cookie value like the CookieComponent for this assertion.

Parameters

mixed $expected: The expected contents.
string $name: The cookie name.
string $encrypt optional: Encryption mode to use.
string|null $key optional: Encryption key used. Defaults to Security.salt.
string $message optional: The failure message that will be appended to the generated message.

Returns

void

assertCookieNotSet() ¶ public

assertCookieNotSet(string $cookie, string $message = ''): void

Asserts a cookie has not been set in the response

Parameters

string $cookie: The cookie name to check
string $message optional: The failure message that will be appended to the generated message.

Returns

void

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

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

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

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 = '', float $delta = 0.0, int $maxDepth = 10, bool $canonicalize = false, bool $ignoreCase = false): void

Asserts that two variables are equal.

Parameters

$expected
$actual
string $message optional
float $delta optional
int $maxDepth optional
bool $canonicalize optional
bool $ignoreCase 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

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

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

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

assertFileEquals() ¶ public static

assertFileEquals(string $expected, string $actual, string $message = '', bool $canonicalize = false, bool $ignoreCase = false): void

Asserts that the contents of one file is equal to the contents of another file.

Parameters

string $expected
string $actual
string $message optional
bool $canonicalize optional
bool $ignoreCase 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

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 = '', bool $canonicalize = false, bool $ignoreCase = false): 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
bool $canonicalize optional
bool $ignoreCase 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

assertFileResponse() ¶ public

assertFileResponse(string $expected, string $message = ''): void

Asserts that a file with the given name was sent in the response

Parameters

string $expected: The absolute file path that should be sent in the response.
string $message optional: The failure message that will be appended to the generated message.

Returns

void

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

assertFlashElement() ¶ public

assertFlashElement(string $expected, string $key = 'flash', string $message = ''): void

Asserts a flash element was set

Parameters

string $expected: Expected element name
string $key optional: Flash key
string $message optional: Assertion failure message

Returns

void

assertFlashElementAt() ¶ public

assertFlashElementAt(int $at, string $expected, string $key = 'flash', string $message = ''): void

Asserts a flash element was set at a certain index

Parameters

int $at: Flash index
string $expected: Expected element name
string $key optional: Flash key
string $message optional: Assertion failure message

Returns

void

assertFlashMessage() ¶ public

assertFlashMessage(string $expected, string $key = 'flash', string $message = ''): void

Asserts a flash message was set

Parameters

string $expected: Expected message
string $key optional: Flash key
string $message optional: Assertion failure message

Returns

void

assertFlashMessageAt() ¶ public

assertFlashMessageAt(int $at, string $expected, string $key = 'flash', string $message = ''): void

Asserts a flash message was set at a certain index

Parameters

int $at: Flash index
string $expected: Expected message
string $key optional: Flash key
string $message optional: Assertion failure message

Returns

void

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

assertHeader() ¶ public

assertHeader(string $header, string $content, string $message = ''): void

Asserts response headers

Parameters

string $header: The header to check
string $content: The content to check for.
string $message optional: The failure message that will be appended to the generated message.

Returns

void

assertHeaderContains() ¶ public

assertHeaderContains(string $header, string $content, string $message = ''): void

Asserts response header contains a string

Parameters

string $header: The header to check
string $content: The content to check for.
string $message optional: The failure message that will be appended to the generated message.

Returns

void

assertHeaderNotContains() ¶ public

assertHeaderNotContains(string $header, string $content, string $message = ''): void

Asserts response header does not contain a string

Parameters

string $header: The header to check
string $content: The content to check for.
string $message optional: The failure message that will be appended to the generated message.

Returns

void

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 or not 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

assertInternalType() ¶ public static

assertInternalType(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

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

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

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

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

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

assertLayout() ¶ public

assertLayout(string $content, string $message = ''): void

Asserts that the search string was in the layout name.

Parameters

string $content: The content to check for.
string $message optional: The failure message that will be appended to the generated message.

Returns

void

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

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

assertNoRedirect() ¶ public

assertNoRedirect(string $message = ''): void

Asserts that the Location header is not set.

Parameters

string $message optional: The failure message that will be appended to the generated message.

Returns

void

assertNotContains() ¶ public static

assertNotContains(mixed $needle, mixed $haystack, string $message = '', bool $ignoreCase = false, bool $checkForObjectIdentity = true, bool $checkForNonObjectIdentity = false): void

Asserts that a haystack does not contain a needle.

Parameters

$needle
$haystack
string $message optional
bool $ignoreCase optional
bool $checkForObjectIdentity optional
bool $checkForNonObjectIdentity 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 = '', float $delta = 0.0, int $maxDepth = 10, bool $canonicalize = false, bool $ignoreCase = false): void

Asserts that two variables are not equal.

Parameters

$expected
$actual
string $message optional
float $delta optional
int $maxDepth optional
bool $canonicalize optional
bool $ignoreCase 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

assertNotInternalType() ¶ public static

assertNotInternalType(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

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

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

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

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

assertRedirect() ¶ public

assertRedirect(string|array|null $url = null, string $message = ''): void

Asserts that the Location header is correct. Comparison is made against a full URL.

Parameters

string|array|null $url optional: The URL you expected the client to go to. This can either be a string URL or an array compatible with Router::url(). Use null to simply check for the existence of this header.
string $message optional: The failure message that will be appended to the generated message.

Returns

void

assertRedirectContains() ¶ public

assertRedirectContains(string $url, string $message = ''): void

Asserts that the Location header contains a substring

Parameters

string $url: The URL you expected the client to go to.
string $message optional: The failure message that will be appended to the generated message.

Returns

void

assertRedirectEquals() ¶ public

assertRedirectEquals(string|array|null $url = null, string $message = ''): void

Asserts that the Location header is correct. Comparison is made against exactly the URL provided.

Parameters

string|array|null $url optional: The URL you expected the client to go to. This can either be a string URL or an array compatible with Router::url(). Use null to simply check for the existence of this header.
string $message optional: The failure message that will be appended to the generated message.

Returns

void

assertRedirectNotContains() ¶ public

assertRedirectNotContains(string $url, string $message = ''): void

Asserts that the Location header does not contain a substring

Parameters

string $url: The URL you expected the client to go to.
string $message optional: The failure message that will be appended to the generated message.

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

assertResponseCode() ¶ public

assertResponseCode(int $code, string $message = ''): void

Asserts a specific response status code.

Parameters

int $code: Status code to assert.
string $message optional: Custom message for failure.

Returns

void

assertResponseContains() ¶ public

assertResponseContains(string $content, string $message = '', bool $ignoreCase = false): void

Asserts content exists in the response body.

Parameters

string $content: The content to check for.
string $message optional: The failure message that will be appended to the generated message.
bool $ignoreCase optional: A flag to check whether we should ignore case or not.

Returns

void

assertResponseEmpty() ¶ public

assertResponseEmpty(string $message = ''): void

Assert response content is empty.

Parameters

string $message optional: The failure message that will be appended to the generated message.

Returns

void

assertResponseEquals() ¶ public

assertResponseEquals(mixed $content, string $message = ''): void

Asserts content in the response body equals.

Parameters

mixed $content: The content to check for.
string $message optional: The failure message that will be appended to the generated message.

Returns

void

assertResponseError() ¶ public

assertResponseError(string $message = ''): void

Asserts that the response status code is in the 4xx range.

Parameters

string $message optional: Custom message for failure.

Returns

void

assertResponseFailure() ¶ public

assertResponseFailure(string $message = ''): void

Asserts that the response status code is in the 5xx range.

Parameters

string $message optional: Custom message for failure.

Returns

void

assertResponseNotContains() ¶ public

assertResponseNotContains(string $content, string $message = '', bool $ignoreCase = false): void

Asserts content does not exist in the response body.

Parameters

string $content: The content to check for.
string $message optional: The failure message that will be appended to the generated message.
bool $ignoreCase optional: A flag to check whether we should ignore case or not.

Returns

void

assertResponseNotEmpty() ¶ public

assertResponseNotEmpty(string $message = ''): void

Assert response content is not empty.

Parameters

string $message optional: The failure message that will be appended to the generated message.

Returns

void

assertResponseNotEquals() ¶ public

assertResponseNotEquals(mixed $content, string $message = ''): void

Asserts content in the response body not equals.

Parameters

mixed $content: The content to check for.
string $message optional: The failure message that will be appended to the generated message.

Returns

void

assertResponseNotRegExp() ¶ public

assertResponseNotRegExp(string $pattern, string $message = ''): void

Asserts that the response body does not match a given regular expression.

Parameters

string $pattern: The pattern to compare against.
string $message optional: The failure message that will be appended to the generated message.

Returns

void

assertResponseOk() ¶ public

assertResponseOk(string $message = ''): void

Asserts that the response status code is in the 2xx range.

Parameters

string $message optional: Custom message for failure.

Returns

void

assertResponseRegExp() ¶ public

assertResponseRegExp(string $pattern, string $message = ''): void

Asserts that the response body matches a given regular expression.

Parameters

string $pattern: The pattern to compare against.
string $message optional: The failure message that will be appended to the generated message.

Returns

void

assertResponseSuccess() ¶ public

assertResponseSuccess(string $message = ''): void

Asserts that the response status code is in the 2xx/3xx range.

Parameters

string $message optional: Custom message for failure.

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

assertSession() ¶ public

assertSession(mixed $expected, string $path, string $message = ''): void

Asserts session contents

Parameters

mixed $expected: The expected contents.
string $path: The session data path. Uses Hash::get() compatible notation
string $message optional: The failure message that will be appended to the generated message.

Returns

void

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 = '', bool $canonicalize = false, bool $ignoreCase = false): void

Asserts that the contents of a string is equal to the contents of a file.

Parameters

string $expectedFile
string $actualString
string $message optional
bool $canonicalize optional
bool $ignoreCase 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 = '', bool $canonicalize = false, bool $ignoreCase = false): 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
bool $canonicalize optional
bool $ignoreCase 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

assertTemplate() ¶ public

assertTemplate(string $content, string $message = ''): void

Asserts that the search string was in the template name.

Parameters

string $content: The content to check for.
string $message optional: The failure message that will be appended to the generated message.

Returns

void

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 or not 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 or not 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

SebastianBergmann\RecursionContext\InvalidArgumentException

Exception

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

Exception

ExpectationFailedException

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

Exception

ExpectationFailedException

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

Exception

ExpectationFailedException

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

Exception

ExpectationFailedException

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

attribute() ¶ public static

attribute(Constraint $constraint, string $attributeName): Attribute

Parameters

Constraint $constraint
string $attributeName

Returns

Attribute

attributeEqualTo() ¶ public static

attributeEqualTo(string $attributeName, mixed $value, float $delta = 0.0, int $maxDepth = 10, bool $canonicalize = false, bool $ignoreCase = false): Attribute

Parameters

string $attributeName
$value
float $delta optional
int $maxDepth optional
bool $canonicalize optional
bool $ignoreCase optional

Returns

Attribute

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

cleanup() ¶ public

cleanup(): void

Clears the state used for requests.

Returns

void

clearPlugins() ¶ public

clearPlugins(): void

Clear all plugins from the global plugin collection.

Useful in test case teardown methods.

Returns

void

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

configRequest() ¶ public

configRequest(array $data): void

Configures the data for the next request.

This data is cleared in the tearDown() method.

You can call this method multiple times to append into the current state.

Parameters

array $data: The request data to use.

Returns

void

contains() ¶ public static

contains(mixed $value, bool $checkForObjectIdentity = true, bool $checkForNonObjectIdentity = false): TraversableContains

Parameters

$value
bool $checkForObjectIdentity optional
bool $checkForNonObjectIdentity optional

Returns

TraversableContains

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

controllerSpy() ¶ public

controllerSpy(Cake\Event\EventInterface $event, Cake\Controller\Controller|null $controller = null): void

Adds additional event spies to the controller/view event manager.

Parameters

Cake\Event\EventInterface $event: A dispatcher event.
Cake\Controller\Controller|null $controller optional: Controller instance.

Returns

void

cookie() ¶ public

cookie(string $name, mixed $value): void

Sets a request cookie for future requests.

This method lets you configure the session data you want to be used for requests that follow. The session state is reset in each tearDown().

You can call this method multiple times to append into the current state.

Parameters

string $name: The cookie name to use.
mixed $value: The value of the cookie.

Returns

void

cookieEncrypted() ¶ public

cookieEncrypted(string $name, mixed $value, string|false $encrypt = 'aes', string|null $key = null): void

Sets a encrypted request cookie for future requests.

The difference from cookie() is this encrypts the cookie value like the CookieComponent.

Parameters

string $name: The cookie name to use.
mixed $value: The value of the cookie.
string|false $encrypt optional: Encryption mode to use.
string|null $key optional: Encryption key used. Defaults to Security.salt.

Returns

void

count() ¶ public

count(): int

Returns

int

countOf() ¶ public static

countOf(int $count): Count

Parameters

int $count

Returns

Count

createConfiguredMock() ¶ protected

createConfiguredMock(string|string[] $originalClassName, array $configuration): MockObject

Returns a configured mock object for the specified class.

Parameters

string|string[] $originalClassName
array $configuration

Returns

MockObject

createMock() ¶ protected

createMock(string|string[] $originalClassName): MockObject

Returns a mock object for the specified class.

Parameters

string|string[] $originalClassName

Returns

MockObject

createPartialMock() ¶ protected

createPartialMock(string|string[] $originalClassName, string[] $methods): MockObject

Returns a partial mock object for the specified class.

Parameters

string|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

dataDescription() ¶ public

dataDescription(): string

Returns

string

dataName() ¶ public

dataName(): int|string

Returns

int|string

delete() ¶ public

delete(string|array $url): void

Performs a DELETE request using the current request data.

The response of the dispatched request will be stored as a property. You can use various assert methods to check the response.

Parameters

string|array $url: The URL to request.

Returns

void

deprecated() ¶ public

deprecated(callable $callable): void

Helper method for check deprecation methods

Parameters

callable $callable: callable function that will receive asserts

Returns

void

directoryExists() ¶ public static

directoryExists(): DirectoryExists

Returns

DirectoryExists

disableErrorHandlerMiddleware() ¶ public

disableErrorHandlerMiddleware(): void

Disable the error handler middleware.

By using this function, exceptions are no longer caught by the ErrorHandlerMiddleware and are instead re-thrown by the TestExceptionRenderer. This can be helpful when trying to diagnose/debug unexpected failures in test cases.

Returns

void

doesNotPerformAssertions() ¶ public

doesNotPerformAssertions(): bool

Returns

bool

doubledTypes() ¶ public

doubledTypes(): string[]

Returns

string[]

enableCsrfToken() ¶ public

enableCsrfToken(): void

Calling this method will add a CSRF token to the request.

Both the POST data and cookie will be populated when this option is enabled. The default parameter names will be used.

Returns

void

enableRetainFlashMessages() ¶ public

enableRetainFlashMessages(): void

Calling this method will re-store flash messages into the test session after being removed by the FlashHelper

Returns

void

enableSecurityToken() ¶ public

enableSecurityToken(): void

Calling this method will enable a SecurityComponent compatible token to be added to request data. This lets you easily test actions protected by SecurityComponent.

Returns

void

equalTo() ¶ public static

equalTo(mixed $value, float $delta = 0.0, int $maxDepth = 10, bool $canonicalize = false, bool $ignoreCase = false): IsEqual

Parameters

$value
float $delta optional
int $maxDepth optional
bool $canonicalize optional
bool $ignoreCase optional

Returns

IsEqual

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

expectDeprecation() ¶ public

expectDeprecation(): void

Returns

void

expectDeprecationMessage() ¶ public

expectDeprecationMessage(string $message): void

Parameters

string $message

Returns

void

expectDeprecationMessageMatches() ¶ public

expectDeprecationMessageMatches(string $regularExpression): void

Parameters

string $regularExpression

Returns

void

expectError() ¶ public

expectError(): void

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

expectExceptionMessageRegExp() ¶ public

expectExceptionMessageRegExp(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

expectNotToPerformAssertions() ¶ public

expectNotToPerformAssertions(): void

Returns

void

expectNotice() ¶ public

expectNotice(): void

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

expectWarning() ¶ public

expectWarning(): void

Returns

void

expectWarningMessage() ¶ public

expectWarningMessage(string $message): void

Parameters

string $message

Returns

void

expectWarningMessageMatches() ¶ public

expectWarningMessageMatches(string $regularExpression): void

Parameters

string $regularExpression

Returns

void

extractExceptionMessage() ¶ protected

extractExceptionMessage(Exception $exception): string

Extract verbose message for existing exception

Parameters

Exception $exception: Exception to extract

Returns

string

extractVerboseMessage() ¶ protected

extractVerboseMessage(string $message): string

Inspect controller to extract possible causes of the failed assertion

Parameters

string $message: Original message to use as a base

Returns

string

fail() ¶ public static

fail(string $message = ''): void

Fails a test with the given message.

Parameters

string $message optional

Returns

void

Throws

AssertionFailedError

fileExists() ¶ public static

fileExists(): FileExists

Returns

FileExists

get() ¶ public

get(string|array $url): void

Performs a GET request using the current request data.

The response of the dispatched request will be stored as a property. You can use various assert methods to check the response.

Parameters

string|array $url: The URL to request.

Returns

void

getActualOutput() ¶ public

getActualOutput(): string

Returns

string

getActualOutputForAssertion() ¶ public

getActualOutputForAssertion(): string

Returns

string

getAnnotations() ¶ public

getAnnotations(): array

Returns

array

getCount() ¶ public static

getCount(): int

Return the current assertion count.

Returns

int

getDataSetAsString() ¶ public

getDataSetAsString(bool $includeData = true): string

Parameters

bool $includeData optional

Returns

string

getDependencies() ¶ public

getDependencies(): array

Returns

array

getDependencyInput() ¶ public

getDependencyInput(): array

Returns

array

getExpectedException() ¶ public

getExpectedException(): ?string

Returns

?string

getExpectedExceptionCode() ¶ public

getExpectedExceptionCode(): null|int|string

Returns

null|int|string

getExpectedExceptionMessage() ¶ public

getExpectedExceptionMessage(): ?string

Returns

?string

getExpectedExceptionMessageRegExp() ¶ public

getExpectedExceptionMessageRegExp(): ?string

Returns

?string

getFixtures() ¶ public

getFixtures(): string[]

Gets fixtures.

Returns

string[]

getGroups() ¶ public

getGroups(): array

Returns

array

getMockBuilder() ¶ public

getMockBuilder(string|string[] $className): MockBuilder

Returns a builder object to create mock objects using a fluent interface.

Parameters

string|string[] $className

Returns

MockBuilder

getMockClass() ¶ protected

getMockClass(string $originalClassName, 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
array $methods optional
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, string[] $methods = [], array $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.
string[] $methods optional: The list of methods to mock
array $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: An array of options passed to SOAPClient::_construct

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

getObjectAttribute() ¶ public static

getObjectAttribute(object $object, string $attributeName)

Returns the value of an object's attribute. This also works for attributes that are declared protected or private.

Parameters

object $object
string $attributeName

Throws

Exception

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

getProvidedData() ¶ public

getProvidedData(): array

Gets the data set of a TestCase.

Returns

array

getResult() ¶ public

getResult()

getSession() ¶ protected

getSession(): Cake\TestSuite\TestSession

Returns

Cake\TestSuite\TestSession

getSize() ¶ public

getSize(): int

Returns the size of the test.

Returns

int

Throws

InvalidArgumentException

getStaticAttribute() ¶ public static

getStaticAttribute(string $className, string $attributeName)

Returns the value of a static attribute. This also works for attributes that are declared protected or private.

Parameters

string $className
string $attributeName

Throws

Exception

getStatus() ¶ public

getStatus(): int

Returns

int

getStatusMessage() ¶ public

getStatusMessage(): string

Returns

string

getTableLocator() ¶ public

getTableLocator(): Cake\ORM\Locator\LocatorInterface

Gets the table locator.

Returns

Cake\ORM\Locator\LocatorInterface

getTestResultObject() ¶ public

getTestResultObject(): ?TestResult

Returns

?TestResult

greaterThan() ¶ public static

greaterThan(mixed $value): GreaterThan

Parameters

$value

Returns

GreaterThan

greaterThanOrEqual() ¶ public static

greaterThanOrEqual(mixed $value): LogicalOr

Parameters

$value

Returns

LogicalOr

hasDependencies() ¶ public

hasDependencies(): bool

Returns

bool

hasExpectationOnOutput() ¶ public

hasExpectationOnOutput(): bool

Returns

bool

hasFailed() ¶ public

hasFailed(): bool

Returns

bool

hasOutput() ¶ public

hasOutput(): bool

Returns

bool

hasSize() ¶ public

hasSize(): bool

Returns

bool

Throws

InvalidArgumentException

head() ¶ public

head(string|array $url): void

Performs a HEAD request using the current request data.

The response of the dispatched request will be stored as a property. You can use various assert methods to check the response.

Parameters

string|array $url: The URL to request.

Returns

void

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

isEmpty() ¶ public static

isEmpty(): IsEmpty

Returns

IsEmpty

isFalse() ¶ public static

isFalse(): IsFalse

Returns

IsFalse

isFinite() ¶ public static

isFinite(): IsFinite

Returns

IsFinite

isInIsolation() ¶ public

isInIsolation(): bool

Returns

bool

isInfinite() ¶ public static

isInfinite(): IsInfinite

Returns

IsInfinite

isInstanceOf() ¶ public static

isInstanceOf(string $className): IsInstanceOf

Parameters

string $className

Returns

IsInstanceOf

isJson() ¶ public static

isJson(): IsJson

Returns

IsJson

isLarge() ¶ public

isLarge(): bool

Returns

bool

Throws

InvalidArgumentException

isMedium() ¶ public

isMedium(): bool

Returns

bool

Throws

InvalidArgumentException

isNan() ¶ public static

isNan(): IsNan

Returns

IsNan

isNull() ¶ public static

isNull(): IsNull

Returns

IsNull

isReadable() ¶ public static

isReadable(): IsReadable

Returns

IsReadable

isSmall() ¶ public

isSmall(): bool

Returns

bool

Throws

InvalidArgumentException

isTrue() ¶ public static

isTrue(): IsTrue

Returns

IsTrue

isType() ¶ public static

isType(string $type): IsType

Parameters

string $type

Returns

IsType

isWritable() ¶ public static

isWritable(): IsWritable

Returns

IsWritable

lessThan() ¶ public static

lessThan(mixed $value): LessThan

Parameters

$value

Returns

LessThan

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.

loadPlugins() ¶ public

loadPlugins(array $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 $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: Constuctor parameters for the application class.

Returns

void

logicalAnd() ¶ public static

logicalAnd(): LogicalAnd

Returns

LogicalAnd

Throws

Exception

logicalNot() ¶ public static

logicalNot(Constraint $constraint): LogicalNot

Parameters

Constraint $constraint

Returns

LogicalNot

logicalOr() ¶ public static

logicalOr(): LogicalOr

Returns

LogicalOr

logicalXor() ¶ public static

logicalXor(): LogicalXor

Returns

LogicalXor

markAsRisky() ¶ public

markAsRisky(): void

Returns

void

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

never() ¶ public static

never(): InvokedCountMatcher

Returns a matcher that matches when the method is never executed.

Returns

InvokedCountMatcher

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

options() ¶ public

options(string|array $url): void

Performs an OPTIONS request using the current request data.

The response of the dispatched request will be stored as a property. You can use various assert methods to check the response.

Parameters

string|array $url: The URL to request.

Returns

void

patch() ¶ public

patch(string|array $url, string|array $data = []): void

Performs a PATCH request using the current request data.

The response of the dispatched request will be stored as a property. You can use various assert methods to check the response.

Parameters

string|array $url: The URL to request.
string|array $data optional: The data for the request.

Returns

void

post() ¶ public

post(string|array $url, string|array $data = []): void

Performs a POST request using the current request data.

The response of the dispatched request will be stored as a property. You can use various assert methods to check the response.

Parameters

string|array $url: The URL to request.
string|array $data optional: The data for the request.

Returns

void

prophesize() ¶ protected

prophesize(?string $classOrInterface = null): ObjectProphecy

Parameters

?string $classOrInterface optional

Returns

ObjectProphecy

Throws

ClassNotFoundException

DoubleException

InterfaceNotFoundException

put() ¶ public

put(string|array $url, string|array $data = []): void

Performs a PUT request using the current request data.

The response of the dispatched request will be stored as a property. You can use various assert methods to check the response.

Parameters

string|array $url: The URL to request.
string|array $data optional: The data for the request.

Returns

void

readAttribute() ¶ public static

readAttribute(object|string $classOrObject, string $attributeName)

Returns the value of an attribute of a class or an object. This also works for attributes that are declared protected or private.

Parameters

object|string $classOrObject
string $attributeName

Throws

Exception

registerComparator() ¶ public

registerComparator(Comparator $comparator): void

Parameters

Comparator $comparator

Returns

void

registerMockObject() ¶ public

registerMockObject(MockObject $mockObject): void

Parameters

MockObject $mockObject

Returns

void

removePlugins() ¶ public

removePlugins(string[] $names = []): void

Remove plugins from the global plugin collection.

Useful in test case teardown methods.

Parameters

string[] $names optional: A list of plugins you want to remove.

Returns

void

resetCount() ¶ public static

resetCount(): void

Reset the assertion counter.

Returns

void

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

CoveredCodeNotExecutedException

InvalidArgumentException

MissingCoversAnnotationException

RuntimeException

UnintentionallyCoveredCodeException

UtilException

runBare() ¶ public

runBare(): void

Returns

void

Throws

Throwable

runTest() ¶ protected

runTest()

Override to run the test and assert its state.

Throws

SebastianBergmann\ObjectEnumerator\InvalidArgumentException

AssertionFailedError

Exception

ExpectationFailedException

Throwable

session() ¶ public

session(array $data): void

Sets session data.

This method lets you configure the session data you want to be used for requests that follow. The session state is reset in each tearDown().

You can call this method multiple times to append into the current state.

Parameters

array $data: The session data to use.

Returns

void

setAppNamespace() ¶ public static

setAppNamespace(string $appNamespace = 'TestApp'): void

Set the app namespace

Parameters

string $appNamespace optional: The app namespace, defaults to "TestApp".

Returns

void

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(string[] $dependencies): void

Parameters

string[] $dependencies

Returns

void

setDependencyInput() ¶ public

setDependencyInput(array $dependencyInput): void

Parameters

array $dependencyInput

Returns

void

setGroups() ¶ public

setGroups(array $groups): void

Parameters

array $groups

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

setName() ¶ public

setName(string $name): void

Parameters

string $name

Returns

void

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

setResult() ¶ public

setResult(mixed $result): void

Parameters

$result

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

setUnlockedFields() ¶ public

setUnlockedFields(string[] $unlockedFields = []): void

Set list of fields that are excluded from field validation.

Parameters

string[] $unlockedFields optional: List of fields that are excluded from field validation.

Returns

void

setUp() ¶ public

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

setUseErrorHandler() ¶ public

setUseErrorHandler(bool $useErrorHandler): void

Parameters

bool $useErrorHandler

Returns

void

skipIf() ¶ public

skipIf(bool $shouldSkip, string $message = ''): bool

Overrides SimpleTestCase::skipIf to provide a boolean return value

Parameters

bool $shouldSkip: Whether or not 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() ¶ public

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

useHttpServer() ¶ public

useHttpServer(bool $enable): void

No-op method.

Parameters

bool $enable: Unused.

Returns

void

usesDataProvider() ¶ public

usesDataProvider(): bool

Returns

bool

viewVariable() ¶ public

viewVariable(string $name): mixed

Fetches a view variable by name.

If the view variable does not exist, null will be returned.

Parameters

string $name: The view variable to get.

Returns

mixed

The view variable if set.

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

`$_appArgs` ¶ protected

The customized application constructor arguments.

Type

array|null

`$_appClass` ¶ protected

The customized application class name.

Type

string|null

`$_configure` ¶ protected

Configure values to restore at end of test.

Type

array

`$_controller` ¶ protected

The controller used in the last request.

Type

Cake\Controller\Controller

`$_cookie` ¶ protected

Cookie data to use in the next request.

Type

array

`$_cookieEncryptionKey` ¶ protected

Type

string|null

`$_csrfToken` ¶ protected

Boolean flag for whether or not the request should have a CSRF token added.

Type

bool

`$_exception` ¶ protected

The exception being thrown if the case.

Type

Throwable|null

`$_flashMessages` ¶ protected

Stored flash messages before render

Type

array|null

`$_layoutName` ¶ protected

The last rendered layout

Type

string

`$_request` ¶ protected

The data used to build the next request.

Type

array

`$_requestSession` ¶ protected

The session instance from the last request

Type

Cake\Http\Session

`$_response` ¶ protected

The response for the most recent request.

Type

Psr\Http\Message\ResponseInterface

`$_retainFlashMessages` ¶ protected

Boolean flag for whether or not the request should re-store flash messages

Type

bool

`$_securityToken` ¶ protected

Boolean flag for whether or not the request should have a SecurityComponent token added.

Type

bool

`$_session` ¶ protected

Session data to use in the next request.

Type

array

`$_tableLocator` ¶ protected

Table locator instance

Type

Cake\ORM\Locator\LocatorInterface|null

`$_unlockedFields` ¶ protected

List of fields that are excluded from field validation.

Type

string[]

`$_validCiphers` ¶ protected

Valid cipher names for encrypted cookies.

Type

string[]

`$_viewName` ¶ protected

The last rendered view

Type

string

`$autoFixtures` ¶ public

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

`$backupGlobals` ¶ protected

Type

?bool

`$backupGlobalsBlacklist` ¶ protected

Type

string[]

`$backupStaticAttributes` ¶ protected

Type

?bool

`$backupStaticAttributesBlacklist` ¶ protected

Type

array<string, array<int, string>>

`$dropTables` ¶ public

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

The class responsible for managing the creation, loading and removing of fixtures

Type

Cake\TestSuite\Fixture\FixtureManager|null

`$fixtures` ¶ protected

Fixtures used by this test case.

Type

string[]

`$preserveGlobalState` ¶ protected

Type

bool

`$runTestInSeparateProcess` ¶ protected

Type

?bool

Namespaces

Class IntegrationTestCase

Property Summary

Method Summary

__construct() public

_addTokens() protected

_assertAttributes() protected

_buildRequest() protected

_castToString() protected

_checkCipher() protected

_decode() protected

_decrypt() protected

_encrypt() protected

_explode() protected

_getBodyAsString() protected

_getCookieEncryptionKey() protected

_getTableClassName() protected

_handleError() protected

_implode() protected

_makeDispatcher() protected

_normalizePath() protected

_sendRequest() protected

_url() protected

addToAssertionCount() public

addWarning() public

any() public static

anything() public static

arrayHasKey() public static

assertArrayHasKey() public static

assertArrayNotHasKey() public static

assertArraySubset() public static deprecated

assertAttributeContains() public static deprecated

assertAttributeContainsOnly() public static deprecated

assertAttributeCount() public static deprecated

assertAttributeEmpty() public static deprecated

assertAttributeEquals() public static deprecated

assertAttributeGreaterThan() public static deprecated

assertAttributeGreaterThanOrEqual() public static deprecated

assertAttributeInstanceOf() public static deprecated

assertAttributeInternalType() public static deprecated

assertAttributeLessThan() public static deprecated

assertAttributeLessThanOrEqual() public static deprecated

assertAttributeNotContains() public static deprecated

assertAttributeNotContainsOnly() public static deprecated

assertAttributeNotCount() public static deprecated

assertAttributeNotEmpty() public static deprecated

assertAttributeNotEquals() public static deprecated

assertAttributeNotInstanceOf() public static deprecated

assertAttributeNotInternalType() public static deprecated

assertAttributeNotSame() public static deprecated

assertAttributeSame() public static deprecated

assertClassHasAttribute() public static

assertClassHasStaticAttribute() public static

assertClassNotHasAttribute() public static

assertClassNotHasStaticAttribute() public static

assertContains() public static

assertContainsEquals() public static

assertContainsOnly() public static

assertContainsOnlyInstancesOf() public static

assertContentType() public

assertCookie() public

assertCookieEncrypted() public

assertCookieNotSet() public

assertCount() public static

assertDirectoryExists() public static

assertDirectoryIsReadable() public static

assertDirectoryIsWritable() public static

assertDirectoryNotExists() public static

assertDirectoryNotIsReadable() public static

assertDirectoryNotIsWritable() public static

assertEmpty() public static

assertEqualXMLStructure() public static

assertEquals() public static

assertEqualsCanonicalizing() public static

assertEqualsIgnoringCase() public static

assertEqualsWithDelta() public static

assertEventFired() public

assertEventFiredWith() public

assertFalse() public static

assertFileEquals() public static

Class
IntegrationTestCase