Skip to content

Latest commit

 

History

History
98 lines (73 loc) · 2.55 KB

InstanceProxy.md

File metadata and controls

98 lines (73 loc) · 2.55 KB
Raw

AspectMock\Proxy\InstanceProxy

  • Extends AspectMock\Proxy\Verifier

InstanceProxy is a proxy for underlying object, mocked with test::double. A real object can be returned with getObject methods.

<?php
$user1 = new User;
$user2 = test::double($user1);
$user1 instanceof User; // true
$user2 instanceof AspectMock\Proxy\InstanceProxy; // true

$user1 === $user2->getObject(); // true

Contains verification methods and class property that points to ClassProxy.

<?php
$user = new User(['name' => 'davert']);
$user = test::double(new User);
// now $user is a proxy class of user
$this->assertSame('davert', $user->getName()); // success
$user->verifyInvoked('getName'); // success
$this->assertInstanceOf('User', $user); // fail

A class property allows to verify method calls to any instance of this class. Constains a ClassVerifier object.

<?php
$user = test::double(new User);
$user->class->hasMethod('save');
$user->setName('davert');
$user->class->verifyInvoked('setName');

Also, you can get the list of calls for a specific method.

<?php
$user = test::double(new UserModel);
$user->someMethod('arg1', 'arg2');
$user->getCallsForMethod('someMethod') // [ ['arg1', 'arg2'] ]

public getObject()

Returns a real object that is proxified.

  • return mixed

public getCallsForMethod($method)

public verifyInvoked($name, array $params = null)

Verifies a method was invoked at least once. In second argument you can specify with which params method expected to be invoked;

<?php
$user->verifyInvoked('save');
$user->verifyInvoked('setName',['davert']);

public verifyInvokedOnce($name, array $params = null)

Verifies that method was invoked only once.

public verifyInvokedMultipleTimes($name, $times, array $params = null)

Verifies that method was called exactly $times times.

<?php
$user->verifyInvokedMultipleTimes('save',2);
$user->verifyInvokedMultipleTimes('dispatchEvent',3,['before_validate']);
$user->verifyInvokedMultipleTimes('dispatchEvent',4,['after_save']);
  • throws ExpectationFailedException

public verifyNeverInvoked($name, array $params = null)

Verifies that method was not called. In second argument with which arguments is not expected to be called.

<?php
$user->setName('davert');
$user->verifyNeverInvoked('setName'); // fail
$user->verifyNeverInvoked('setName',['davert']); // fail
$user->verifyNeverInvoked('setName',['bob']); // success
$user->verifyNeverInvoked('setName',[]); // success
  • throws ExpectationFailedException