Класс CakeTestCase
Класс CakeTestCase
- PHPUnit_Framework_TestCase
-
CakeTestCase
Прямые подклассы
Пакет: Cake\TestSuite
Авторские права: Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
Лицензия: MIT License
Расположение: Cake/TestSuite/CakeTestCase.php
Краткое описание свойств
-
$_configureprotectedЗначения настроек для восстановления в конце теста.array -
$_pathRestoreprotectedНастройки путей для восстановления в конце теста.array -
$autoFixturespublicarrayПо умолчанию все фикстуры, связанные с этим классом, будут усекаться и перезагружаться после каждого теста. Установите в значение false для ручного управления.
-
$dropTablespublicУправление созданием/удалением таблиц в каждом методе теста.boolean - Класс, отвечающий за управление созданием, загрузкой и удалением фикстур.
$fixtureManagerpublic
Краткое описание методов
- _assertAttributes() protectedПроверка атрибутов в рамках проверки assertTags().
- _buildMock() protectedВозвращает объект-заглушку для указанного класса.
- Функция-обёртка совместимости для assertEquals
- Функция-обёртка совместимости для assertEquals
- Функция-обёртка совместимости для assertIsA
- assertNoErrors() protectedПроверка отсутствия ошибок
- Функция-обёртка совместимости для assertNotRegExp
- Функция-обёртка совместимости для assertNotEquals
- Функция-обёртка совместимости для assertNotEquals
- Функция-обёртка совместимости для assertRegexp
- assertPostConditions() protectedОбъявление конца теста.
- assertPreConditions() protectedОбъявление начала теста.
- Функция-обёртка совместимости для assertSame
- assertTags() public
Принимает массив $expected и генерирует регулярное выражение для соответствия предоставленной строке $string. Примеры для $expected:
- assertTextContains() public
Проверяет, что строка содержит другую строку, игнорируя различия в новой строке. Полезно для выполнения кроссплатформенных тестов блоков текста.
- assertTextEndsNotWith() public
Проверяет, что строка не заканчивается заданным префиксом, игнорируя различия в новой строке. Полезно для выполнения кроссплатформенных тестов блоков текста.
- assertTextEndsWith() public
Проверяет, что строка заканчивается заданным префиксом, игнорируя различия в новой строке. Полезно для выполнения кроссплатформенных тестов блоков текста.
- assertTextEquals() public
Проверка равенства текста, игнорируя различия в новых строках. Полезно для выполнения кроссплатформенных тестов блоков текста.
- assertTextNotContains() public
Проверяет, что текст не содержит другой текст, игнорируя различия в новых строках. Полезно для выполнения кроссплатформенных тестов блоков текста.
- assertTextNotEquals() public
Проверка равенства текста, игнорируя различия в новых строках. Полезно для выполнения кроссплатформенных тестов блоков текста.
- assertTextStartsNotWith() public
Проверяет, что строка не начинается с заданного префикса, игнорируя различия в новых строках. Полезно для выполнения кроссплатформенных тестов блоков текста.
- assertTextStartsWith() public
Проверяет, что строка начинается с заданного префикса, игнорируя различия в новых строках. Полезно для выполнения кроссплатформенных тестов блоков текста.
- Функция совместимости для проверки, находится ли значение в приемлемом диапазоне
- См. CakeTestSuiteDispatcher::date()
- endTest() publicВызывается, когда метод тестового случая был выполнен (переопределять при необходимости).
- expectError() protectedФункция-обёртка совместимости для setExpectedException
- expectException() publicФункция-обёртка совместимости для setExpectedException
- getMock() publicВозвращает объект-заглушку для указанного класса.
- getMockForModel() publicЗаглушка модели, поддерживает фикстуры и ассоциации таблиц
- loadFixtures() publicВыбирает фикстуры для загрузки в данный тест
- run() public
Выполняет тестовый случай и собирает результаты в объекте TestResult. Если объект TestResult не передан, будет создан новый. Этот метод выполняется для каждого тестового метода в этом классе
- setUp() public
Настройка тестового случая, резервное копирование значений статических объектов для последующего восстановления. В частности, резервирует содержимое Configure и пути в App, если они еще не были резервными копиями.
- skipIf() publicПереопределяет SimpleTestCase::skipIf для предоставления булевого возвращаемого значения
- skipUnless() protectedФункция совместимости для пропуска.
- startTest() publicВызывается перед началом метода тестового случая (переопределять при необходимости).
- tearDown() publicРазрушение любых статических изменений объекта и их восстановление.
Подробное описание методов
_assertAttributes()source protected
_assertAttributes( array $assertions , string $string )
Проверка атрибутов в рамках проверки assertTags().
Параметры
- массив
$assertions - Проверки для выполнения.
- строка
$string - HTML-строка для проверки.
_buildMock()source protected
_buildMock( string $originalClassName , array $methods array() , array $arguments array() , string $mockClassName '' , boolean $callOriginalConstructor true , boolean $callOriginalClone true , boolean $callAutoload true )
Возвращает объект-мока для указанного класса.
Устаревшее
ИспользуйтеgetMockBuilder() или createMock() в новых юнит-тестах.Параметры
- строка
$originalClassName - Имя класса объекта, который должен быть смоделирован.
- массив
$methodsнеобязательно array() По умолчанию все методы данного класса заменяются на тестовый дубликат, который просто возвращает NULL, если не указано возвращаемое значение с помощью will($this->returnValue()), например. Если указан второй (необязательный) параметр, то только методы, имена которых находятся в массиве, заменяются на настраиваемый тестовый дубликат. Поведение других методов не меняется. Передача NULL в качестве параметра означает, что никакие методы не будут заменены.
- массив
$argumentsнеобязательно array() Третий (необязательный) параметр может содержать массив параметров, передаваемый в конструктор исходного класса (который по умолчанию не заменяется на дубликат).
- строка
$mockClassNameнеобязательно '' Четвертый (необязательный) параметр можно использовать для указания имени класса для сгенерированного тестового дубликата.
- логическое
$callOriginalConstructorнеобязательно true Пятый (необязательный) параметр можно использовать для отключения вызова конструктора исходного класса.
- логическое
$callOriginalCloneнеобязательно true Шестой (необязательный) параметр можно использовать для отключения вызова конструктора исходного класса clone.
- логическое
$callAutoloadнеобязательно true Седьмой (необязательный) параметр можно использовать для отключения __autoload() во время генерации класса тестового дубликата.
Возвращает
объектСм. также
https://phpunit.de/manual/current/en/test-doubles.htmlassertEqual()source protected static
assertEqual( mixed $result , mixed $expected , string $message '' )
Функция-обертка совместимости для assertEquals
Устаревшее
3.0.0 Это функция-обертка совместимости для 1.x. Она будет удалена в 3.0Параметры
- смешанный
$result - смешанный
$expected - строка
$messageнеобязательно '' - текст, который будет отображен, если утверждение неверно
assertIdentical()source protected static
assertIdentical( mixed $actual , mixed $expected , string $message '' )
Функция-обертка совместимости для assertEquals
Устаревшее
3.0.0 Это функция-обертка совместимости для 1.x. Она будет удалена в 3.0Параметры
- смешанный
$actual - смешанный
$expected - строка
$messageнеобязательно '' - текст, который будет отображен, если утверждение неверно
assertIsA()source protected static
assertIsA( string $object , string $type , string $message '' )
Функция-обертка совместимости для assertIsA
Устаревшее
3.0.0 Это функция-обертка совместимости для 1.x. Она будет удалена в 3.0Параметры
- строка
$object - строка
$type - строка
$messageнеобязательно ''
assertNoErrors()source protected
assertNoErrors( )
Утверждение об отсутствии ошибок
Устаревшее
3.0.0 Это функция-обертка совместимости для 1.x. Она будет удалена в 3.0assertNoPattern()source protected static
assertNoPattern( mixed $pattern , string $string , string $message '' )
Функция-обертка совместимости для assertNotRegExp
Устаревшее
3.0.0 Это функция-обертка совместимости для 1.x. Она будет удалена в 3.0Параметры
- смешанный
$pattern - регулярное выражение
- строка
$string - текст для сопоставления
- строка
$messageнеобязательно '' - текст, который будет отображен, если утверждение неверно
assertNotEqual()source protected static
assertNotEqual( mixed $result , mixed $expected , string $message '' )
Функция-обертка совместимости для assertNotEquals
Устаревшее
3.0.0 Это функция-обертка совместимости для 1.x. Она будет удалена в 3.0Параметры
- смешанный
$result - смешанный
$expected - строка
$messageнеобязательно '' - текст, который будет отображен, если утверждение неверно
assertNotIdentical()source protected static
assertNotIdentical( mixed $actual , mixed $expected , string $message '' )
Функция-обертка совместимости для assertNotEquals
Устаревшее
3.0.0 Это функция-обертка совместимости для 1.x. Она будет удалена в 3.0Параметры
- смешанный
$actual - смешанный
$expected - строка
$messageнеобязательно '' - текст, который будет отображен, если утверждение неверно
assertPattern()source protected static
assertPattern( mixed $pattern , string $string , string $message '' )
Функция-обертка совместимости для assertRegexp
Устаревшее
3.0.0 Это функция-обертка совместимости для 1.x. Она будет удалена в 3.0Параметры
- смешанный
$pattern - регулярное выражение
- строка
$string - текст для сопоставления
- строка
$messageнеобязательно '' - текст, который будет отображен, если утверждение неверно
assertReference()source protected static
assertReference( mixed $first , mixed $second , string $message '' )
Функция-обертка совместимости для assertSame
Устаревшее
3.0.0 Это функция-обертка совместимости для 1.x. Она будет удалена в 3.0Параметры
- смешанный
$first - смешанный
$second - строка
$messageнеобязательно '' - текст, который будет отображен, если утверждение неверно
assertTags()source public
assertTags( string $string , array $expected , string $fullDebug false )
Принимает массив $expected и генерирует регулярное выражение для сопоставления с предоставленной строкой $string. Примеры $expected:
Проверяет тег ввода с атрибутом name (содержит любое ненулевое значение) и атрибутом id, содержащим 'my-input':
array('input' => array('name', 'id' => 'my-input')) Проверяет два тега p с некоторым текстом в них:
array(
array('p' => true),
'textA',
'/p',
array('p' => true),
'textB',
'/p'
) Также можно указать выражение шаблона как часть значений атрибутов или определяемого тега, если вы предваряете значение preg: и заключаете его в косые черты, например:
array(
array('input' => array('name', 'id' => 'preg:/FieldName\d+/')),
'preg:/My\s+field/'
) Важно: Эта функция очень терпима к пробелам и также принимает любые перестановки порядка атрибутов. Она также позволит пробелам между указанными тегами.
Параметры
- строка
$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 - Указывает, должна ли проверка быть регистрозависимой.
Возвращает
booleanassertTextEndsNotWith()source public
assertTextEndsNotWith( string $suffix , string $string , string $message '' )
Утверждает, что строка не оканчивается заданным префиксом, игнорируя различия в символах новой строки. Полезно для проведения кросс-платформенных тестов блоков текста.
Параметры
- string
$suffix - Суффикс, который не должен быть найден.
- string
$string - Строка для поиска.
- string
$messageнеобязательно '' - Сообщение для использования при ошибке.
Возвращает
booleanassertTextEndsWith()source public
assertTextEndsWith( string $suffix , string $string , string $message '' )
Утверждает, что строка оканчивается заданным префиксом, игнорируя различия в символах новой строки. Полезно для проведения кросс-платформенных тестов блоков текста.
Параметры
- string
$suffix - Суффикс для поиска.
- string
$string - Строка для поиска.
- string
$messageнеобязательно '' - Сообщение для использования при ошибке.
Возвращает
booleanassertTextEquals()source public
assertTextEquals( string $expected , string $result , string $message '' )
Утверждение равенства текста, игнорируя различия в символах новой строки. Полезно для проведения кросс-платформенных тестов блоков текста.
Параметры
- string
$expected - Ожидаемое значение.
- string
$result - Фактическое значение.
- string
$messageнеобязательно '' - Сообщение для использования при ошибке.
Возвращает
booleanassertTextNotContains()source public
assertTextNotContains( string $needle , string $haystack , string $message '' , boolean $ignoreCase false )
Утверждает, что текст не содержит другой текст, игнорируя различия в символах новой строки. Полезно для проведения кросс-платформенных тестов блоков текста.
Параметры
- string
$needle - Строка, которую нужно найти.
- string
$haystack - Строка, в которой нужно искать.
- string
$messageнеобязательно '' - Сообщение для отображения при ошибке.
- boolean
$ignoreCaseнеобязательно false - Указывает, должна ли проверка быть регистрозависимой.
Возвращает
booleanassertTextNotEquals()source public
assertTextNotEquals( string $expected , string $result , string $message '' )
Утверждение равенства текста, игнорируя различия в символах новой строки. Полезно для проведения кросс-платформенных тестов блоков текста.
Параметры
- string
$expected - Ожидаемое значение.
- string
$result - Фактическое значение.
- string
$messageнеобязательно '' - Сообщение для использования при ошибке.
Возвращает
booleanassertTextStartsNotWith()source public
assertTextStartsNotWith( string $prefix , string $string , string $message '' )
Утверждает, что строка не начинается с заданного префикса, игнорируя различия в символах новой строки. Полезно для проведения кросс-платформенных тестов блоков текста.
Параметры
- string
$prefix - Префикс, который не должен быть найден.
- string
$string - Строка для поиска.
- string
$messageнеобязательно '' - Сообщение для использования при ошибке.
Возвращает
booleanassertTextStartsWith()source public
assertTextStartsWith( string $prefix , string $string , string $message '' )
Утверждает, что строка начинается с заданного префикса, игнорируя различия в символах новой строки. Полезно для проведения кросс-платформенных тестов блоков текста.
Параметры
- string
$prefix - Префикс для проверки.
- string
$string - Строка для поиска.
- string
$messageнеобязательно '' - Сообщение для использования при ошибке.
Возвращает
booleanassertWithinMargin()source protected static
assertWithinMargin( mixed $result , mixed $expected , mixed $margin , string $message '' )
Функция совместимости для проверки, находится ли значение в приемлемом диапазоне
Параметры
- mixed
$result - mixed
$expected - mixed
$margin - Диапазон принятия
- string
$messageнеобязательно '' - Текст для отображения, если утверждение неверно
date()source public static
date( string $format 'Y-m-d H:i:s' )
См. CakeTestSuiteDispatcher::date()
Параметры
- string
$formatнеобязательно 'Y-m-d H:i:s' - формат, который будет использоваться.
Возвращает
stringendTest()source public
endTest( string $method )
Вызывается при выполнении метода тестового случая (для переопределения при необходимости).
Параметры
- string
$method - Метод теста, который был выполнен.
expectError()source protected
expectError( mixed $expected false , string $message '' )
Функция-обертка совместимости для setExpectedException
Устарело
3.0.0 Это функция-обертка совместимости для 1.x. Она будет удалена в 3.0Параметры
- mixed
$expectedнеобязательно false - имя исключения или ошибки
- string
$messageнеобязательно '' - текст для отображения, если утверждение неверно
expectException()source public
expectException( mixed $name 'Exception' , string $message '' )
Функция-обертка совместимости для setExpectedException
Устарело
3.0.0 Это функция-обертка совместимости для 1.x. Она будет удалена в 3.0.Параметры
- mixed
$nameнеобязательно 'Exception' - Имя ожидаемого исключения.
- string
$messageнеобязательно '' - текст для отображения, если утверждение неверно
getMock()source public
getMock( string $originalClassName , array $methods array() , array $arguments array() , string $mockClassName '' , boolean $callOriginalConstructor true , boolean $callOriginalClone true , boolean $callAutoload true , boolean $cloneArguments false , boolean $callOriginalMethods false , string $proxyTarget null )
Возвращает объект-заглушку для указанного класса.
Устарело
ИспользуйтеgetMockBuilder() или createMock() в новых юнит-тестах.Параметры
- строка
$originalClassName - Имя класса объекта, который нужно смоделировать.
- массив
$methodsнеобязательный array() По умолчанию все методы данного класса заменяются на заглушку, которая просто возвращает NULL, если не задано возвращаемое значение с помощью will($this->returnValue()), например. При указании второго (необязательного) параметра, заглушки будут созданы только для методов, имена которых содержатся в массиве. Поведение других методов не изменится. Передача NULL в качестве параметра означает, что методы не будут заменены.
- массив
$argumentsнеобязательный array() Третий (необязательный) параметр может содержать массив параметров, который передается в конструктор исходного класса (который по умолчанию не заменяется на заглушку).
- строка
$mockClassNameнеобязательный '' Четвертый (необязательный) параметр может использоваться для указания имени класса для сгенерированной заглушки.
- логическое
$callOriginalConstructorнеобязательный true Пятый (необязательный) параметр может использоваться для отключения вызова конструктора исходного класса.
- логическое
$callOriginalCloneнеобязательный true Шестой (необязательный) параметр может использоваться для отключения вызова конструктора исходного класса для клонирования.
- логическое
$callAutoloadнеобязательный true Седьмой (необязательный) параметр может быть использован для отключения __autoload() при генерации класса-заглушки.
- логическое
$cloneArgumentsнеобязательный false - Не поддерживается.
- логическое
$callOriginalMethodsнеобязательный false - Не поддерживается.
- строка
$proxyTargetнеобязательный null - Не поддерживается.
Возвращает
объектИсключения
InvalidArgumentExceptionКогда установлены не поддерживаемые параметры.
См. также
https://phpunit.de/manual/current/en/test-doubles.htmlgetMockForModel()source public
getMockForModel( string $model , mixed $methods array() , array $config array() )
Имитирует модель, сохраняет фикстуры и ассоциации таблиц
Параметры
- строка
$model - Модель, для которой нужно создать заглушку.
- смешанный
$methodsнеобязательный array() - Список методов для имитации
- массив
$configнеобязательный array() - Данные конфигурации для конструктора заглушки.
Возвращает
ModelИсключения
MissingModelExceptionloadFixtures()source public
loadFixtures( )
Выбирает, какие фикстуры загружать для данного теста
Каждый параметр — имя модели, соответствующей фикстуре, например, 'Post', 'Author' и т. д.
Исключения
Exceptionесли менеджер фикстур недоступен.
См. также
CakeTestCase::$autoFixturesrun()source public
run( PHPUnit_Framework_TestResult $result null )
Выполняет тестовый случай и собирает результаты в объекте TestResult. Если объект TestResult не передан, будет создан новый. Этот метод выполняется для каждого тестового метода в этом классе
Параметры
- PHPUnit_Framework_TestResult
$resultнеобязательный null - Объект результата теста
Возвращает
PHPUnit_Framework_TestResultИсключения
InvalidArgumentExceptionsetUp()source public
setUp( )
Настройка тестового случая, сохранение значений статических объектов для их последующего восстановления. В частности, сохраняет содержимое Configure и пути в App, если они еще не были сохранены.
skipIf()source public
skipIf( boolean $shouldSkip , string $message '' )
Переопределяет SimpleTestCase::skipIf для предоставления булевого значения возврата
Параметры
- логическое
$shouldSkip - Определяет, нужно ли пропустить тест.
- строка
$messageнеобязательный '' - Сообщение для отображения.
Возвращает
логическоеskipUnless()source protected
skipUnless( boolean $condition , string $message '' )
Функция совместимости для пропуска.
Параметры
- логическое
$condition - Условие, которое вызывает пропуск
- строка
$messageнеобязательный '' - Сообщение для пропуска
Возвращает
логическоеstartTest()source public
startTest( string $method )
Вызывается, когда метод тестового случая вот-вот начнется (для переопределения при необходимости.)
Параметры
- строка
$method - Тестовый метод, который вот-вот будет выполнен.
tearDown()source public
tearDown( )
Разборка любых изменений статических объектов и их восстановление.
Подробное описание свойств
$autoFixturessource
public массив
По умолчанию все фикстуры, прикрепленные к этому классу, будут обнуляться и перезагружаться после каждого теста. Установите значение в false, чтобы обработать вручную
true
$dropTablessource
public логическое
Управление созданием/удалением таблиц в каждом тестовом методе.
Установите значение в false, чтобы избежать удаления таблиц, если они уже существуют между каждым тестовым методом. Таблицы все равно будут удалены в конце выполнения каждого тестового исполнителя.
true
$fixtureManagersource
public CakeFixtureManager
Класс, отвечающий за управление созданием, загрузкой и удалением фикстур
null
© 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/2.10/class-CakeTestCase.html