Trait IntegrationTestTrait
A trait 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.
Property Summary
-
$_appArgs protected
array|null
The customized application constructor arguments.
-
$_appClass protected
string|null
The customized application class name.
-
$_controller protected
Cake\Controller\Controller|null
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
Exception|null
The exception being thrown if the case.
-
$_flashMessages protected
array|null
Stored flash messages before render
-
$_layoutName protected
string|null
The last rendered layout
-
$_request protected
array
The data used to build the next request.
-
$_requestSession protected
Cake\Http\Session|null
The session instance from the last request
-
$_response protected
Cake\Http\Response|null
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.
-
$_unlockedFields protected
string[]
List of fields that are excluded from field validation.
-
$_useHttpServer protected
bool
Track whether or not tests are run against the PSR7 HTTP stack.
-
$_validCiphers protected
string[]
Valid cipher names for encrypted cookies.
-
$_viewName protected
string|null
The last rendered view
Method Summary
-
_addTokens() protected
Add the CSRF and Security Component tokens if necessary.
-
_buildFieldToken() protected
Generate the token data for the provided inputs.
-
_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.
-
_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.
-
_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()
-
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
-
assertFileResponse() public
Asserts that a file with the given name was sent in the response
-
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
-
assertHeader() public
Asserts response headers
-
assertHeaderContains() public
Asserts response header contains a string
-
assertHeaderNotContains() public
Asserts response header does not contain a string
-
assertLayout() public
Asserts that the search string was in the layout name.
-
assertNoRedirect() public
Asserts that the Location header is not set.
-
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
-
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.
-
assertSession() public
Asserts session contents
-
assertTemplate() public
Asserts that the search string was in the template name.
-
cleanup() public
Clears the state used for requests.
-
configApplication() public
Configure the application class to use in integration tests.
-
configRequest() public
Configures the data for the next request.
-
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.
-
delete() public
Performs a DELETE request using the current request data.
-
disableErrorHandlerMiddleware() public
Disable the error handler middleware.
-
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.
-
extractExceptionMessage() protected
Extract verbose message for existing exception
-
extractVerboseMessage() protected
Inspect controller to extract possible causes of the failed assertion
-
get() public
Performs a GET request using the current request data.
-
head() public
Performs a HEAD request using the current request data.
-
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.
-
put() public
Performs a PUT request using the current request data.
-
session() public
Sets session data.
-
setUnlockedFields() public
Set list of fields that are excluded from field validation.
-
setupServer() public
Auto-detect if the HTTP middleware stack should be used.
-
useHttpServer() public
Toggle whether or not you want to use the HTTP Server stack.
-
viewVariable() public
Fetches a view variable by name.
Method Detail
_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
_buildFieldToken() ¶ protected
_buildFieldToken(string $url, array $fields, string[] $unlockedFields = []): array
Generate the token data for the provided inputs.
Parameters
-
string
$url The URL the form is being submitted to.
-
array
$fields If set specifies the list of fields to use when generating the hash.
-
string[]
$unlockedFields optional The list of fields that are excluded from field validation.
Returns
array
_buildRequest() ¶ protected
_buildRequest(string|array $url, string $method, string|array $data = []): array
Creates a request object with the configured options and parameters.
Parameters
-
string|array
$url The URL
-
string
$method The HTTP method
-
string|array
$data optional The request data.
Returns
array
_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
_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
_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
_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
_getBodyAsString() ¶ protected
_getBodyAsString(): string
Get the response body as string
Returns
string
_getCookieEncryptionKey() ¶ protected
_getCookieEncryptionKey(): string
Returns the encryption key to be used.
Returns
string
_handleError() ¶ protected
_handleError(Exception $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
-
Exception
$exception Exception to handle.
Returns
void
Throws
Exception
_implode() ¶ protected
_implode(array $array): string
Implode method to keep keys are multidimensional arrays
Parameters
-
array
$array Map of key and values
Returns
string
_makeDispatcher() ¶ protected
_makeDispatcher(): Cake\TestSuite\MiddlewareDispatcherCake\TestSuite\LegacyRequestDispatcher
Get the correct dispatcher instance.
Returns
Cake\TestSuite\MiddlewareDispatcherCake\TestSuite\LegacyRequestDispatcher
_sendRequest() ¶ protected
_sendRequest(string|array $url, string $method, string|array|null $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|null
$data optional The request data.
Returns
void
Throws
PHPUnit\Exception
_url() ¶ protected
_url(string|array $url): array
Creates a valid request url and parameter array more like Request::_url()
Parameters
-
string|array
$url The URL
Returns
array
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(string $expected, string $name, string $message = ''): void
Asserts cookie values
Parameters
-
string
$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(string $expected, string $name, string|bool $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
-
string
$expected The expected contents.
-
string
$name The cookie name.
-
string|bool
$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
See Also
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
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
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
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
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
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
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
assertResponseCode() ¶ public
assertResponseCode(int $code, string $message = null): 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 = null): 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 = null): 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 = null): 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 = null): void
Asserts that the response status code is in the 2xx/3xx range.
Parameters
-
string
$message optional Custom message for failure.
Returns
void
assertSession() ¶ public
assertSession(string $expected, string $path, string $message = ''): void
Asserts session contents
Parameters
-
string
$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
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
configApplication() ¶ public
configApplication(string $class, array|null $constructorArgs): void
Configure the application class to use in integration tests.
Combined with useHttpServer()
to customize the class name and constructor arguments
of your application class.
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
controllerSpy() ¶ public
controllerSpy(Cake\Event\Event $event, Cake\Controller\Controller|null $controller = null): void
Adds additional event spies to the controller/view event manager.
Parameters
-
Cake\Event\Event
$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|bool $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|bool
$encrypt optional Encryption mode to use.
-
string|null
$key optional Encryption key used. Defaults to Security.salt.
Returns
void
See Also
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
Throws
PHPUnit\Exception
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
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
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 = null): string|null
Inspect controller to extract possible causes of the failed assertion
Parameters
-
string
$message optional Original message to use as a base
Returns
string|null
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
Throws
PHPUnit\Exception
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
Throws
PHPUnit\Exception
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
Throws
PHPUnit\Exception
patch() ¶ public
patch(string|array $url, string|array|null $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|null
$data optional The data for the request.
Returns
void
Throws
PHPUnit\Exception
post() ¶ public
post(string|array $url, string|array|null $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|null
$data optional The data for the request.
Returns
void
Throws
PHPUnit\Exception
put() ¶ public
put(string|array $url, string|array|null $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|null
$data optional The data for the request.
Returns
void
Throws
PHPUnit\Exception
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
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
setupServer() ¶ public
setupServer(): void
Auto-detect if the HTTP middleware stack should be used.
Returns
void
useHttpServer() ¶ public
useHttpServer(bool $enable): void
Toggle whether or not you want to use the HTTP Server stack.
Parameters
-
bool
$enable Enable/disable the usage of the HTTP Stack.
Returns
void
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
Property Detail
$_controller ¶ protected
The controller used in the last request.
Type
Cake\Controller\Controller|null
$_csrfToken ¶ protected
Boolean flag for whether or not the request should have a CSRF token added.
Type
bool
$_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
$_useHttpServer ¶ protected
Track whether or not tests are run against the PSR7 HTTP stack.
Type
bool