Add MockClient::withoutCache()

src/Http/Faking/MockClient.php

@@ -58,6 +58,13 @@ class MockClient
      */
     protected static ?MockClient $globalMockClient = null;
 
+    /**
+     * When true, the response cache plugin will not read or write the cache
+     * for requests using this mock client (for example, so fixture files are
+     * re-read from disk on each request during tests).
+     */
+    protected bool $withoutResponseCache = false;
+
     /**
      * Constructor
      *
@@ -404,6 +411,26 @@ public function findResponseByRequestUrl(string $url, ?int $index = null): ?Resp
         return null;
     }
 
+    /**
+     * Disable the response cache while this mock client is in use.
+     *
+     * @return $this
+     */
+    public function withoutCache(): static
+    {
+        $this->withoutResponseCache = true;
+
+        return $this;
+    }
+
+    /**
+     * Whether the response cache plugin should bypass caching.
+     */
+    public function shouldBypassResponseCache(): bool
+    {
+        return $this->withoutResponseCache;
+    }
+
     /**
      * Register a global mock client
      *

tests/Unit/MockClientTest.php

@@ -261,3 +261,13 @@
     $response = connector()->send(new UserRequest, $mockClient);
     $response->throw();
 });
+
+test('mock client can opt out of response cache integration', function () {
+    $client = new MockClient([]);
+
+    expect($client->shouldBypassResponseCache())->toBeFalse();
+
+    $client->withoutCache();
+
+    expect($client->shouldBypassResponseCache())->toBeTrue();
+});