Класс ControllerTestCase

__callисточник public

__call( string $name , array $arguments )

Используется для вызова ControllerTestCase::testAction() без того, чтобы фреймворк тестирования воспринимал его как тестовый случай

Параметры

строка $name

Имя функции

массив $arguments

Массив аргументов

Возвращает

mixed
Результат _testAction.

Исключения

BadMethodCallException
при вызове несуществующих методов.

_testActionисточник protected

_testAction( string|array $url , array $options array() )

Позволяет проводить функциональные тесты действия контроллера.

Параметры:

• data Будет использоваться в качестве данных запроса. Если метод method - GET, данные будут использоваться как параметры GET. Если метод method - POST, они будут использоваться как данные POST. Установив $options['data'] в строку, вы можете имитировать XML или JSON запросы к контроллерам, позволяя вам тестировать REST веб-сервисы.
• method POST или GET. По умолчанию POST.
• return Укажите желаемый тип возвращаемого значения. Выбор: - vars Получить установленные переменные представления. - view Получить отрисованное представление без макета. - contents Получить отрисованное представление, включая макет. - result Получить возвращаемое значение действия контроллера. Полезно для тестирования методов requestAction.

Параметры

строка|массив $url

URL для тестирования.

массив $options необязательно массив()

См. параметры

Возвращает

mixed
Указанный тип возвращаемого значения.

Вызывает

ControllerTestCase $Dispatch, массив('request' => $request)

generateисточник public

generate( string $controller , array $mocks array() )

Генерирует смокированный контроллер и имитирует любые классы, переданные в $mocks. По умолчанию _stop() имитируется, как и отправка заголовков ответа, чтобы не мешать тестированию.

Имитация:

• methods Методы для имитации контроллера. _stop() имитируется по умолчанию
• models Модели для имитации. Модели добавляются в ClassRegistry, поэтому всякий раз, когда они будут созданы, будет создана имитация. Передавайте в виде пар ключ-значение, где значение — это конкретные методы модели для имитации. Если true или нет значения, вся модель будет имитироваться.
• components Компоненты для имитации. Компоненты имитируются только в этом контроллере и не внутри друг друга (т.е. компоненты в компонентах)

Параметры

строка $controller

Имя контроллера

массив $mocks необязательно массив()

Список классов и методов для имитации

Возвращает

Controller
Смокированный контроллер

Исключения

MissingControllerException
Когда контроллеры не могут быть созданы.
MissingComponentException
Когда компоненты не могут быть созданы.

_assertAttributesисточник protected

_assertAttributes( array $assertions , string $string )

Проверка атрибутов в рамках проверки assertTags().

Параметры

массив $assertions

Тесты для выполнения.

строка $string

Строка HTML для проверки.

assertEqualисточник protected статический

assertEqual( mixed $result , mixed $expected , string $message '' )

Функция-обертка для совместимости с assertEquals

Устарело

3.0.0 Это функция-обертка для совместимости с 1.x. Она будет удалена в 3.0

Параметры

смешанный $result

смешанный $expected

строка $message необязательно ''

текст, который будет отображаться, если проверка не пройдёт

assertIdenticalисточник protected статический

assertIdentical( mixed $actual , mixed $expected , string $message '' )

Функция-обертка для совместимости с assertEquals

Устарело

3.0.0 Это функция-обертка для совместимости с 1.x. Она будет удалена в 3.0

Параметры

смешанный $actual

смешанный $expected

строка $message необязательно ''

текст, который будет отображаться, если проверка не пройдёт

assertIsAисточник protected статический

assertIsA( string $object , string $type , string $message '' )

Функция-обертка для assertIsA

Устарело

3.0.0 Это функция-обертка для совместимости с 1.x. Она будет удалена в 3.0

Параметры

строка $object

строка $type

строка $message необязательно ''

assertNoErrorsисточник protected

assertNoErrors( )

Отсутствие ошибок

Устарело

3.0.0 Это функция-обертка для совместимости с 1.x. Она будет удалена в 3.0

assertNoPatternисточник protected статический

assertNoPattern( mixed $pattern , string $string , string $message '' )

Функция-обертка для assertNotRegExp

Устарело

3.0.0 Это функция-обертка для совместимости с 1.x. Она будет удалена в 3.0

Параметры

смешанный $pattern

регулярное выражение

строка $string

текст, который нужно сопоставить

строка $message необязательно ''

текст, который будет отображаться, если проверка не пройдёт

assertNotEqualисточник protected статический

assertNotEqual( mixed $result , mixed $expected , string $message '' )

Функция-обертка для assertNotEquals

Устарело

3.0.0 Это функция-обертка для совместимости с 1.x. Она будет удалена в 3.0

Параметры

смешанный $result

смешанный $expected

строка $message необязательно ''

текст, который будет отображаться, если проверка не пройдёт

assertNotIdenticalисточник protected статический

assertNotIdentical( mixed $actual , mixed $expected , string $message '' )

Функция-обертка для assertNotEquals

Устарело

3.0.0 Это функция-обертка для совместимости с 1.x. Она будет удалена в 3.0

Параметры

смешанный $actual

смешанный $expected

строка $message необязательно ''

текст, который будет отображаться, если проверка не пройдёт

assertPatternисточник protected статический

assertPattern( mixed $pattern , string $string , string $message '' )

Функция-обертка для assertRegexp

Устарело

3.0.0 Это функция-обертка для совместимости с 1.x. Она будет удалена в 3.0

Параметры

смешанный $pattern

регулярное выражение

строка $string

текст, который нужно сопоставить

строка $message необязательно ''

текст, который будет отображаться, если проверка не пройдёт

assertPostConditionssource protected

assertPostConditions( )

Объявляет окончание теста.

assertPreConditionssource protected

assertPreConditions( )

Объявляет начало теста.

assertReferencesource protected static

assertReference( mixed $first , mixed $second , string $message '' )

Функция-обёртка для assertSame для обеспечения совместимости

Устаревшее

3.0.0 Это функция-обёртка для обеспечения совместимости с версиями 1.x. Она будет удалена в версии 3.0

Параметры

mixed $first

mixed $second

string $message необязательно ''

текст, отображаемый, если утверждение неверно

assertTagssource public

assertTags( string $string , array $expected , string $fullDebug false )

Принимает массив $expected и генерирует регулярное выражение для сопоставления с заданной строкой $string. Примеры для $expected:

Проверяет наличие тега input с атрибутом 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 $string

Строка HTML/XHTML/XML

array $expected

Массив, см. выше

string $fullDebug необязательно false

Указывает, использовать ли более подробный вывод.

Возвращает

boolean
bool

assertTextContainssource public

assertTextContains( string $needle , string $haystack , string $message '' , boolean $ignoreCase false )

Проверяет, что строка содержит другую строку, игнорируя различия в разделителях строк. Полезно для проведения кросс-платформенных тестов блоков текста.

Параметры

string $needle

Строка для поиска.

string $haystack

Строка для поиска в ней.

string $message необязательно ''

Сообщение для отображения при ошибке.

boolean $ignoreCase необязательно false

Указывает, должен ли поиск быть регистрозависимым.

Возвращает

boolean
bool

assertTextEndsNotWithsource public

assertTextEndsNotWith( string $suffix , string $string , string $message '' )

Проверяет, что строка не заканчивается заданным префиксом, игнорируя различия в разделителях строк. Полезно для проведения кросс-платформенных тестов блоков текста.

Параметры

string $suffix

Суффикс, которого не должно быть.

string $string

Строка для поиска.

string $message необязательно ''

Сообщение для использования при ошибке.

Возвращает

boolean
bool

assertTextEndsWithsource public

assertTextEndsWith( string $suffix , string $string , string $message '' )

Проверяет, что строка заканчивается заданным префиксом, игнорируя различия в разделителях строк. Полезно для проведения кросс-платформенных тестов блоков текста.

Параметры

string $suffix

Суффикс для поиска.

string $string

Строка для поиска.

string $message необязательно ''

Сообщение для использования при ошибке.

Возвращает

boolean
bool

assertTextEqualssource public

assertTextEquals( string $expected , string $result , string $message '' )

Проверка равенства строк, игнорируя различия в разделителях строк. Полезно для проведения кросс-платформенных тестов блоков текста.

Параметры

string $expected

Ожидаемое значение.

string $result

Фактическое значение.

string $message необязательно ''

Сообщение для использования при ошибке.

Возвращает

boolean
bool

assertTextNotContainssource public

assertTextNotContains( string $needle , string $haystack , string $message '' , boolean $ignoreCase false )

Проверка, что текст не содержит другой текст, игнорируя различия в разделителях строк. Полезно для проведения кросс-платформенных тестов блоков текста.

Параметры

string $needle

Строка для поиска.

string $haystack

Строка для поиска в ней.

string $message необязательно ''

Сообщение для отображения при ошибке.

boolean $ignoreCase необязательно false

Указывает, должен ли поиск быть регистрозависимым.

Возвращает

boolean
bool

assertTextNotEqualssource public

assertTextNotEquals( string $expected , string $result , string $message '' )

Проверка равенства строк, игнорируя различия в разделителях строк. Полезно для проведения кросс-платформенных тестов блоков текста.

Параметры

string $expected

Ожидаемое значение.

string $result

Фактическое значение.

string $message необязательно ''

Сообщение для использования при ошибке.

Возвращает

boolean
bool

assertTextStartsNotWithsource public

assertTextStartsNotWith( string $prefix , string $string , string $message '' )

Проверяет, что строка не начинается с заданного префикса, игнорируя различия в разделителях строк. Полезно для проведения кросс-платформенных тестов блоков текста.

Параметры

string $prefix

Префикс, которого не должно быть.

string $string

Строка для поиска.

string $message необязательно ''

Сообщение для использования при ошибке.

Возвращает

boolean
bool

assertTextStartsWithsource public

assertTextStartsWith( string $prefix , string $string , string $message '' )

Проверяет, что строка начинается с заданного префикса, игнорируя различия в разделителях строк. Полезно для проведения кросс-платформенных тестов блоков текста.

Параметры

string $prefix

Префикс для проверки.

string $string

Строка для поиска.

string $message необязательно ''

Сообщение для использования при ошибке.

Возвращает

boolean
bool

assertWithinMarginsource protected static

assertWithinMargin( mixed $result , mixed $expected , mixed $margin , string $message '' )

Функция для проверки, что значение находится в заданном диапазоне

Параметры

mixed $result

mixed $expected

mixed $margin

Диапазон значений

string $message необязательно ''

Сообщение для отображения при ошибке

datesource public static

date( string $format 'Y-m-d H:i:s' )

См. CakeTestSuiteDispatcher::date()

Параметры

string $format необязательно 'Y-m-d H:i:s'

Формат даты.

Возвращает

string
string

endTestsource public

endTest( string $method )

Вызывается, когда метод тестового случая был выполнен (переопределяется при необходимости).

Параметры

строка $method

Метод тестирования, который был выполнен.

expectErrorsource protected

expectError( mixed $expected false , string $message '' )

Функция-обёртка для совместимости с setExpectedException

Устарело

3.0.0 Это функция-обёртка для совместимости с 1.x. Она будет удалена в версии 3.0

Параметры

смешанный $expected необязательно false

имя исключения или ошибки

строка $message необязательно ''

текст, отображаемый, если утверждение неверно

expectExceptionsource protected

expectException( mixed $name 'Exception' , string $message '' )

Функция-обёртка для совместимости с setExpectedException

Устарело

3.0.0 Это функция-обёртка для совместимости с 1.x. Она будет удалена в версии 3.0.

Параметры

смешанный $name необязательно 'Exception'

Имя ожидаемого исключения.

строка $message необязательно ''

текст, отображаемый, если утверждение неверно

getMockForModelsource public

getMockForModel( string $model , mixed $methods array() , array $config array() )

Моделирование модели, поддержание фикстур и ассоциаций таблиц

Параметры

строка $model

Модель, для которой требуется получить заглушку.

смешанный $methods необязательно array()

Список методов для моделирования.

массив $config необязательно array()

Данные конфигурации для конструктора заглушки.

Возвращает

Model
Модель

Использует

MissingModelException
MissingModelException

loadFixturessource public

loadFixtures( )

Выбирает фикстуры для загрузки для данного теста

Каждый параметр — имя модели, соответствующее фикстуре, например, 'Post', 'Author' и т. д.

Использует

Exception
при отсутствии менеджера фикстур.

См. также

CakeTestCase::$autoFixtures

runsource public

run( PHPUnit_Framework_TestResult $result null )

Выполняет тестовый случай и собирает результаты в объекте TestResult. Если объект TestResult не передан, будет создан новый. Этот метод выполняется для каждого метода теста в этом классе.

Параметры

PHPUnit_Framework_TestResult $result необязательно null

Объект результата теста

Возвращает

PHPUnit_Framework_TestResult
PHPUnit_Framework_TestResult

Использует

InvalidArgumentException
InvalidArgumentException

setUpsource public

setUp( )

Настройка тестового случая, резервное копирование значений статических объектов для их последующего восстановления. В частности, создаёт резервную копию содержимого Configure и путей в App, если они ещё не были скопированы.

skipIfsource public

skipIf( boolean $shouldSkip , string $message '' )

Переопределяет SimpleTestCase::skipIf, чтобы обеспечить возвращаемое значение boolean

Параметры

boolean $shouldSkip

Нужно ли пропустить тест.

строка $message необязательно ''

Сообщение для отображения.

Возвращает

boolean
bool

skipUnlesssource protected

skipUnless( boolean $condition , string $message '' )

Функция совместимости для пропуска.

Параметры

boolean $condition

Условие для запуска пропуска

строка $message необязательно ''

Сообщения для пропуска

Возвращает

boolean
bool

startTestsource public

startTest( string $method )

Вызывается, когда метод тестового случая начинает выполняться (переопределяется при необходимости).

Параметры

строка $method

Метод тестирования, который будет выполнен.

tearDownsource public

tearDown( )

Разборка любых статических изменений объекта и их восстановление.

false

true

null

null

null

true

null

null

null

array()

array()

true

true

null