Codeception\Util\Stub

public static magicMethods### atLeastOnce

static

Checks if a method has been invoked at least one time.

If the number of invocations is 0 it will throw an exception in verify.

<?php
$user = Stub::make(
    'User',
    array(
        'getName' => Stub::atLeastOnce(function() { return 'Davert';}),
        'someMethod' => function() {}
    )
);
$user->getName();
$user->getName();
?>

• param mixed $params

• return StubMarshaler

See source

consecutive

static

Stubbing a method call to return a list of values in the specified order.

<?php
$user = Stub::make('User', array('getName' => Stub::consecutive('david', 'emma', 'sam', 'amy')));
$user->getName(); //david
$user->getName(); //emma
$user->getName(); //sam
$user->getName(); //amy
?>

• return ConsecutiveMap

See source

construct

static

Instantiates a class instance by running constructor. Parameters for constructor passed as second argument Properties and methods can be set in third argument. Even protected and private properties can be set.

<?php
Stub::construct('User', array('autosave' => false));
Stub::construct('User', array('autosave' => false), array('name' => 'davert'));
?>

Accepts either name of class or object of that class

<?php
Stub::construct(new User, array('autosave' => false), array('name' => 'davert'));
?>

To replace method provide it's name as a key in third parameter and it's return value or callback function as parameter

<?php
Stub::construct('User', array(), array('save' => function () { return true; }));
Stub::construct('User', array(), array('save' => true }));
?>

• param mixed $class
• param array $constructorParams
• param array $params

• param bool|\PHPUnit_Framework_TestCase $testCase

• return object

See source

constructEmpty

static

Instantiates a class instance by running constructor with all methods replaced with dummies. Parameters for constructor passed as second argument Properties and methods can be set in third argument. Even protected and private properties can be set.

<?php
Stub::constructEmpty('User', array('autosave' => false));
Stub::constructEmpty('User', array('autosave' => false), array('name' => 'davert'));
?>

Accepts either name of class or object of that class

<?php
Stub::constructEmpty(new User, array('autosave' => false), array('name' => 'davert'));
?>

To replace method provide it's name as a key in third parameter and it's return value or callback function as parameter

<?php
Stub::constructEmpty('User', array(), array('save' => function () { return true; }));
Stub::constructEmpty('User', array(), array('save' => true }));
?>

• param mixed $class
• param array $constructorParams
• param array $params

• param bool|\PHPUnit_Framework_TestCase $testCase

• return object

See source

constructEmptyExcept

static

Instantiates a class instance by running constructor with all methods replaced with dummies, except one. Parameters for constructor passed as second argument Properties and methods can be set in third argument. Even protected and private properties can be set.

<?php
Stub::constructEmptyExcept('User', 'save');
Stub::constructEmptyExcept('User', 'save', array('autosave' => false), array('name' => 'davert'));
?>

Accepts either name of class or object of that class

<?php
Stub::constructEmptyExcept(new User, 'save', array('autosave' => false), array('name' => 'davert'));
?>

To replace method provide it's name as a key in third parameter and it's return value or callback function as parameter

<?php
Stub::constructEmptyExcept('User', 'save', array(), array('save' => function () { return true; }));
Stub::constructEmptyExcept('User', 'save', array(), array('save' => true }));
?>

• param mixed $class
• param string $method
• param array $constructorParams
• param array $params

• param bool|\PHPUnit_Framework_TestCase $testCase

• return object

See source

copy

static

Clones an object and redefines it's properties (even protected and private)

• param $obj

• param array $params

• return mixed

See source

exactly

static

Checks if a method has been invoked a certain amount of times. If the number of invocations exceeds the value it will immediately throw an exception, If the number is less it will later be checked in verify() and also throw an exception.

<?php
$user = Stub::make(
    'User',
    array(
        'getName' => Stub::exactly(3, function() { return 'Davert';}),
        'someMethod' => function() {}
    )
);
$user->getName();
$user->getName();
$user->getName();
?>

• param int $count

• param mixed $params

• return StubMarshaler

See source

factory

static

Creates $num instances of class through Stub::make.

• param mixed $class
• param int $num

• param array $params

• return array

See source

make

static

Instantiates a class without executing a constructor. Properties and methods can be set as a second parameter. Even protected and private properties can be set.

<?php
Stub::make('User');
Stub::make('User', array('name' => 'davert'));
?>

Accepts either name of class or object of that class

<?php
Stub::make(new User, array('name' => 'davert'));
?>

To replace method provide it's name as a key in second parameter and it's return value or callback function as parameter

<?php
Stub::make('User', array('save' => function () { return true; }));
Stub::make('User', array('save' => true }));
?>

• param mixed $class - A class to be mocked
• param array $params - properties and methods to set

• param bool|\PHPUnit_Framework_TestCase $testCase

• return object - mock

• throws \RuntimeException when class does not exist

See source

makeEmpty

static

Instantiates class having all methods replaced with dummies. Constructor is not triggered. Properties and methods can be set as a second parameter. Even protected and private properties can be set.

<?php
Stub::makeEmpty('User');
Stub::makeEmpty('User', array('name' => 'davert'));
?>

Accepts either name of class or object of that class

<?php
Stub::makeEmpty(new User, array('name' => 'davert'));
?>

To replace method provide it's name as a key in second parameter and it's return value or callback function as parameter

<?php
Stub::makeEmpty('User', array('save' => function () { return true; }));
Stub::makeEmpty('User', array('save' => true }));
?>

• param mixed $class
• param array $params

• param bool|\PHPUnit_Framework_TestCase $testCase

• return object

See source

makeEmptyExcept

static

Instantiates class having all methods replaced with dummies except one. Constructor is not triggered. Properties and methods can be replaced. Even protected and private properties can be set.

<?php
Stub::makeEmptyExcept('User', 'save');
Stub::makeEmptyExcept('User', 'save', array('name' => 'davert'));
?>

Accepts either name of class or object of that class

<?php
* Stub::makeEmptyExcept(new User, 'save');
?>

To replace method provide it's name as a key in second parameter and it's return value or callback function as parameter

<?php
Stub::makeEmptyExcept('User', 'save', array('isValid' => function () { return true; }));
Stub::makeEmptyExcept('User', 'save', array('isValid' => true }));
?>

• param mixed $class
• param string $method
• param array $params

• param bool|\PHPUnit_Framework_TestCase $testCase

• return object

See source

never

static

Checks if a method never has been invoked

If method invoked, it will immediately throw an exception.

<?php
$user = Stub::make('User', array('getName' => Stub::never(), 'someMethod' => function() {}));
$user->someMethod();
?>

• param mixed $params

• return StubMarshaler

See source

once

static

Checks if a method has been invoked exactly one time.

If the number is less or greater it will later be checked in verify() and also throw an exception.

<?php
$user = Stub::make(
    'User',
    array(
        'getName' => Stub::once(function() { return 'Davert';}),
        'someMethod' => function() {}
    )
);
$userName = $user->getName();
$this->assertEquals('Davert', $userName);
?>

• param mixed $params

• return StubMarshaler

See source

update

static

Replaces properties of current stub

• param \PHPUnit_Framework_MockObject_MockObject $mock

• param array $params

• return mixed

• throws \LogicException

See source