Класс IntegrationTestCase
Класс тестовых случаев, предназначенный для упрощения интеграционных тестов контроллеров.
Этот тестовый класс предоставляет ряд вспомогательных методов и функций, которые упрощают отправку запросов и проверку их ответов. Он отдает предпочтение полным интеграционным тестам перед объектами-моками, так как позволяет проще тестировать больше кода и избежать некоторых проблем с обслуживанием, которые создают объекты-моки.
- PHPUnit\Framework\TestCase
-
Cake\TestSuite\TestCase использует Cake\ORM\Locator\LocatorAwareTrait
-
Cake\TestSuite\IntegrationTestCase использует Cake\Utility\CookieCryptTrait , Cake\View\Helper\SecureFieldTokenTrait
Краткое описание свойств
-
$_appArgsprotectedАргументы конструктора настроенного приложения.array|null -
$_appClassprotectedИмя настроенного класса приложения.string|null - Контроллер, используемый в последнем запросе.
$_controllerprotected -
$_cookieprotectedДанные cookie, используемые в следующем запросе.array -
$_cookieEncryptionKeyprotectednull|string -
$_csrfTokenprotectedbooleanФлаг булевого типа, указывающий, должен ли запрос иметь добавленный токен CSRF.
-
$_disableRouterReloadprotectedОтключение перезагрузки маршрутизатора.boolean -
$_exceptionprotectedИсключение, выбрасываемое, если случай произошел.Exception|null -
$_flashMessagesprotectedСохраненные сообщения всплывающих окон до рендерингаnull|array -
$_layoutNameprotectedПоследний рендер макетаstring|null -
$_requestprotectedДанные, используемые для создания следующего запроса.array -
$_requestSessionprotectedЭкземпляр сессии из последнего запросаCake\Http\Session|null -
$_responseprotectedОтвет на самый недавний запрос.Cake\Http\Response|null -
$_retainFlashMessagesprotectedbooleanФлаг булевого типа, указывающий, нужно ли повторно сохранять сообщения всплывающих окон.
-
$_securityTokenprotectedbooleanФлаг булевого типа, указывающий, должен ли запрос иметь добавленный токен SecurityComponent.
-
$_sessionprotectedДанные сессии для использования в следующем запросе.array -
$_useHttpServerprotectedbooleanОтслеживает, выполняются ли тесты против стека HTTP PSR7.
-
$_viewNameprotectedПоследний рендер представленияstring|null
Наследованные свойства
Краткое описание методов
- _addTokens() protectedДобавить токены CSRF и компонента Security, если необходимо.
- _assertStatus() protectedВспомогательный метод для утверждений о статусе.
- _buildRequest() protectedСоздаёт объект запроса с настроенными параметрами.
- _castToString() protected
Рекурсивно преобразует все данные в строку, так как именно таким образом данные передаются методом POST в реальном мире
- _getBodyAsString() protectedПолучить тело ответа в виде строки
- _getCookieEncryptionKey() protectedВозвращает ключ шифрования, который нужно использовать.
- _handleError() protectedПопытка отобразить ответ об ошибке для данного исключения.
- _makeDispatcher() protectedПолучить нужный экземпляр диспетчера.
- _sendRequest() protectedСоздаёт и отправляет запрос в экземпляр диспетчера.
- _url() protectedСоздаёт допустимый URL запроса и массив параметров, аналогично Request::_url()
- assertContentType() publicПроверяет тип контента
- assertCookie() publicПроверяет значения cookie
- assertCookieEncrypted() public
Проверяет значения cookie, которые зашифрованы компонентом Cookie.
- assertCookieNotSet() publicПроверяет, что cookie не был установлен в ответе
- 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Устанавливает cookie запроса для будущих запросов.
- cookieEncrypted() publicУстанавливает зашифрованное cookie запроса для будущих запросов.
- delete() publicВыполняет запрос DELETE с использованием текущих данных запроса.
- Отключает обработчик ошибок middleware.
- enableCsrfToken() publicВызов этого метода добавит токен CSRF в запрос.
- enableRetainFlashMessages() public
Вызов этого метода повторно сохранит сообщения flash в тестовой сессии после удаления их 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-сервера.
- 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 - Данные запроса.
Возвращает
массивКонтекст запроса
_castToString()source protected
_castToString( array $data )
Рекурсивно преобразует все данные в строки, так как данные отправляются POST-запросом в реальном мире
Параметры
- массив
$data - Данные POST-запроса
Возвращает
массив_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
$dataнеобязательно [] - Данные запроса.
Исключения
PHPUnit\Exception_url()source protected
_url( string $url )
Создаёт корректный URL запроса и массив параметров, аналогично Request::_url()
Параметры
- строка
$url - URL
Возвращает
массивКвалифицированный URL и параметры запроса
assertContentType()source public
assertContentType( string $type , string $message = '' )
Проверяет тип контента
Параметры
- строка
$type - Тип контента для проверки.
- строка
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertCookie()source public
assertCookie( string $expected , string $name , string $message = '' )
Проверяет значения cookie
Параметры
- строка
$expected - Ожидаемое содержимое.
- строка
$name - Имя cookie.
- строка
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertCookieEncrypted()source public
assertCookieEncrypted( string $expected , string $name , string|boolean $encrypt = 'aes' , string|null $key = null , string $message = '' )
Проверяет значения cookie, зашифрованные компонентом Cookie.
Отличие от assertCookie() заключается в том, что это расшифрует значение cookie, как это делает компонент Cookie для этой проверки.
Параметры
- строка
$expected - Ожидаемое содержимое.
- строка
$name - Имя cookie.
- строка|логическое
$encryptнеобязательно 'aes' - Режим шифрования для использования.
- строка|null
$keyнеобязательно null Используемый ключ шифрования. По умолчанию Security.salt.
- строка
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
См. также
\Cake\Utility\CookieCryptTrait::_encrypt()assertCookieNotSet()source public
assertCookieNotSet( string $cookie , string $message = '' )
Проверяет, что cookie не установлен в ответе
Параметры
- строка
$cookie - Имя cookie для проверки
- строка
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertFileResponse()source public
assertFileResponse( string $expected , string $message = '' )
Проверяет, что файл с заданным именем был отправлен в ответ
Параметры
- строка
$expected - Имя файла, который должен быть отправлен в ответе
- строка
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertHeader()source public
assertHeader( string $header , string $content , string $message = '' )
Проверяет заголовки ответа
Параметры
- строка
$header - Заголовок для проверки
- строка
$content - Содержимое для проверки.
- строка
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertHeaderContains()source public
assertHeaderContains( string $header , string $content , string $message = '' )
Проверяет, что заголовок ответа содержит строку
Параметры
- string
$header - Заголовок для проверки
- string
$content - Содержимое для поиска.
- string
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertLayout()source public
assertLayout( string $content , string $message = '' )
Проверяет, что строка поиска была в имени макета.
Параметры
- string
$content - Содержимое для поиска.
- string
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertNoRedirect()source public
assertNoRedirect( string $message = '' )
Проверяет, что заголовок Location не установлен.
Параметры
- string
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertRedirect()source public
assertRedirect( string|array|null $url = null , string $message = '' )
Проверяет, что заголовок Location правильный.
Параметры
- string|array|null
$urlнеобязательно null Ожидаемый URL, на который должен перейти клиент. Это может быть строковый URL или массив, совместимый с Router::url(). Используйте null, чтобы просто проверить наличие этого заголовка.
- string
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertRedirectContains()source public
assertRedirectContains( string $url , string $message = '' )
Проверяет, что заголовок Location содержит подстроку
Параметры
- string
$url - Ожидаемый URL, на который должен перейти клиент.
- string
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertResponseCode()source public
assertResponseCode( integer $code , string $message = null )
Проверяет определённый код состояния ответа.
Параметры
- integer
$code - Код состояния для проверки.
- string
$messageнеобязательно null - Пользовательское сообщение об ошибке.
assertResponseContains()source public
assertResponseContains( string $content , string $message = '' , boolean $ignoreCase = false )
Проверяет наличие содержимого в теле ответа.
Параметры
- string
$content - Содержимое для поиска.
- string
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
- boolean
$ignoreCaseнеобязательно false - Флаг, указывающий, следует ли игнорировать регистр.
assertResponseEmpty()source public
assertResponseEmpty( string $message = '' )
Проверка, что содержимое ответа пустое.
Параметры
- string
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertResponseEquals()source public
assertResponseEquals( mixed $content , string $message = '' )
Проверяет наличие содержимого в теле ответа.
Параметры
- mixed
$content - Содержимое для проверки.
- string
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertResponseError()source public
assertResponseError( string $message = null )
Проверяет, что код состояния ответа находится в диапазоне 4xx.
Параметры
- string
$messageнеобязательно null - Пользовательское сообщение об ошибке.
assertResponseFailure()source public
assertResponseFailure( string $message = null )
Проверяет, что код состояния ответа находится в диапазоне 5xx.
Параметры
- string
$messageнеобязательно null - Пользовательское сообщение об ошибке.
assertResponseNotContains()source public
assertResponseNotContains( string $content , string $message = '' )
Проверяет, что содержимого в теле ответа нет.
Параметры
- string
$content - Содержимое для проверки.
- string
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertResponseNotEmpty()source public
assertResponseNotEmpty( string $message = '' )
Проверяет, что содержимое ответа не пустое.
Параметры
- string
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertResponseNotRegExp()source public
assertResponseNotRegExp( string $pattern , string $message = '' )
Проверяет, что тело ответа не соответствует заданному регулярному выражению.
Параметры
- string
$pattern - Образец для сравнения.
- string
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertResponseOk()source public
assertResponseOk( string $message = null )
Проверяет, что код состояния ответа находится в диапазоне 2xx.
Параметры
- string
$messageнеобязательно null - Пользовательское сообщение об ошибке.
assertResponseRegExp()source public
assertResponseRegExp( string $pattern , string $message = '' )
Проверяет, что тело ответа соответствует заданному регулярному выражению.
Параметры
- string
$pattern - Образец для сравнения.
- string
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertResponseSuccess()source public
assertResponseSuccess( string $message = null )
Проверяет, что код состояния ответа находится в диапазонах 2xx/3xx.
Параметры
- string
$messageнеобязательно null - Пользовательское сообщение об ошибке.
assertSession()source public
assertSession( string $expected , string $path , string $message = '' )
Проверяет содержимое сессии
Параметры
- string
$expected - Ожидаемое содержимое.
- string
$path - Путь к данным сессии. Используется нотация, совместимая с Hash::get()
- string
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
assertTemplate()source public
assertTemplate( string $content , string $message = '' )
Проверяет, что строка поиска была в имени шаблона.
Параметры
- string
$content - Контент для проверки.
- string
$messageнеобязательно '' - Сообщение об ошибке, которое будет добавлено к сгенерированному сообщению.
configApplication()source public
configApplication( string $class , array|null $constructorArgs )
Настройка класса приложения для использования в интеграционных тестах.
В сочетании с useHttpServer() для настройки имени класса и аргументов конструктора вашего класса приложения.
Параметры
- string
$class - Имя класса приложения.
- array|null
$constructorArgs - Аргументы конструктора для вашего класса приложения.
configRequest()source public
configRequest( array $data )
Настраивает данные для следующего запроса.
Эти данные очищаются в методе tearDown().
Вы можете вызывать этот метод несколько раз, чтобы добавить данные в текущее состояние.
Параметры
- array
$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().
Вы можете вызывать этот метод несколько раз, чтобы добавить данные в текущее состояние.
Параметры
- string
$name - Имя куки для использования.
- mixed
$value - Значение куки.
cookieEncrypted()source public
cookieEncrypted( string $name , mixed $value , string|boolean $encrypt = 'aes' , string|null $key = null )
Устанавливает зашифрованную куки запроса для будущих запросов.
Разница с cookie() в том, что это шифрует значение куки, как CookieComponent.
Параметры
- string
$name - Имя куки для использования.
- mixed
$value - Значение куки.
- string|boolean
$encryptнеобязательно 'aes' - Режим шифрования для использования.
- string|null
$keyнеобязательно null Ключ шифрования. По умолчанию Security.salt.
См. также
\Cake\Utility\CookieCryptTrait::_encrypt()delete()source public
delete( string|array $url )
Выполняет запрос DELETE с использованием текущих данных запроса.
Ответ на отправленный запрос будет сохранён в свойстве. Вы можете использовать различные методы проверки для проверки ответа.
Параметры
- string|array
$url - URL для запроса.
Вызывает
PHPUnit\ExceptiondisableErrorHandlerMiddleware()source public
disableErrorHandlerMiddleware( )
Отключить обработчик ошибок middleware.
Используя эту функцию, исключения больше не будут перехватываться ErrorHandlerMiddleware, а вместо этого будут повторно выброшены TestExceptionRenderer. Это может быть полезно при попытке диагностики/отладки неожиданных ошибок в тестовых сценариях.
enableCsrfToken()source public
enableCsrfToken( )
Вызов этого метода добавит токен CSRF в запрос.
И данные POST, и куки будут заполнены, когда этот параметр включен. Будут использованы значения по умолчанию для имён параметров.
enableRetainFlashMessages()source public
enableRetainFlashMessages( )
Вызов этого метода повторно сохранит сообщения flash в тестовой сессии после удаления FlashHelper
enableSecurityToken()source public
enableSecurityToken( )
Вызов этого метода включит токен, совместимый с SecurityComponent, который будет добавлен в данные запроса. Это позволит легко тестировать действия, защищённые SecurityComponent.
get()source public
get( string|array $url )
Выполняет запрос GET с использованием текущих данных запроса.
Ответ на отправленный запрос будет сохранён в свойстве. Вы можете использовать различные методы проверки для проверки ответа.
Параметры
- string|array
$url - URL для запроса.
Вызывает
PHPUnit\Exceptionhead()source public
head( string|array $url )
Выполняет запрос HEAD с использованием текущих данных запроса.
Ответ на отправленный запрос будет сохранён в свойстве. Вы можете использовать различные методы проверки для проверки ответа.
Параметры
- string|array
$url - URL для запроса.
Вызывает
PHPUnit\Exceptionoptions()source public
options( string|array $url )
Выполняет запрос OPTIONS с использованием текущих данных запроса.
Ответ на отправленный запрос будет сохранён в свойстве. Вы можете использовать различные методы проверки для проверки ответа.
Параметры
- string|array
$url - URL для запроса.
Вызывает
PHPUnit\Exceptionpatch()source public
patch( string|array $url , array $data = [] )
Выполняет запрос PATCH с использованием текущих данных запроса.
Ответ на отправленный запрос будет сохранён в свойстве. Вы можете использовать различные методы проверки для проверки ответа.
Параметры
- string|array
$url - URL для запроса.
- array
$dataнеобязательно [] - Данные для запроса.
Вызывает
PHPUnit\Exceptionpost()source public
post( string|array $url , array $data = [] )
Выполняет запрос POST с использованием текущих данных запроса.
Ответ на отправленный запрос будет сохранён в свойстве. Вы можете использовать различные методы проверки для проверки ответа.
Параметры
- string|array
$url - URL для запроса.
- array
$dataнеобязательно [] - Данные для запроса.
Вызывает
PHPUnit\Exceptionput()source public
put( string|array $url , array $data = [] )
Выполняет запрос PUT с использованием текущих данных запроса.
Ответ на обработанный запрос будет сохранён в качестве свойства. Вы можете использовать различные методы проверки для проверки ответа.
Параметры
- строка|массив
$url - URL для запроса.
- массив
$dataнеобязательно [] - Данные для запроса.
Исключения
PHPUnit\Exceptionsession()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-сервера.
Параметры
- булево
$enable - Включить/выключить использование стека HTTP.
viewVariable()source public
viewVariable( string $name )
Получает переменную представления по имени.
Если переменная представления не существует, возвращается null.
Параметры
- строка
$name - Переменная представления для получения.
Возвращает
смешанныйПеременную представления, если она задана.
Методы, унаследованные от Cake\TestSuite\TestCase
_assertAttributes()source protected
_assertAttributes( array $assertions , string $string , boolean $fullDebug = false , array|string $regex = '' )
Проверка атрибутов в рамках проверки assertTags().
Параметры
- массив
$assertions - Проверки для выполнения.
- строка
$string - Строка HTML для проверки.
- булево
$fullDebugнеобязательно false - Требуется ли более подробный вывод.
- массив|строка
$regexнеобязательно '' - Полный регулярное выражение из
assertHtml
Возвращает
строка|булево_getTableClassName()source protected
_getTableClassName( string $alias , array $options )
Получает имя класса для таблицы.
Параметры
- строка
$alias - Модель для получения мока.
- массив
$options - Конфигурационные данные для конструктора мока.
Возвращает
строкаИсключения
Cake\ORM\Exception\MissingTableClassException_normalizePath()source protected
_normalizePath( string $path )
Нормализует путь для сравнения.
Параметры
- строка
$path - Путь, разделённый слешем "/".
Возвращает
строкаНормализованный путь, разделённый символом DIRECTORY_SEPARATOR.
assertEventFired()source public
assertEventFired( string $name , Cake\Event\EventManager|null $eventManager = null , string $message = '' )
Проверяет, что глобальное событие было вызвано. Для работы этой проверки вы должны отслеживать события в вашем менеджере событий.
Параметры
- строка
$name - Имя события
-
Cake\Event\EventManager|null$eventManagerнеобязательно null - Менеджер событий для проверки, по умолчанию используется глобальный менеджер событий
- строка
$messageнеобязательно '' - Сообщение об ошибке проверки
assertEventFiredWith()source public
assertEventFiredWith( string $name , string $dataKey , string $dataValue , Cake\Event\EventManager|null $eventManager = null , string $message = '' )
Проверка, что событие было вызвано с данными.
Если в качестве третьего аргумента передано значение, оно используется для сравнения со значением в $dataKey.
Параметры
- строка
$name - Имя события
- строка
$dataKey - Ключ данных
- строка
$dataValue - Значение данных
-
Cake\Event\EventManager|null$eventManagerнеобязательно null - Менеджер событий для проверки, по умолчанию используется глобальный менеджер событий
- строка
$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/' ]
Важно: Эта функция очень гибкая относительно пробелов и также принимает любую перестановку порядка атрибутов. Она также допускает пробелы между указанными тегами.
Параметры
- массив
$expected - Массив, см. выше
- строка
$string - Строка HTML/XHTML/XML
- булево
$fullDebugнеобязательно false - Использовать более подробный вывод.
Возвращает
булевоassertNotWithinRange()source protected static
assertNotWithinRange( float $expected , float $result , float $margin , string $message = '' )
Функция совместимости для проверки, что значение не находится в приемлемом диапазоне.
Параметры
- число с плавающей точкой
$expected - число с плавающей точкой
$result - число с плавающей точкой
$margin - Диапазон принятия
- строка
$messageнеобязательно '' - Текст, отображаемый, если проверка не пройдена
assertPathEquals()source protected static
assertPathEquals( string $expected , string $result , string $message = '' )
Функция совместимости для проверки путей.
Параметры
- строка
$expected - строка
$result - строка
$messageнеобязательно '' - Текст, отображаемый, если проверка не пройдена
assertTags()source public deprecated
assertTags( string $string , array $expected , boolean $fullDebug = false )
Проверка тегов HTML.
Устарело
3.0. Используйте assertHtml() вместо этого.Параметры
- строка
$string - Строка HTML/XHTML/XML
- массив
$expected - Массив, см. выше
- булево
$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
$messageнеобязательно '' - Сообщение для использования при ошибке.
assertTextEquals()source public
assertTextEquals( string $expected , string $result , string $message = '' )
Проверка равенства текста, игнорируя различия в новой строке. Полезно для выполнения кроссплатформенных тестов блоков текста.
Параметры
- string
$expected - Ожидаемое значение.
- string
$result - Фактическое значение.
- string
$messageнеобязательно '' - Сообщение для использования при ошибке.
assertTextNotContains()source public
assertTextNotContains( string $needle , string $haystack , string $message = '' , boolean $ignoreCase = false )
Утверждение, что текст не содержит другой текст, игнорируя различия в новой строке. Полезно для выполнения кроссплатформенных тестов блоков текста.
Параметры
- string
$needle - Строка для поиска.
- string
$haystack - Строка, в которой нужно искать.
- string
$messageнеобязательно '' - Сообщение для отображения при ошибке.
- boolean
$ignoreCaseнеобязательно false - Указывает, должен ли поиск быть регистрозависимым.
assertTextNotEquals()source public
assertTextNotEquals( string $expected , string $result , string $message = '' )
Проверка равенства текста, игнорируя различия в новой строке. Полезно для выполнения кроссплатформенных тестов блоков текста.
Параметры
- string
$expected - Ожидаемое значение.
- string
$result - Фактическое значение.
- string
$messageнеобязательно '' - Сообщение для использования при ошибке.
assertTextStartsNotWith()source public
assertTextStartsNotWith( string $prefix , string $string , string $message = '' )
Утверждает, что строка не начинается с заданного префикса, игнорируя различия в новой строке. Полезно для выполнения кроссплатформенных тестов блоков текста.
Параметры
- string
$prefix - Префикс, который не должен быть найден.
- string
$string - Строка для поиска.
- string
$messageнеобязательно '' - Сообщение для использования при ошибке.
assertTextStartsWith()source public
assertTextStartsWith( string $prefix , string $string , string $message = '' )
Утверждает, что строка начинается с заданного префикса, игнорируя различия в новой строке. Полезно для выполнения кроссплатформенных тестов блоков текста.
Параметры
- string
$prefix - Префикс, который нужно проверить.
- string
$string - Строка для поиска.
- string
$messageнеобязательно '' - Сообщение для использования при ошибке.
assertWithinRange()source protected static
assertWithinRange( float $expected , float $result , float $margin , string $message = '' )
Функция совместимости для проверки, находится ли значение в допустимом диапазоне.
Параметры
- float
$expected - float
$result - float
$margin - Диапазон допустимых значений.
- string
$messageнеобязательно '' - Текст для отображения, если утверждение неверно.
deprecated()source public
deprecated( callable $callable )
Вспомогательный метод для проверки методов устаревания.
Параметры
- callable
$callable - Вызываемая функция, которая получит утверждения.
getMockForModel()source public
getMockForModel( string $alias , array $methods = [] , array $options = [] )
Моделирование модели, сохранение фикстур и ассоциации таблиц.
Параметры
- string
$alias - Модель для получения модели-заглушки.
- array
$methodsнеобязательно [] - Список методов для моделирования.
- array
$optionsнеобязательно [] - Данные конфигурации для конструктора заглушки.
Возвращает
Cake\ORM\Table|PHPUnit_Framework_MockObject_MockObjectИсключения
Cake\ORM\Exception\MissingTableClassExceptionloadFixtures()source public
loadFixtures( )
Выбирает, какие фикстуры загрузить для данного теста.
Каждый параметр — имя модели, соответствующее фикстуре, например, 'Posts', 'Authors' и т. д. Если не передавать параметров, будут загружены все фикстуры в тестовом случае.
Исключения
ExceptionЕсли менеджер фикстур недоступен.
См. также
\Cake\TestSuite\TestCase::$autoFixturessetAppNamespace()source public static
setAppNamespace( string $appNamespace = 'TestApp' )
Установить пространство имен приложения.
Параметры
- string
$appNamespaceнеобязательно 'TestApp' - Пространство имен приложения, по умолчанию "TestApp".
skipIf()source public
skipIf( boolean $shouldSkip , string $message = '' )
Переопределяет SimpleTestCase::skipIf для предоставления булевого значения возвращаемого значения.
Параметры
- boolean
$shouldSkip - Указывает, должен ли тест быть пропущен.
- string
$messageнеобязательно '' - Сообщение для отображения.
Возвращает
booleanskipUnless()source protected
skipUnless( boolean $condition , string $message = '' )
Функция совместимости для пропуска.
Параметры
- boolean
$condition - Условие для запуска пропуска.
- string
$messageнеобязательно '' - Сообщение для пропуска.
Возвращает
booleanwithErrorReporting()source public
withErrorReporting( integer $errorLevel , callable $callable )
Вспомогательный метод для тестов, которым требуется использовать error_reporting()
Параметры
- целое число
$errorLevel - значение error_reporting(), которое необходимо использовать
- вызываемый объект
$callable - вызываемый объект-функция, который будет получать утверждения
Методы, используемые из Cake\Utility\CookieCryptTrait
_checkCipher()source protected
_checkCipher( string $encrypt )
Вспомогательный метод для проверки имен шифров шифрования.
Параметры
- строка
$encrypt - Имя шифра.
Исключение
RuntimeExceptionПри предоставлении недопустимого шифра.
_decode()source protected
_decode( string $value , string|false $encrypt , string|null $key )
Декодирует и расшифровывает одно значение.
Параметры
- строка
$value - Значение для декодирования и расшифровки.
- строка|ложь
$encrypt - Шифр шифрования для использования.
- строка|null
$key - Используется в качестве криптографической соли, если указано.
Возвращает
строка|массивДекодированные значения.
_decrypt()source protected
_decrypt( array $values , string|boolean $mode , string|null $key = null )
Расшифровывает $value, используя метод public $type в классе Security.
Параметры
- массив
$values - Значения для расшифровки
- строка|булево
$mode - Режим шифрования
- строка|null
$keyнеобязательно null - Используется в качестве криптографической соли, если указано.
Возвращает
строка|массивРасшифрованные значения
_encrypt()source protected
_encrypt( string $value , string|boolean $encrypt , string|null $key = null )
Шифрует $value, используя метод public $type в классе Security.
Параметры
- строка
$value - Значение для шифрования
- строка|булево
$encrypt Режим шифрования для использования. Ложь отключает шифрование.
- строка|null
$keyнеобязательно null - Используется в качестве криптографической соли, если указано.
Возвращает
строкаЗакодированные значения
_explode()source protected
_explode( string $string )
Метод explode для возвращения массива из строки, установленной в CookieComponent::_implode(). Поддерживает обратную совместимость с чтением из 1.x CookieComponent::_implode().
Параметры
- строка
$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необязательно [] Список полей, исключаемых из проверки полей.
Возвращает
массивДанные токена.
Методы, используемые из Cake\ORM\Locator\LocatorAwareTrait
getTableLocator()source public
getTableLocator( )
Получает локатор таблицы.
Возвращает
Cake\ORM\Locator\LocatorInterfacesetTableLocator()source public
setTableLocator( Cake\ORM\Locator\LocatorInterface $tableLocator )
Устанавливает локатор таблицы.
Параметры
-
Cake\ORM\Locator\LocatorInterface$tableLocator - Экземпляр LocatorInterface.
Возвращает
$this
tableLocator()source public deprecated
tableLocator( Cake\ORM\Locator\LocatorInterface $tableLocator = null )
Устанавливает локатор таблицы. Если параметры не переданы, он вернет текущий используемый локатор.
Устарело
3.5.0 Используйте getTableLocator()/setTableLocator() вместо этого.Параметры
-
Cake\ORM\Locator\LocatorInterface$tableLocatorнеобязательно null - Экземпляр LocatorInterface.
Возвращает
Cake\ORM\Locator\LocatorInterfaceПодробное описание свойств
$_controllersource
protected Cake\Controller\Controller|null
Контроллер, используемый в последнем запросе.
$_cookieEncryptionKeysource
protected null|строка
$_csrfTokensource
protected логическое
Флаг булевого типа, указывающий, должен ли запрос содержать токен CSRF.
false
$_disableRouterReloadsource
protected логическое
Разрешить отключение перезагрузки маршрутизатора.
false
$_flashMessagessource
protected null|массив
Сохраненные сообщения всплывающего окна перед рендерингом.
$_retainFlashMessagessource
protected логическое
Флаг, указывающий, нужно ли повторно сохранять сообщения flash
false
$_securityTokensource
protected логическое
Флаг, указывающий, нужно ли добавлять токен SecurityComponent в запрос.
false
$_useHttpServersource
protected логическое
Отслеживает, выполняются ли тесты с использованием PSR7 HTTP стека.
false
© 2005–present 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.6/class-Cake.TestSuite.IntegrationTestCase.html