Document changes in cakephp/cakephp#17856

Author: markstory

en/appendices/5-1-migration-guide.rst

@@ -138,6 +138,7 @@ TestSuite
   its methods were updated to be static.
 - ``LogTestTrait`` was added. This new trait makes it easy to capture logs in
   your tests and make assertions on the presence or absence of log messages.
+- ``IntegrationTestTrait::replaceRequest()`` was added.
 
 Utility
 -------

en/development/testing.rst

@@ -1098,13 +1098,22 @@ to configure the requests you will send to your application under test::
     // Set session data
     $this->session(['Auth.User.id' => 1]);
 
-    // Configure headers
+    // Configure headers and merge with the existing request
     $this->configRequest([
         'headers' => ['Accept' => 'application/json']
     ]);
 
+    // Replace the existing request. Added in 5.1.0
+    $this->replaceRequest([
+        'headers' => ['Accept' => 'application/json']
+    ]);
+
+
 The state set by these helper methods is reset in the ``tearDown()`` method.
 
+.. versionadded:: 5.1.0
+    ``replaceRequest()`` was added.
+
 Testing Actions Protected by CsrfComponent or SecurityComponent
 ---------------------------------------------------------------