Класс TestCase
Класс Cake TestCase
- PHPUnit\Framework\TestCase
-
Cake\TestSuite\TestCase использует Cake\ORM\Locator\LocatorAwareTrait
Прямые подклассы
Краткое описание свойств
-
$_configureprotectedЗначения конфигурации для восстановления в конце теста.array -
$_pathRestoreprotectedНастройки путей для восстановления в конце теста.array -
$autoFixturespublicbooleanПо умолчанию все фикстуры, присоединённые к этому классу, будут обнуляться и перезагружаться после каждого теста. Установите это значение в false, чтобы обрабатывать вручную.
-
$dropTablespublicУправление созданием/удалением таблиц в каждом методе теста.boolean - Класс, отвечающий за управление созданием, загрузкой и удалением фикстур.
$fixtureManagerpublic
Наследованные свойства
Краткое описание методов
- _assertAttributes() protectedПроверка атрибутов в рамках проверки assertTags().
- _getTableClassName() protectedПолучение имени класса таблицы.
- _normalizePath() protectedНормализация пути для сравнения.
- assertEventFired() publicУтверждает, что глобальное событие было вызвано. Вы должны отслеживать события в вашем диспетчере событий для работы этой проверки.
- assertEventFiredWith() publicУтверждает, что событие было вызвано с данными.
- assertHtml() publicУтверждает теги HTML.
- Функция совместимости для проверки, что значение не находится в допустимом диапазоне.
- Функция совместимости для проверки путей.
- Утверждает теги HTML.
- assertTextContains() public
Утверждает, что строка содержит другую строку, игнорируя различия в символах новой строки. Полезно для проведения кросс-платформенных тестов блоков текста.
- assertTextEndsNotWith() public
Утверждает, что строка не заканчивается заданным префиксом, игнорируя различия в символах новой строки. Полезно для проведения кросс-платформенных тестов блоков текста.
- assertTextEndsWith() public
Утверждает, что строка заканчивается заданным префиксом, игнорируя различия в символах новой строки. Полезно для проведения кросс-платформенных тестов блоков текста.
- assertTextEquals() public
Утверждает равенство текста, игнорируя различия в символах новой строки. Полезно для проведения кросс-платформенных тестов блоков текста.
- assertTextNotContains() public
Утверждает, что текст не содержит другой текст, игнорируя различия в символах новой строки. Полезно для проведения кросс-платформенных тестов блоков текста.
- assertTextNotEquals() public
Утверждает равенство текста, игнорируя различия в символах новой строки. Полезно для проведения кросс-платформенных тестов блоков текста.
- assertTextStartsNotWith() public
Утверждает, что строка не начинается с заданного префикса, игнорируя различия в символах новой строки. Полезно для проведения кросс-платформенных тестов блоков текста.
- assertTextStartsWith() public
Утверждает, что строка начинается с заданного префикса, игнорируя различия в символах новой строки. Полезно для проведения кросс-платформенных тестов блоков текста.
- Функция совместимости для проверки, что значение находится в допустимом диапазоне.
- clearPlugins() publicОчистка всех плагинов из глобальной коллекции плагинов.
- deprecated() publicВспомогательный метод для проверки методов устаревших методов.
- getMockForModel() publicИмитация модели, сохранение фикстур и ассоциации таблиц.
- loadFixtures() publicВыбор фикстур для загрузки для данного теста.
- loadPlugins() publicЗагрузка плагинов в симулированное приложение.
- removePlugins() publicУдаление плагинов из глобальной коллекции плагинов.
- Установить пространство имён приложения.
- setUp() public
Настройка тестового случая, резервное копирование значений статического объекта для их восстановления. В частности, резервная копия содержимого Configure и путей в App, если они ещё не были резервными копий.
- skipIf() publicПереопределяет SimpleTestCase::skipIf, чтобы предоставить возвращаемое значение boolean.
- skipUnless() protectedФункция совместимости для пропуска.
- tearDown() publicРазборка любых изменений статических объектов и их восстановление.
- withErrorReporting() publicВспомогательный метод для тестов, которым нужно использовать error_reporting().
Подробное описание методов
_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 - Использовать ли более подробный вывод.
Возвращает
booleanassertNotWithinRange()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 устарело
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 )
Проверяет, что строка содержит другую строку, игнорируя различия в новой строке. Полезно для выполнения кросс-платформенных тестов блоков текста.
Параметры
- строка
$needle - Строка для поиска.
- строка
$haystack - Строка для поиска в ней.
- строка
$messageдополнительно '' - Сообщение, отображаемое при ошибке.
- булево
$ignoreCaseдополнительно false - Выполнять ли поиск регистрозависимым образом.
assertTextEndsNotWith()source public
assertTextEndsNotWith( string $suffix , string $string , string $message = '' )
Утверждает, что строка не заканчивается заданным префиксом, игнорируя различия в новой строке. Полезно для выполнения кросс-платформенных тестов блоков текста.
Параметры
- строка
$suffix - Суффикс, который не должен быть найден.
- строка
$string - Строка для поиска.
- строка
$messageдополнительно '' - Сообщение для использования при ошибке.
assertTextEndsWith()source public
assertTextEndsWith( string $suffix , string $string , string $message = '' )
Утверждает, что строка заканчивается заданным префиксом, игнорируя различия в новой строке. Полезно для выполнения кросс-платформенных тестов блоков текста.
Параметры
- строка
$suffix - Суффикс, который должен быть найден.
- строка
$string - Строка для поиска.
- строка
$messageдополнительно '' - Сообщение для использования при ошибке.
assertTextEquals()source public
assertTextEquals( string $expected , string $result , string $message = '' )
Утверждает равенство текста, игнорируя различия в новой строке. Полезно для выполнения кросс-платформенных тестов блоков текста.
Параметры
- строка
$expected - Ожидаемое значение.
- строка
$result - Фактическое значение.
- строка
$messageдополнительно '' - Сообщение для использования при ошибке.
assertTextNotContains()source public
assertTextNotContains( string $needle , string $haystack , string $message = '' , boolean $ignoreCase = false )
Проверяет, что текст не содержит другую строку, игнорируя различия в новой строке. Полезно для выполнения кросс-платформенных тестов блоков текста.
Параметры
- строка
$needle - Строка для поиска.
- строка
$haystack - Строка для поиска в ней.
- строка
$messageдополнительно '' - Сообщение для отображения при ошибке.
- булево
$ignoreCaseдополнительно false - Выполнять ли поиск регистрозависимым образом.
assertTextNotEquals()source public
assertTextNotEquals( string $expected , string $result , string $message = '' )
Утверждает равенство текста, игнорируя различия в новой строке. Полезно для выполнения кросс-платформенных тестов блоков текста.
Параметры
- строка
$expected - Ожидаемое значение.
- строка
$result - Фактическое значение.
- строка
$messageдополнительно '' - Сообщение для использования при ошибке.
assertTextStartsNotWith()source public
assertTextStartsNotWith( string $prefix , string $string , string $message = '' )
Утверждает, что строка не начинается с заданного префикса, игнорируя различия в новой строке. Полезно для выполнения кросс-платформенных тестов блоков текста.
Параметры
- строка
$prefix - Префикс, который не должен быть найден.
- строка
$string - Строка для поиска.
- строка
$messageдополнительно '' - Сообщение для использования при ошибке.
assertTextStartsWith()source public
assertTextStartsWith( string $prefix , string $string , string $message = '' )
Проверяет, что строка начинается с заданного префикса, игнорируя различия в разделителях строк. Полезно для проведения кроссплатформенных тестов блоков текста.
Параметры
- строка
$prefix - Префикс для проверки.
- строка
$string - Строка для поиска.
- строка
$messageнеобязательно '' - Сообщение для использования при ошибке.
assertWithinRange()source protected static
assertWithinRange( float $expected , float $result , float $margin , string $message = '' )
Функция совместимости для проверки, находится ли значение в приемлемом диапазоне.
Параметры
- число с плавающей запятой
$expected - число с плавающей запятой
$result - число с плавающей запятой
$margin - диапазон приемлемости
- строка
$messageнеобязательно '' - текст для отображения, если утверждение неверно
clearPlugins()source public
clearPlugins( )
Очистить все плагины из глобальной коллекции плагинов.
Полезно в методах завершения тестовых случаев.
deprecated()source public
deprecated( callable $callable )
Вспомогательный метод для проверки устаревших методов
Параметры
- вызываемый объект
$callable - вызываемая функция, которая получит утверждения
getMockForModel()source public
getMockForModel( string $alias , array|null $methods = [] , array $options = [] )
Создать макет модели, сохранить фикстуры и связь таблиц
Параметры
- строка
$alias - Модель, для которой требуется макет.
- массив|null
$methodsнеобязательно [] - Список методов для создания макета
- массив
$optionsнеобязательно [] - Конфигурационные данные для конструктора макета.
Возвращает
Cake\ORM\Table|PHPUnit_Framework_MockObject_MockObjectВыбрасывает
Cake\ORM\Exception\MissingTableClassExceptionloadFixtures()source public
loadFixtures( )
Выбор фикстур для загрузки для данного теста
Каждый параметр — это имя модели, соответствующее фикстуре, например, 'Posts', 'Authors' и т. д. Передача без параметров приведет к загрузке всех фикстур в тестовом случае.
Выбрасывает
Exceptionесли менеджер фикстур недоступен.
См. также
\Cake\TestSuite\TestCase::$autoFixturesloadPlugins()source public
loadPlugins( array $plugins = [] )
Загрузка плагинов в симулированное приложение.
Полезно для проверки того, как загрузка/незагрузка плагинов взаимодействует с другими элементами в CakePHP или приложениях.
Параметры
- массив
$pluginsнеобязательно [] - Список плагинов для загрузки.
Возвращает
Cake\Http\BaseApplicationremovePlugins()source public
removePlugins( array $plugins = [] )
Удаление плагинов из глобальной коллекции плагинов.
Полезно в методах завершения тестовых случаев.
Параметры
- массив
$pluginsнеобязательно [] - Список плагинов, которые нужно удалить.
setAppNamespace()source public static
setAppNamespace( string $appNamespace = 'TestApp' )
Установить пространство имен приложения
Параметры
- строка
$appNamespaceнеобязательно 'TestApp' - Пространство имен приложения, по умолчанию "TestApp".
setUp()source public
setUp( )
Настройка тестового случая, резервное копирование значений статических объектов для их последующего восстановления. В частности, сохраняет содержимое Configure и пути в App, если они еще не были скопированы.
skipIf()source public
skipIf( boolean $shouldSkip , string $message = '' )
Переопределяет SimpleTestCase::skipIf для предоставления булевого возвращаемого значения
Параметры
- булево
$shouldSkip - Указывает, следует ли пропускать тест.
- строка
$messageнеобязательно '' - Сообщение для отображения.
Возвращает
booleanskipUnless()source protected
skipUnless( boolean $condition , string $message = '' )
Функция совместимости для пропуска.
Параметры
- булево
$condition - Условие для запуска пропуска
- строка
$messageнеобязательно '' - Сообщение для пропуска
Возвращает
booleantearDown()source public
tearDown( )
разборка любых изменений в статическом объекте и их восстановление.
withErrorReporting()source public
withErrorReporting( integer $errorLevel , callable $callable )
Вспомогательный метод для тестов, которым необходимо использовать error_reporting()
Параметры
- целое число
$errorLevel - значение error_reporting(), которое необходимо использовать
- вызываемый объект
$callable - вызываемая функция, которая получит утверждения
Методы, используемые из 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Подробное описание свойств
$autoFixturessource
public boolean
По умолчанию все фикстуры, прикреплённые к этому классу, будут усекаться и перезагружаться после каждого теста. Установите в значение false, чтобы управлять ими вручную
true
$dropTablessource
public boolean
Управление созданием/удалением таблиц в каждом методе теста.
Если true, таблицы всё равно будут удалены в конце выполнения каждого запуска тестов.
false
$fixtureManagersource
public Cake\TestSuite\Fixture\FixtureManager|null
Класс, отвечающий за управление созданием, загрузкой и удалением фикстур
© 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.7/class-Cake.TestSuite.TestCase.html