From ecec417898318675d3986c0ab393048a5d6a803b Mon Sep 17 00:00:00 2001
From: Christian Flothmann <christian.flothmann@xabbuh.de>
Date: Wed, 3 May 2017 18:34:35 +0200
Subject: [PATCH] mention old way to create PHPUnit mock objects

---
 create_framework/unit_testing.rst | 6 ++++++
 form/unit_testing.rst             | 2 ++
 testing/database.rst              | 2 ++
 3 files changed, 10 insertions(+)

diff --git a/create_framework/unit_testing.rst b/create_framework/unit_testing.rst
index de52439d74e..f60ab3e5cea 100644
--- a/create_framework/unit_testing.rst
+++ b/create_framework/unit_testing.rst
@@ -93,6 +93,9 @@ We are now ready to write our first test::
         private function getFrameworkForException($exception)
         {
             $matcher = $this->createMock(Routing\Matcher\UrlMatcherInterface::class);
+            // use getMock() on PHPUnit 5.3 or below
+            // $matcher = $this->getMock(Routing\Matcher\UrlMatcherInterface::class);
+
             $matcher
                 ->expects($this->once())
                 ->method('match')
@@ -149,6 +152,9 @@ Response::
     public function testControllerResponse()
     {
         $matcher = $this->createMock(Routing\Matcher\UrlMatcherInterface::class);
+        // use getMock() on PHPUnit 5.3 or below
+        // $matcher = $this->getMock(Routing\Matcher\UrlMatcherInterface::class);
+
         $matcher
             ->expects($this->once())
             ->method('match')
diff --git a/form/unit_testing.rst b/form/unit_testing.rst
index 114ae99b5e1..a1e4b6eb1a8 100644
--- a/form/unit_testing.rst
+++ b/form/unit_testing.rst
@@ -185,6 +185,8 @@ allows you to return a list of extensions to register::
         protected function getExtensions()
         {
             $validator = $this->createMock(ValidatorInterface::class);
+            // use getMock() on PHPUnit 5.3 or below
+            // $validator = $this->getMock(ValidatorInterface::class);
             $validator
                 ->method('validate')
                 ->will($this->returnValue(new ConstraintViolationList()));
diff --git a/testing/database.rst b/testing/database.rst
index 82abbc12125..72f8c68d88f 100644
--- a/testing/database.rst
+++ b/testing/database.rst
@@ -71,6 +71,8 @@ it's easy to pass a mock object within a test::
         {
             // First, mock the object to be used in the test
             $employee = $this->createMock(Employee::class);
+            // use getMock() on PHPUnit 5.3 or below
+            // $employee = $this->getMock(Employee::class);
             $employee->expects($this->once())
                 ->method('getSalary')
                 ->will($this->returnValue(1000));