Skip to content

Files

Latest commit

4e3989a · Nov 30, 2021

History

History
308 lines (236 loc) · 8.78 KB

Stub.md

File metadata and controls

308 lines (236 loc) · 8.78 KB

Codeception\Stub

public static make($class, array $params = Array ( ) , $testCase = null)

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', ['name' => 'davert']);

Accepts either name of class or object of that class

<?php
Stub::make(new User, ['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', ['save' => function () { return true; }]);
Stub::make('User', ['save' => true]);

To create a mock, pass current testcase name as last argument:

<?php
Stub::make('User', [
     'save' => \Codeception\Stub\Expected::once()
], $this);
  • template RealInstanceType of object

  • param class-string<RealInstanceType>|RealInstanceType|callable(): class-string<RealInstanceType> $class - A class to be mocked

  • param array $params - properties and methods to set

  • param bool|PHPUnitTestCase $testCase

  • return PHPUnitMockObject&RealInstanceType - mock

  • throws RuntimeException when class does not exist

  • throws Exception

public static factory($class, $num = 1, array $params = Array ( ) )

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

  • param mixed $class
  • throws Exception

public static makeEmptyExcept($class, $method, array $params = Array ( ) , $testCase = null)

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', ['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', ['isValid' => function () { return true; }]);
Stub::makeEmptyExcept('User', 'save', ['isValid' => true]);

To create a mock, pass current testcase name as last argument:

<?php
Stub::makeEmptyExcept('User', 'validate', [
     'save' => \Codeception\Stub\Expected::once()
], $this);
  • template

  • param class-string<RealInstanceType>|RealInstanceType|callable(): class-string<RealInstanceType> $class - A class to be mocked

  • param string $method

  • param array $params

  • param bool|PHPUnitTestCase $testCase

  • return PHPUnitMockObject&RealInstanceType

  • throws Exception

public static makeEmpty($class, array $params = Array ( ) , $testCase = null)

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', ['name' => 'davert']);

Accepts either name of class or object of that class

<?php
Stub::makeEmpty(new User, ['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', ['save' => function () { return true; }]);
Stub::makeEmpty('User', ['save' => true]);

To create a mock, pass current testcase name as last argument:

<?php
Stub::makeEmpty('User', [
     'save' => \Codeception\Stub\Expected::once()
], $this);
  • template RealInstanceType of object

  • param class-string<RealInstanceType>|RealInstanceType|callable(): class-string<RealInstanceType> $class - A class to be mocked

  • param bool|PHPUnitTestCase $testCase

  • return PHPUnitMockObject&RealInstanceType

  • throws Exception

public static copy($obj, array $params = Array ( ) )

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

  • param $obj
  • param array $params
  • return mixed
  • throws Exception

public static construct($class, array $constructorParams = Array ( ) , array $params = Array ( ) , $testCase = null)

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', ['autosave' => false]);
Stub::construct('User', ['autosave' => false], ['name' => 'davert']);

Accepts either name of class or object of that class

<?php
Stub::construct(new User, ['autosave' => false], ['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', [], ['save' => function () { return true; }]);
Stub::construct('User', [], ['save' => true]);

To create a mock, pass current testcase name as last argument:

<?php
Stub::construct('User', [], [
     'save' => \Codeception\Stub\Expected::once()
], $this);
  • template RealInstanceType of object

  • param class-string<RealInstanceType>|RealInstanceType|callable(): class-string<RealInstanceType> $class - A class to be mocked

  • param bool|PHPUnitTestCase $testCase

  • return PHPUnitMockObject&RealInstanceType

  • throws Exception

public static constructEmpty($class, array $constructorParams = Array ( ) , array $params = Array ( ) , $testCase = null)

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', ['autosave' => false]);
Stub::constructEmpty('User', ['autosave' => false], ['name' => 'davert']);

Accepts either name of class or object of that class

<?php
Stub::constructEmpty(new User, ['autosave' => false], ['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', [], ['save' => function () { return true; }]);
Stub::constructEmpty('User', [], ['save' => true]);

To create a mock, pass current testcase name as last argument:

<?php
Stub::constructEmpty('User', [], [
     'save' => \Codeception\Stub\Expected::once()
], $this);
  • template RealInstanceType of object

  • param class-string<RealInstanceType>|RealInstanceType|callable(): class-string<RealInstanceType> $class - A class to be mocked

  • param array $constructorParams

  • param array $params

  • param bool|PHPUnitTestCase $testCase

  • return PHPUnitMockObject&RealInstanceType

  • throws ReflectionException

public static constructEmptyExcept($class, $method, array $constructorParams = Array ( ) , array $params = Array ( ) , $testCase = null)

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', ['autosave' => false], ['name' => 'davert']);

Accepts either name of class or object of that class

<?php
Stub::constructEmptyExcept(new User, 'save', ['autosave' => false], ['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', [], ['save' => function () { return true; }]);
Stub::constructEmptyExcept('User', 'save', [], ['save' => true]);

To create a mock, pass current testcase name as last argument:

<?php
Stub::constructEmptyExcept('User', 'save', [], [
     'save' => \Codeception\Stub\Expected::once()
], $this);
  • template RealInstanceType of object

  • param class-string<RealInstanceType>|RealInstanceType|callable(): class-string<RealInstanceType> $class - A class to be mocked

  • param bool|PHPUnitTestCase $testCase

  • return PHPUnitMockObject&RealInstanceType

  • throws ReflectionException

public static update($mock, array $params)

Replaces properties of current stub

  • param PHPUnitMockObject|object $mock
  • param array $params
  • return object throws LogicException

public static consecutive()

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

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