Класс IntegrationTestCase
Класс тест-кейсов, предназначенный для упрощения интеграционных тестов контроллеров.
Этот тестовый класс предоставляет ряд вспомогательных методов и функций, которые упрощают отправку запросов и проверку их ответов. Он отдает предпочтение полным интеграционным тестам перед объектами-моделями, так как позволяет тестировать больше вашего кода и избежать некоторых проблем с обслуживанием, которые создают объекты-модели.
- PHPUnit\Framework\TestCase
-
Cake\TestSuite\TestCase
-
Cake\TestSuite\IntegrationTestCase использует Cake\Utility\CookieCryptTrait , Cake\View\Helper\SecureFieldTokenTrait
Краткое описание свойств
-
$_appArgsprotectedАргументы кастомизированного конструктора приложения.array|null -
$_appClassprotectedНаименование кастомизированного класса приложения.string|null - Контроллер, используемый в последнем запросе.
$_controllerprotected -
$_cookieprotectedДанные cookie для использования в следующем запросе.array -
$_cookieEncryptionKeyprotectednull|string -
$_csrfTokenprotectedbooleanФлаг булевого типа, указывающий, должен ли запрос содержать токен CSRF.
-
$_exceptionprotectedИсключение, которое выбрасывается в случае.Exception|null -
$_flashMessagesprotectedСохраненные сообщения flash перед рендерингом.null|array -
$_layoutNameprotectedПоследний рендернутый макет.string|null -
$_requestprotectedДанные, используемые для построения следующего запроса.array -
$_requestSessionprotectedЭкземпляр сессии из последнего запроса.Cake\Network\Session|null -
$_responseprotectedОтвет на последний запрос.Cake\Http\Response|null -
$_retainFlashMessagesprotectedbooleanФлаг булевого типа, указывающий, следует ли повторно сохранять сообщения flash.
-
$_securityTokenprotectedbooleanФлаг булевого типа, указывающий, должен ли запрос содержать токен SecurityComponent.
-
$_sessionprotectedДанные сессии для использования в следующем запросе.array -
$_useHttpServerprotectedbooleanОтслеживание того, выполняются ли тесты против стека HTTP PSR7.
-
$_viewNameprotectedПоследний рендернутый вид.string|null
Наследованные свойства
Краткое описание методов
- _addTokens() protectedДобавить токены CSRF и компонента безопасности, если необходимо.
- _assertStatus() protectedВспомогательный метод для проверки статуса.
- _buildRequest() protectedСоздаёт объект запроса с настроенными опциями и параметрами.
- _getBodyAsString() protectedПолучить тело ответа в виде строки
- _getCookieEncryptionKey() protectedВозвращает ключ шифрования, который будет использоваться.
- _handleError() protectedПопытка отобразить ответ об ошибке для заданного исключения.
- _makeDispatcher() protectedПолучить экземпляр диспетчера.
- _sendRequest() protectedСоздаёт и отправляет запрос в экземпляр диспетчера.
- _url() protectedСоздаёт корректный URL запроса и массив параметров, аналогично Request::_url()
- assertContentType() publicПроверяет тип содержимого
- assertCookie() publicПроверяет значения куки.
- assertCookieEncrypted() public
Проверяет значения куки, зашифрованные компонентом Cookie.
- assertCookieNotSet() publicПроверяет, что куки не установлены в ответе.
- assertFileResponse() publicПроверяет, что файл с заданным именем был отправлен в ответе.
- assertHeader() publicПроверяет заголовки ответа.
- assertHeaderContains() publicПроверяет, что заголовок ответа содержит строку.
- assertLayout() publicПроверяет, что поисковая строка была в имени макета.
- assertNoRedirect() publicПроверяет, что заголовок Location не установлен.
- assertRedirect() publicПроверяет, что заголовок Location верный.
- assertRedirectContains() publicПроверяет, что заголовок Location содержит подстроку.
- assertResponseCode() publicПроверяет определённый код состояния ответа.
- assertResponseContains() publicПроверяет, что содержимое присутствует в теле ответа.
- assertResponseEmpty() publicПроверить, что содержимое ответа пустое.
- assertResponseEquals() publicПроверяет, что содержимое присутствует в теле ответа.
- assertResponseError() publicПроверяет, что код состояния ответа находится в диапазоне 4xx.
- assertResponseFailure() publicПроверяет, что код состояния ответа находится в диапазоне 5xx.
- assertResponseNotContains() publicПроверяет, что содержимое отсутствует в теле ответа.
- assertResponseNotEmpty() publicПроверка, что содержимое ответа не пустое.
- assertResponseNotRegExp() publicПроверяет, что тело ответа не соответствует заданному регулярному выражению.
- assertResponseOk() publicПроверяет, что код состояния ответа находится в диапазоне 2xx.
- assertResponseRegExp() publicПроверяет, что тело ответа соответствует заданному регулярному выражению.
- assertResponseSuccess() publicПроверяет, что код состояния ответа находится в диапазоне 2xx/3xx.
- assertSession() publicПроверяет содержимое сессии.
- assertTemplate() publicПроверяет, что поисковая строка была в имени шаблона.
- configApplication() publicНастроить класс приложения для использования в интеграционных тестах.
- configRequest() publicНастраивает данные для следующего запроса.
- controllerSpy() publicДобавляет дополнительные шпионы событий в менеджер событий контроллера/представления.
- cookie() publicУстанавливает куки запроса для будущих запросов.
- cookieEncrypted() publicУстанавливает зашифрованную куки запроса для будущих запросов.
- delete() publicВыполняет запрос DELETE с использованием текущих данных запроса.
- Отключить обработчик ошибок middleware.
- enableCsrfToken() publicВызов этого метода добавит токен CSRF в запрос.
- enableRetainFlashMessages() public
Вызов этого метода сохранит сообщения флэша в сессии теста после их удаления FlashHelper
- enableSecurityToken() public
Вызов этого метода включит токен, совместимый с SecurityComponent, для добавления в данные запроса. Это позволяет легко тестировать действия, защищённые SecurityComponent.
- get() publicВыполняет запрос GET с использованием текущих данных запроса.
- head() publicВыполняет запрос HEAD с использованием текущих данных запроса.
- options() publicВыполняет запрос OPTIONS с использованием текущих данных запроса.
- patch() publicВыполняет запрос PATCH с использованием текущих данных запроса.
- post() publicВыполняет запрос POST с использованием текущих данных запроса.
- put() publicВыполняет запрос PUT с использованием текущих данных запроса.
- session() publicУстанавливает данные сессии.
- setUp() publicАвтоматически определяет, следует ли использовать стек middleware HTTP.
- tearDown() publicОчищает состояние, используемое для запросов.
- useHttpServer() publicВключить или отключить использование стека HTTP Server.
- viewVariable() publicИзвлекает переменную представления по имени.
Подробное описание методов
_addTokens()source protected
_addTokens( string $url , array $data )
Добавляет токены CSRF и компонента Security, если необходимо.
Параметры
- строка
$url - URL, на котором отправляется форма.
- массив
$data - Данные тела запроса.
Возвращаемое значение
массивТело запроса с добавленными токенами.
_assertStatus()source protected
_assertStatus( integer $min , integer $max , string $message )
Вспомогательный метод для утверждений о статусе.
Параметры
- целое число
$min - Минимальный код состояния.
- целое число
$max - Максимальный код состояния.
- строка
$message - Сообщение об ошибке.
_buildRequest()source protected
_buildRequest( string|array $url , string $method , array|null $data )
Создает объект запроса с настроенными параметрами.
Параметры
- строка|массив
$url - URL
- строка
$method - HTTP-метод
- массив|null
$data - Данные запроса.
Возвращаемое значение
массивКонтекст запроса
_getBodyAsString()source protected
_getBodyAsString( )
Получить тело ответа как строку
Возвращаемое значение
строкаТело ответа.
_getCookieEncryptionKey()source protected
_getCookieEncryptionKey( )
Возвращает используемый ключ шифрования.
Возвращаемое значение
строка_handleError()source protected
_handleError( Exception $exception )
Попытка отобразить ответ об ошибке для заданного исключения.
Этот метод попытается использовать настроенный обработчик исключений. Если этот класс не существует, будет использован встроенный обработчик.
Параметры
- Исключение
$exception - Исключение для обработки.
Исключение
Исключение_makeDispatcher()source protected
_makeDispatcher( )
Получить правильный экземпляр диспетчера.
Возвращаемое значение
Cake\TestSuite\MiddlewareDispatcher|Cake\TestSuite\LegacyRequestDispatcherЭкземпляр диспетчера
_sendRequest()source protected
_sendRequest( string|array $url , string $method , array|null $data [] )
Создает и отправляет запрос в экземпляр диспетчера.
Принимает и сохраняет ответ для последующего проверки.
Параметры
- строка|массив
$url - URL
- строка
$method - HTTP-метод
- массив|null
$dataoptional [] - Данные запроса.
Исключение
Исключение_url()source protected
_url( string|array $url )
Создает корректный URL запроса и массив параметров, подобно Request::_url()
Параметры
- строка|массив
$url - URL
Возвращаемое значение
массивПолный URL и параметры запроса
assertContentType()source public
assertContentType( string $type , string $message '' )
Утверждает тип контента
Параметры
- строка
$type - Тип контента для проверки.
- строка
$messageoptional '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertCookie()source public
assertCookie( string $expected , string $name , string $message '' )
Утверждает значения cookie
Параметры
- строка
$expected - Ожидаемое содержимое.
- строка
$name - Имя cookie.
- строка
$messageoptional '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertCookieEncrypted()source public
assertCookieEncrypted( string $expected , string $name , string|boolean $encrypt 'aes' , string|null $key null , string $message '' )
Утверждает значения cookie, зашифрованные компонентом Cookie.
Различие с assertCookie() заключается в том, что это значение cookie расшифровывает для проверки.
Параметры
- строка
$expected - Ожидаемое содержимое.
- строка
$name - Имя cookie.
- строка|boolean
$encryptoptional 'aes' - Использовать режим шифрования.
- строка|null
$keyoptional null Ключ шифрования. По умолчанию равен Security.salt.
- строка
$messageoptional '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
См. также
\Cake\Utility\CookieCryptTrait::_encrypt()assertCookieNotSet()source public
assertCookieNotSet( string $cookie , string $message '' )
Утверждает, что cookie не задано в ответе
Параметры
- строка
$cookie - Имя cookie для проверки.
- строка
$messageoptional '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertFileResponse()source public
assertFileResponse( string $expected , string $message '' )
Утверждает, что файл с заданным именем был отправлен в ответе
Параметры
- строка
$expected - Имя файла, который должен быть отправлен в ответе
- строка
$messageoptional '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertHeader()source public
assertHeader( string $header , string $content , string $message '' )
Утверждает заголовки ответа
Параметры
- строка
$header - Заголовок для проверки
- строка
$content - Содержимое для проверки.
- строка
$messageoptional '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertHeaderContains()source public
assertHeaderContains( string $header , string $content , string $message '' )
Утверждает, что заголовок ответа содержит строку
Параметры
- строка
$header - Заголовок для проверки
- строка
$content - Содержимое для проверки.
- строка
$messageoptional '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertLayout()source public
assertLayout( string $content , string $message '' )
Проверяет, что строка поиска находилась в имени макета.
Параметры
- строка
$content - Контент, который необходимо проверить.
- строка
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertNoRedirect()source public
assertNoRedirect( string $message '' )
Проверяет, что заголовок Location не установлен.
Параметры
- строка
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertRedirect()source public
assertRedirect( string|array|null $url null , string $message '' )
Проверяет, что заголовок Location верный.
Параметры
- строка|массив|null
$urlнеобязательно null Ожидаемый URL, куда должен перейти клиент. Это может быть строковый URL или массив, совместимый с Router::url(). Используйте null, чтобы просто проверить наличие этого заголовка.
- строка
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertRedirectContains()source public
assertRedirectContains( string $url , string $message '' )
Проверяет, что заголовок Location содержит подстроку.
Параметры
- строка
$url - Ожидаемый URL, куда должен перейти клиент.
- строка
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertResponseCode()source public
assertResponseCode( integer $code )
Проверяет конкретный код ответа состояния.
Параметры
- целое число
$code - Код состояния для проверки.
assertResponseContains()source public
assertResponseContains( string $content , string $message '' , boolean $ignoreCase false )
Проверяет, что содержимое существует в теле ответа.
Параметры
- строка
$content - Контент для проверки.
- строка
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
- булево
$ignoreCaseнеобязательно false - Флаг для проверки, следует ли игнорировать регистр или нет.
assertResponseEmpty()source public
assertResponseEmpty( string $message '' )
Проверка, что содержимое ответа пустое.
Параметры
- строка
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertResponseEquals()source public
assertResponseEquals( mixed $content , string $message '' )
Проверяет, что содержимое существует в теле ответа.
Параметры
- смешанный
$content - Контент для проверки.
- строка
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertResponseError()source public
assertResponseError( )
Проверяет, что код состояния ответа находится в диапазоне 4xx.
assertResponseFailure()source public
assertResponseFailure( )
Проверяет, что код состояния ответа находится в диапазоне 5xx.
assertResponseNotContains()source public
assertResponseNotContains( string $content , string $message '' )
Проверяет, что содержимого в теле ответа нет.
Параметры
- строка
$content - Контент для проверки.
- строка
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertResponseNotEmpty()source public
assertResponseNotEmpty( string $message '' )
Проверить, что содержимое ответа не пустое.
Параметры
- строка
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertResponseNotRegExp()source public
assertResponseNotRegExp( string $pattern , string $message '' )
Проверяет, что тело ответа не соответствует заданному регулярному выражению.
Параметры
- строка
$pattern - Шаблон для сравнения.
- строка
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertResponseOk()source public
assertResponseOk( )
Проверяет, что код состояния ответа находится в диапазоне 2xx.
assertResponseRegExp()source public
assertResponseRegExp( string $pattern , string $message '' )
Проверяет, что тело ответа соответствует заданному регулярному выражению.
Параметры
- строка
$pattern - Шаблон для сравнения.
- строка
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertResponseSuccess()source public
assertResponseSuccess( )
Проверяет, что код состояния ответа находится в диапазоне 2xx/3xx.
assertSession()source public
assertSession( string $expected , string $path , string $message '' )
Проверяет содержимое сессии.
Параметры
- строка
$expected - Ожидаемое содержимое.
- строка
$path - Путь к данным сессии. Использует нотацию, совместимую с Hash::get()
- строка
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertTemplate()source public
assertTemplate( string $content , string $message '' )
Проверяет, что строка поиска находилась в имени шаблона.
Параметры
- строка
$content - Контент для проверки.
- строка
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
configApplication()source public
configApplication( string $class , array|null $constructorArgs )
Настройте класс приложения, который будет использоваться в интеграционных тестах.
В сочетании с useHttpServer() для настройки имени класса и аргументов конструктора вашего класса приложения.
Параметры
- строка
$class - Имя класса приложения.
- массив|null
$constructorArgs - Аргументы конструктора для вашего класса приложения.
configRequest()source public
configRequest( array $data )
Настраивает данные для следующего запроса.
Эти данные очищаются в методе tearDown().
Вы можете вызывать этот метод несколько раз, чтобы добавить данные в текущее состояние.
Параметры
- массив
$data - Данные запроса для использования.
controllerSpy()source public
controllerSpy( Cake\Event\Event $event , Cake\Controller\Controller|null $controller null )
Добавляет дополнительные шпионские события в менеджер событий контроллера/представления.
Параметры
-
Cake\Event\Event$event - Событие диспетчера.
-
Cake\Controller\Controller|null$controllerнеобязательно null - Экземпляр контроллера.
cookie()source public
cookie( string $name , mixed $value )
Устанавливает куку запроса для будущих запросов.
Этот метод позволяет настроить данные сессии, которые должны использоваться для последующих запросов. Состояние сессии сбрасывается в каждом tearDown().
Вы можете вызывать этот метод несколько раз, чтобы добавить данные в текущее состояние.
Параметры
- строка
$name - Имя куки для использования.
- смешанное
$value - Значение куки.
cookieEncrypted()source public
cookieEncrypted( string $name , mixed $value , string|boolean $encrypt 'aes' , string|null $key null )
Устанавливает зашифрованную куку запроса для будущих запросов.
Различие с cookie() заключается в том, что это шифрует значение куки, как CookieComponent.
Параметры
- строка
$name - Имя куки для использования.
- смешанное
$value - Значение куки.
- строка|логическое
$encryptнеобязательно 'aes' - Режим шифрования для использования.
- строка|null
$keyнеобязательно null Ключ шифрования. По умолчанию используется Security.salt.
См. также
\Cake\Utility\CookieCryptTrait::_encrypt()delete()source public
delete( string|array $url )
Выполняет запрос DELETE с использованием текущих данных запроса.
Ответ на отправленный запрос будет сохранен в свойстве. Вы можете использовать различные методы проверки для проверки ответа.
Параметры
- строка|массив
$url - URL запроса.
disableErrorHandlerMiddleware()source public
disableErrorHandlerMiddleware( )
Отключить обработчик ошибок middleware.
Используя эту функцию, исключения больше не будут перехватываться ErrorHandlerMiddleware, а вместо этого будут повторно выброшены TestExceptionRenderer. Это может быть полезно для диагностики/отладки непредвиденных ошибок в тестовых случаях.
enableCsrfToken()source public
enableCsrfToken( )
Вызов этого метода добавит маркер CSRF в запрос.
Данные POST и куку будут заполнены, когда эта опция включена. Будут использоваться стандартные имена параметров.
enableRetainFlashMessages()source public
enableRetainFlashMessages( )
Вызов этого метода повторно сохранит сообщения флэша в тестовую сессию после удаления FlashHelper
enableSecurityToken()source public
enableSecurityToken( )
Вызов этого метода включит совместимый с SecurityComponent токен, который будет добавлен в данные запроса. Это позволяет легко тестировать действия, защищенные SecurityComponent.
get()source public
get( string|array $url )
Выполняет GET-запрос с использованием текущих данных запроса.
Ответ на отправленный запрос будет сохранен в свойстве. Вы можете использовать различные методы проверки для проверки ответа.
Параметры
- строка|массив
$url - URL запроса.
head()source public
head( string|array $url )
Выполняет HEAD-запрос с использованием текущих данных запроса.
Ответ на отправленный запрос будет сохранен в свойстве. Вы можете использовать различные методы проверки для проверки ответа.
Параметры
- строка|массив
$url - URL запроса.
options()source public
options( string|array $url )
Выполняет OPTIONS-запрос с использованием текущих данных запроса.
Ответ на отправленный запрос будет сохранен в свойстве. Вы можете использовать различные методы проверки для проверки ответа.
Параметры
- строка|массив
$url - URL запроса.
patch()source public
patch( string|array $url , array $data [] )
Выполняет PATCH-запрос с использованием текущих данных запроса.
Ответ на отправленный запрос будет сохранен в свойстве. Вы можете использовать различные методы проверки для проверки ответа.
Параметры
- строка|массив
$url - URL запроса.
- массив
$dataнеобязательно [] - Данные для запроса.
post()source public
post( string|array $url , array $data [] )
Выполняет POST-запрос с использованием текущих данных запроса.
Ответ на отправленный запрос будет сохранен в свойстве. Вы можете использовать различные методы проверки для проверки ответа.
Параметры
- строка|массив
$url - URL запроса.
- массив
$dataнеобязательно [] - Данные для запроса.
put()source public
put( string|array $url , array $data [] )
Выполняет PUT-запрос с использованием текущих данных запроса.
Ответ на отправленный запрос будет сохранен в свойстве. Вы можете использовать различные методы проверки для проверки ответа.
Параметры
- строка|массив
$url - URL запроса.
- массив
$dataнеобязательно [] - Данные для запроса.
session()source public
session( array $data )
Устанавливает данные сессии.
Этот метод позволяет настроить данные сессии, которые должны использоваться для последующих запросов. Состояние сессии сбрасывается в каждом tearDown().
Вы можете вызывать этот метод несколько раз, чтобы добавить данные в текущее состояние.
Параметры
- массив
$data - Данные сессии для использования.
setUp()source public
setUp( )
Автоматически определяет, следует ли использовать стек HTTP-средств промежуточного слоя.
Переопределяет
Cake\TestSuite\TestCase::setUp() tearDown()source public
tearDown( )
Очищает состояние, используемое для запросов.
Переопределяет
Cake\TestSuite\TestCase::tearDown() useHttpServer()source public
useHttpServer( boolean $enable )
Включить или выключить использование стека HTTP-сервера.
Параметры
- boolean
$enable - Включить/выключить использование стека HTTP.
viewVariable()source public
viewVariable( string $name )
Получает переменную представления по имени.
Если переменная представления не существует, возвращается null.
Параметры
- string
$name - Переменная представления для получения.
Возвращает
mixedПеременная представления, если она задана.
Методы, унаследованные от Cake\TestSuite\TestCase
_assertAttributes()source protected
_assertAttributes( array $assertions , string $string , boolean $fullDebug false , array|string $regex '' )
Проверяет атрибуты в рамках проверки assertTags().
Параметры
- array
$assertions - Проверки для выполнения.
- string
$string - Строка HTML для проверки.
- boolean
$fullDebugнеобязательно false - Использовать более подробный вывод.
- array|string
$regexнеобязательно '' - Полный регулярный шаблон из
assertHtml
Возвращает
string|boolean_normalizePath()source protected
_normalizePath( string $path )
Нормализует путь для сравнения.
Параметры
- string
$path - Путь, разделенный слешами ("/").
Возвращает
stringНормализованный путь, разделенный символом DIRECTORY_SEPARATOR.
assertEventFired()source public
assertEventFired( string $name , Cake\Event\EventManager|null $eventManager null , string $message '' )
Проверяет, что глобальное событие было вызвано. Для работы этой проверки необходимо отслеживать события в вашем диспетчере событий.
Параметры
- string
$name - Имя события
-
Cake\Event\EventManager|null$eventManagerнеобязательно null - Диспетчер событий для проверки, по умолчанию используется глобальный диспетчер событий
- string
$messageнеобязательно '' - Сообщение об ошибке проверки
assertEventFiredWith()source public
assertEventFiredWith( string $name , string $dataKey , string $dataValue , Cake\Event\EventManager|null $eventManager null , string $message '' )
Проверяет, что событие было вызвано с данными.
Если в качестве третьего аргумента передается значение, то это значение используется для сравнения со значением в $dataKey.
Параметры
- string
$name - Имя события
- string
$dataKey - Ключ данных
- string
$dataValue - Значение данных
-
Cake\Event\EventManager|null$eventManagerнеобязательно null - Диспетчер событий для проверки, по умолчанию используется глобальный диспетчер событий
- string
$messageнеобязательно '' - Сообщение об ошибке проверки
assertHtml()source public
assertHtml( array $expected , string $string , boolean $fullDebug false )
Проверяет теги HTML.
Принимает массив $expected и генерирует из него регулярное выражение для соответствия предоставленной строке $string. Примеры для $expected:
Проверка тега input с атрибутом name (содержащим любое непустое значение) и атрибутом id, содержащим 'my-input':
['input' => ['name', 'id' => 'my-input']]
Проверка двух тегов p с некоторым текстом внутри:
[ ['p' => true], 'textA', '/p', ['p' => true], 'textB', '/p' ]
Также можно указать выражение шаблона в качестве части значений атрибутов или определяемого тега, если вы добавите префикс preg: и заключите его в косые черты, например:
[ ['input' => ['name', 'id' => 'preg:/FieldName\d+/']], 'preg:/My\s+field/' ]
Важно: Эта функция очень терпима к пробелам и также принимает любую перестановку порядка атрибутов. Она также допускает пробелы между указанными тегами.
Параметры
- array
$expected - Массив, см. выше
- string
$string - Строка HTML/XHTML/XML
- boolean
$fullDebugнеобязательно false - Использовать более подробный вывод.
Возвращает
booleanassertNotWithinRange()source protected static
assertNotWithinRange( float $expected , float $result , float $margin , string $message '' )
Функция совместимости для проверки, что значение не находится в приемлемом диапазоне.
Параметры
- float
$expected - float
$result - float
$margin - диапазон приемлемости
- string
$messageнеобязательно '' - текст, отображаемый, если проверка не верна
assertPathEquals()source protected static
assertPathEquals( string $expected , string $result , string $message '' )
Функция совместимости для проверки путей.
Параметры
- string
$expected - string
$result - string
$messageнеобязательно '' - текст, отображаемый, если проверка не верна
assertTags()source public
assertTags( string $string , array $expected , boolean $fullDebug false )
Проверяет теги HTML.
Устарело
3.0. Используйте assertHtml() вместо этого.Параметры
- string
$string - Строка HTML/XHTML/XML
- array
$expected - Массив, см. выше
- boolean
$fullDebugнеобязательно false - Использовать более подробный вывод.
assertTextContains()source public
assertTextContains( string $needle , string $haystack , string $message '' , boolean $ignoreCase false )
Проверяет, что строка содержит другую строку, игнорируя различия в символах новой строки. Полезно для выполнения тестов на разных платформах с блоками текста.
Параметры
- string
$needle - Строка для поиска.
- string
$haystack - Строка для поиска в ней.
- string
$messageнеобязательно '' - Сообщение для отображения при ошибке.
- boolean
$ignoreCaseнеобязательно false - Выполнять ли поиск с учетом регистра.
assertTextEndsNotWith()source public
assertTextEndsNotWith( string $suffix , string $string , string $message '' )
Проверяет, что строка не заканчивается заданным префиксом, игнорируя различия в символах новой строки. Полезно для выполнения тестов на разных платформах с блоками текста.
Параметры
- string
$suffix - Суффикс, которого не должно быть.
- string
$string - Строка для поиска.
- string
$messageнеобязательно '' - Сообщение, используемое при ошибке.
assertTextEndsWith()source public
assertTextEndsWith( string $suffix , string $string , string $message '' )
Утверждает, что строка заканчивается заданным префиксом, игнорируя различия в символах новой строки. Полезно для проведения кроссплатформенных тестов блоков текста.
Параметры
- string
$suffix - Суффикс для поиска.
- string
$string - Строка для поиска.
- string
$messageoptional '' - Сообщение для использования при ошибке.
assertTextEquals()source public
assertTextEquals( string $expected , string $result , string $message '' )
Утверждает равенство текста, игнорируя различия в символах новой строки. Полезно для проведения кроссплатформенных тестов блоков текста.
Параметры
- string
$expected - Ожидаемое значение.
- string
$result - Фактическое значение.
- string
$messageoptional '' - Сообщение для использования при ошибке.
assertTextNotContains()source public
assertTextNotContains( string $needle , string $haystack , string $message '' , boolean $ignoreCase false )
Утверждает, что текст не содержит другой текст, игнорируя различия в символах новой строки. Полезно для проведения кроссплатформенных тестов блоков текста.
Параметры
- string
$needle - Строка для поиска.
- string
$haystack - Строка для поиска в ней.
- string
$messageoptional '' - Сообщение для отображения при ошибке.
- boolean
$ignoreCaseoptional false - Указывает, должен ли поиск быть регистрозависимым.
assertTextNotEquals()source public
assertTextNotEquals( string $expected , string $result , string $message '' )
Утверждает неравенство текста, игнорируя различия в символах новой строки. Полезно для проведения кроссплатформенных тестов блоков текста.
Параметры
- string
$expected - Ожидаемое значение.
- string
$result - Фактическое значение.
- string
$messageoptional '' - Сообщение для использования при ошибке.
assertTextStartsNotWith()source public
assertTextStartsNotWith( string $prefix , string $string , string $message '' )
Утверждает, что строка не начинается с заданного префикса, игнорируя различия в символах новой строки. Полезно для проведения кроссплатформенных тестов блоков текста.
Параметры
- string
$prefix - Префикс, которого не должно быть.
- string
$string - Строка для поиска.
- string
$messageoptional '' - Сообщение для использования при ошибке.
assertTextStartsWith()source public
assertTextStartsWith( string $prefix , string $string , string $message '' )
Утверждает, что строка начинается с заданного префикса, игнорируя различия в символах новой строки. Полезно для проведения кроссплатформенных тестов блоков текста.
Параметры
- string
$prefix - Префикс для проверки.
- string
$string - Строка для поиска в ней.
- string
$messageoptional '' - Сообщение для использования при ошибке.
assertWithinRange()source protected static
assertWithinRange( float $expected , float $result , float $margin , string $message '' )
Функция совместимости для проверки, находится ли значение в допустимом диапазоне.
Параметры
- float
$expected - float
$result - float
$margin - диапазон принятия
- string
$messageoptional '' - текст для отображения, если утверждение неверно
getMockForModel()source public
getMockForModel( string $alias , array $methods [] , array $options [] )
Имитировать модель, поддерживать фикстуры и ассоциации таблиц
Параметры
- string
$alias - Модель, для которой требуется имитация.
- array
$methodsoptional [] - Список методов для имитации
- array
$optionsoptional [] - Данные конфигурации для конструктора имитации.
Возвращает
Cake\ORM\Table|PHPUnit_Framework_MockObject_MockObjectВыбрасывает
Cake\ORM\Exception\MissingTableClassExceptionloadFixtures()source public
loadFixtures( )
Выбирает фикстуры для загрузки для данного теста
Каждый параметр — имя модели, которое соответствует фикстуре, например, 'Posts', 'Authors' и т. д. Если не передавать параметров, все фикстуры в тестовом случае будут загружены.
Выбрасывает
Исключениеесли менеджер фикстур недоступен.
См. также
\Cake\TestSuite\TestCase::$autoFixturessetAppNamespace()source public static
setAppNamespace( string $appNamespace 'TestApp' )
Установить имя пространства приложения
Параметры
- string
$appNamespaceoptional 'TestApp' - Имя пространства приложения, по умолчанию «TestApp».
skipIf()source public
skipIf( boolean $shouldSkip , string $message '' )
Переопределяет SimpleTestCase::skipIf, чтобы предоставить логическое значение возврата
Параметры
- boolean
$shouldSkip - Указывает, нужно ли пропустить тест.
- string
$messageoptional '' - Сообщение для отображения.
Возвращает
booleanskipUnless()source protected
skipUnless( boolean $condition , string $message '' )
Функция совместимости для пропуска.
Параметры
- boolean
$condition - Условие для запуска пропуска
- string
$messageoptional '' - Сообщение для пропуска
Возвращает
booleanМетоды, используемые из Cake\Utility\CookieCryptTrait
_checkCipher()source protected
_checkCipher( string $encrypt )
Вспомогательный метод для проверки имен шифров шифрования.
Параметры
- string
$encrypt - Имя шифра.
Выбрасывает
RuntimeExceptionЕсли предоставлен недопустимый шифр.
_decode()source protected
_decode( string $value , string|false $encrypt , string|null $key )
Декодирует и расшифровывает одно значение.
Параметры
- string
$value - Значение для декодирования и расшифрования.
- string|false
$encrypt - Используемый шифр шифрования.
- string|null
$key - Используется в качестве секретной соли, если указано.
Возвращает
string|arrayДекодированные значения.
_decrypt()source protected
_decrypt( array $values , string|boolean $mode , string|null $key null )
Расшифровывает $value с помощью метода public $type класса Security
Параметры
- array
$values - Значения для расшифрования
- string|boolean
$mode - Режим шифрования
- string|null
$keyoptional null - Используется в качестве секретной соли, если указано.
Возвращает
string|arrayРасшифрованные значения
_encrypt()source protected
_encrypt( string $value , string|boolean $encrypt , string|null $key null )
Шифрует $value с помощью метода public $type класса Security
Параметры
- строка
$value - Значение для шифрования
- строка|логическое значение
$encrypt Режим шифрования для использования. False отключает шифрование.
- строка|null
$keyнеобязательно null - Используется в качестве криптографической соли, если указана.
Возвращаемое значение
строкаЗакодированные значения
_explode()source protected
_explode( string $string )
Метод explode для возврата массива из строки, заданной в CookieComponent::_implode(). Сохраняет обратную совместимость с чтением из CookieComponent::_implode() версии 1.x.
Параметры
- строка
$string - Строка, содержащая данные, закодированные в JSON, или обычная строка.
Возвращаемое значение
строка|массивКарта ключей и значений
_implode()source protected
_implode( array $array )
Метод implode для сохранения ключей в многомерных массивах.
Параметры
- массив
$array - Карта ключей и значений
Возвращаемое значение
строкаСтрока, закодированная в JSON.
Методы, используемые из Cake\View\Helper\SecureFieldTokenTrait
_buildFieldToken()source protected
_buildFieldToken( string $url , array $fields , array $unlockedFields [] )
Генерирует данные токена для предоставленных входных данных.
Параметры
- строка
$url - URL, на который отправляется форма.
- массив
$fields Если задан, указывает список полей, используемых при генерации хэша.
- массив
$unlockedFieldsнеобязательно [] Список полей, исключенных из проверки валидности.
Возвращаемое значение
массивДанные токена.
Подробное описание свойств
$_controllersource
protected Cake\Controller\Controller|null
Контроллер, используемый в последнем запросе.
$_cookieEncryptionKeysource
protected null|строка
$_csrfTokensource
protected логическое значение
Флаг логического значения для включения/отключения токена CSRF в запросе.
false
$_exceptionsource
protected Исключение|null
Исключение, которое выбрасывается в случае необходимости.
$_retainFlashMessagessource
protected логическое значение
Флаг логического значения для сохранения сообщений flash.
false
$_securityTokensource
protected логическое значение
Флаг логического значения для включения/отключения токена SecurityComponent в запросе.
false
$_useHttpServersource
protected логическое значение
Отслеживает, выполняются ли тесты с помощью стека PSR7 HTTP.
false
© 2005–2017 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/3.4/class-Cake.TestSuite.IntegrationTestCase.html