Class ControllerTestCase

__callsource public

__call( string $name , array $arguments )

Used to enable calling ControllerTestCase::testAction() without the testing framework thinking that it's a test case

Parameters

string $name

The name of the function

array $arguments

Array of arguments

Returns

mixed
The return of _testAction.

Throws

BadMethodCallException
when you call methods that don't exist.

_testActionsource protected

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

Lets you do functional tests of a controller action.

Options:

• data Will be used as the request data. If the method is GET, data will be used a GET params. If the method is POST, it will be used as POST data. By setting $options['data'] to a string, you can simulate XML or JSON payloads to your controllers allowing you to test REST webservices.
• method POST or GET. Defaults to POST.
• return Specify the return type you want. Choose from: - vars Get the set view variables. - view Get the rendered view, without a layout. - contents Get the rendered view including the layout. - result Get the return value of the controller action. Useful for testing requestAction methods.

Parameters

string|array $url

The URL to test.

array $options optional array()

See options

Returns

mixed
The specified return type.

Triggers

ControllerTestCase $Dispatch, array('request' => $request)

generatesource public

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

Generates a mocked controller and mocks any classes passed to $mocks. By default, _stop() is stubbed as is sending the response headers, so to not interfere with testing.

Mocks:

• methods Methods to mock on the controller. _stop() is mocked by default
• models Models to mock. Models are added to the ClassRegistry so any time they are instantiated the mock will be created. Pass as key value pairs with the value being specific methods on the model to mock. If true or no value is passed, the entire model will be mocked.
• components Components to mock. Components are only mocked on this controller and not within each other (i.e., components on components)

Parameters

string $controller

Controller name

array $mocks optional array()

List of classes and methods to mock

Returns

Controller
Mocked controller

Throws

MissingControllerException
When controllers could not be created.
MissingComponentException
When components could not be created.

_assertAttributessource protected

_assertAttributes( array $assertions , string $string )

Check the attributes as part of an assertTags() check.

Parameters

array $assertions

Assertions to run.

string $string

The HTML string to check.

assertEqualsource protected static

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

Compatibility wrapper function for assertEquals

Deprecated

3.0.0 This is a compatiblity wrapper for 1.x. It will be removed in 3.0

Parameters

mixed $result

mixed $expected

string $message optional ''

the text to display if the assertion is not correct

assertIdenticalsource protected static

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

Compatibility wrapper function for assertEquals

Deprecated

3.0.0 This is a compatiblity wrapper for 1.x. It will be removed in 3.0

Parameters

mixed $actual

mixed $expected

string $message optional ''

the text to display if the assertion is not correct

assertIsAsource protected static

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

Compatibility wrapper for assertIsA

Deprecated

3.0.0 This is a compatiblity wrapper for 1.x. It will be removed in 3.0

Parameters

string $object

string $type

string $message optional ''

assertNoErrorssource protected

assertNoErrors( )

assert no errors

Deprecated

3.0.0 This is a compatiblity wrapper for 1.x. It will be removed in 3.0

assertNoPatternsource protected static

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

Compatibility wrapper function for assertNotRegExp

Deprecated

3.0.0 This is a compatiblity wrapper for 1.x. It will be removed in 3.0

Parameters

mixed $pattern

a regular expression

string $string

the text to be matched

string $message optional ''

the text to display if the assertion is not correct

assertNotEqualsource protected static

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

Compatibility wrapper function for assertNotEquals

Deprecated

3.0.0 This is a compatiblity wrapper for 1.x. It will be removed in 3.0

Parameters

mixed $result

mixed $expected

string $message optional ''

the text to display if the assertion is not correct

assertNotIdenticalsource protected static

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

Compatibility wrapper function for assertNotEquals

Deprecated

3.0.0 This is a compatiblity wrapper for 1.x. It will be removed in 3.0

Parameters

mixed $actual

mixed $expected

string $message optional ''

the text to display if the assertion is not correct

assertPatternsource protected static

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

Compatibility wrapper function for assertRegexp

Deprecated

3.0.0 This is a compatiblity wrapper for 1.x. It will be removed in 3.0

Parameters

mixed $pattern

a regular expression

string $string

the text to be matched

string $message optional ''

the text to display if the assertion is not correct

assertPostConditionssource protected

assertPostConditions( )

Announces the end of a test.

assertPreConditionssource protected

assertPreConditions( )

Announces the start of a test.

assertReferencesource protected static

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

Compatibility wrapper function for assertSame

Deprecated

3.0.0 This is a compatiblity wrapper for 1.x. It will be removed in 3.0

Parameters

mixed $first

mixed $second

string $message optional ''

the text to display if the assertion is not correct

assertTagssource public

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

Takes an array $expected and generates a regex from it to match the provided $string. Samples for $expected:

Checks for an input tag with a name attribute (contains any non-empty value) and an id attribute that contains 'my-input':

array('input' => array('name', 'id' => 'my-input'))

Checks for two p elements with some text in them:

array(
  array('p' => true),
  'textA',
  '/p',
  array('p' => true),
  'textB',
  '/p'
)

You can also specify a pattern expression as part of the attribute values, or the tag being defined, if you prepend the value with preg: and enclose it with slashes, like so:

array(
  array('input' => array('name', 'id' => 'preg:/FieldName\d+/')),
  'preg:/My\s+field/'
)

Important: This function is very forgiving about whitespace and also accepts any permutation of attribute order. It will also allow whitespace between specified tags.

Parameters

string $string

An HTML/XHTML/XML string

array $expected

An array, see above

string $fullDebug optional false

Whether or not more verbose output should be used.

Returns

boolean
bool

assertTextContainssource public

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

Assert that a string contains another string, ignoring differences in newlines. Helpful for doing cross platform tests of blocks of text.

Parameters

string $needle

The string to search for.

string $haystack

The string to search through.

string $message optional ''

The message to display on failure.

boolean $ignoreCase optional false

Whether or not the search should be case-sensitive.

Returns

boolean
bool

assertTextEndsNotWithsource public

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

Asserts that a string ends not with a given prefix, ignoring differences in newlines. Helpful for doing cross platform tests of blocks of text.

Parameters

string $suffix

The suffix to not find.

string $string

The string to search.

string $message optional ''

The message to use for failure.

Returns

boolean
bool

assertTextEndsWithsource public

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

Asserts that a string ends with a given prefix, ignoring differences in newlines. Helpful for doing cross platform tests of blocks of text.

Parameters

string $suffix

The suffix to find.

string $string

The string to search.

string $message optional ''

The message to use for failure.

Returns

boolean
bool

assertTextEqualssource public

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

Assert text equality, ignoring differences in newlines. Helpful for doing cross platform tests of blocks of text.

Parameters

string $expected

The expected value.

string $result

The actual value.

string $message optional ''

message The message to use for failure.

Returns

boolean
bool

assertTextNotContainssource public

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

Assert that a text doesn't contain another text, ignoring differences in newlines. Helpful for doing cross platform tests of blocks of text.

Parameters

string $needle

The string to search for.

string $haystack

The string to search through.

string $message optional ''

The message to display on failure.

boolean $ignoreCase optional false

Whether or not the search should be case-sensitive.

Returns

boolean
bool

assertTextNotEqualssource public

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

Assert text equality, ignoring differences in newlines. Helpful for doing cross platform tests of blocks of text.

Parameters

string $expected

The expected value.

string $result

The actual value.

string $message optional ''

The message to use for failure.

Returns

boolean
bool

assertTextStartsNotWithsource public

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

Asserts that a string starts not with a given prefix, ignoring differences in newlines. Helpful for doing cross platform tests of blocks of text.

Parameters

string $prefix

The prefix to not find.

string $string

The string to search.

string $message optional ''

The message to use for failure.

Returns

boolean
bool

assertTextStartsWithsource public

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

Asserts that a string starts with a given prefix, ignoring differences in newlines. Helpful for doing cross platform tests of blocks of text.

Parameters

string $prefix

The prefix to check for.

string $string

The string to search in.

string $message optional ''

The message to use for failure.

Returns

boolean
bool

assertWithinMarginsource protected static

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

Compatibility function to test if value is between an acceptable range

Parameters

mixed $result

mixed $expected

mixed $margin

the rage of acceptation

string $message optional ''

the text to display if the assertion is not correct

datesource public static

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

See CakeTestSuiteDispatcher::date()

Parameters

string $format optional 'Y-m-d H:i:s'

format to be used.

Returns

string
string

endTestsource public

endTest( string $method )

Called when a test case method has been executed (to be overridden when needed.)

Parameters

string $method

Test method about that was executed.

expectErrorsource protected

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

Compatibility wrapper function for setExpectedException

Deprecated

3.0.0 This is a compatiblity wrapper for 1.x. It will be removed in 3.0

Parameters

mixed $expected optional false

the name of the Exception or error

string $message optional ''

the text to display if the assertion is not correct

expectExceptionsource protected

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

Compatibility wrapper function for setExpectedException

Deprecated

3.0.0 This is a compatibility wrapper for 1.x. It will be removed in 3.0.

Parameters

mixed $name optional 'Exception'

The name of the expected Exception.

string $message optional ''

the text to display if the assertion is not correct

getMockForModelsource public

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

Mock a model, maintain fixtures and table association

Parameters

string $model

The model to get a mock for.

mixed $methods optional array()

The list of methods to mock

array $config optional array()

The config data for the mock's constructor.

Returns

Model
Model

Throws

MissingModelException
MissingModelException

loadFixturessource public

loadFixtures( )

Chooses which fixtures to load for a given test

Each parameter is a model name that corresponds to a fixture, i.e. 'Post', 'Author', etc.

Throws

Exception
when no fixture manager is available.

See

CakeTestCase::$autoFixtures

runsource public

run( PHPUnit_Framework_TestResult $result null )

Runs the test case and collects the results in a TestResult object. If no TestResult object is passed a new one will be created. This method is run for each test method in this class

Parameters

PHPUnit_Framework_TestResult $result optional null

The test result object

Returns

PHPUnit_Framework_TestResult
PHPUnit_Framework_TestResult

Throws

InvalidArgumentException
InvalidArgumentException

setUpsource public

setUp( )

Setup the test case, backup the static object values so they can be restored. Specifically backs up the contents of Configure and paths in App if they have not already been backed up.

skipIfsource public

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

Overrides SimpleTestCase::skipIf to provide a boolean return value

Parameters

boolean $shouldSkip

Whether or not the test should be skipped.

string $message optional ''

The message to display.

Returns

boolean
bool

skipUnlesssource protected

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

Compatibility function for skipping.

Parameters

boolean $condition

Condition to trigger skipping

string $message optional ''

Message for skip

Returns

boolean
bool

startTestsource public

startTest( string $method )

Called when a test case method is about to start (to be overridden when needed.)

Parameters

string $method

Test method about to get executed.

tearDownsource public

tearDown( )

teardown any static object changes and restore them.

false

true

null

null

null

true

null

null

null

array()

array()

true

true

null