Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #429 from robertbasic/documentation/instance-mocking
Documentation/instance mocking
- Loading branch information
Showing
3 changed files
with
95 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -6,5 +6,6 @@ Cookbook | |
|
||
default_expectations | ||
detecting_mock_objects | ||
mocking_hard_dependencies | ||
|
||
.. include:: map.rst.inc |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,3 @@ | ||
* :doc:`/cookbook/default_expectations` | ||
* :doc:`/cookbook/detecting_mock_objects` | ||
* :doc:`/cookbook/mocking_hard_dependencies` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,93 @@ | ||
.. index:: | ||
single: Cookbook; Mocking Hard Dependencies | ||
|
||
Mocking Hard Dependencies (new Keyword) | ||
======================================= | ||
|
||
One prerequisite to mock hard dependencies is that the code we are trying to test uses autoloading. | ||
|
||
Let's take the following code for an example: | ||
|
||
.. code-block:: php | ||
<?php | ||
namespace App; | ||
class Service | ||
{ | ||
function callExternalService($param) | ||
{ | ||
$externalService = new Service\External(); | ||
$externalService->sendSomething($param); | ||
return $externalService->getSomething(); | ||
} | ||
} | ||
The way we can test this without doing any changes to the code itself is by creating :doc:`instance mocks </reference/instance_mocking>` by using the ``overload`` prefix. | ||
|
||
.. code-block:: php | ||
<?php | ||
namespace AppTest; | ||
use Mockery as m; | ||
class ServiceTest extends \PHPUnit_Framework_TestCase | ||
{ | ||
public function testCallingExternalService() | ||
{ | ||
$param = 'Testing'; | ||
$externalMock = m::mock('overload:App\Service\External'); | ||
$externalMock->shouldReceive('sendSomething') | ||
->once() | ||
->with($param); | ||
$externalMock->shouldReceive('getSomething') | ||
->once() | ||
->andReturn('Tested!'); | ||
$service = new \App\Service(); | ||
$result = $service->callExternalService($param); | ||
$this->assertSame('Tested!', $result); | ||
} | ||
} | ||
If we run this test now, it should pass. Mockery does its job and our ``App\Service`` will use the mocked external service instead of the real one. | ||
|
||
The problem with this is when we want to, for example, test the ``App\Service\External`` itself, or if we use that class somewhere else in our tests. | ||
|
||
When Mockery overloads a class, because of how PHP works with files, that overloaded class file must not be included otherwise Mockery will throw a "class already exists" exception. This is where autoloading kicks in and makes our job a lot easier. | ||
|
||
To make this possible, we'll tell PHPUnit to run the tests that have overloaded classes in separate processes and to not preserve global state. That way we'll avoid having the overloaded class included more than once. Of course this has its downsides as these tests will run slower. | ||
|
||
Our test example from above now becomes: | ||
|
||
.. code-block:: php | ||
<?php | ||
namespace AppTest; | ||
use Mockery as m; | ||
/** | ||
* @runTestsInSeparateProcesses | ||
* @preserveGlobalState disabled | ||
*/ | ||
class ServiceTest extends \PHPUnit_Framework_TestCase | ||
{ | ||
public function testCallingExternalService() | ||
{ | ||
$param = 'Testing'; | ||
$externalMock = m::mock('overload:App\Service\External'); | ||
$externalMock->shouldReceive('sendSomething') | ||
->once() | ||
->with($param); | ||
$externalMock->shouldReceive('getSomething') | ||
->once() | ||
->andReturn('Tested!'); | ||
$service = new \App\Service(); | ||
$result = $service->callExternalService($param); | ||
$this->assertSame('Tested!', $result); | ||
} | ||
} |