[HttpClient] add $response->cancel()

nicolas-grekas · nicolas-grekas · commit 549930e820bb · 2019-06-03T20:11:29.000+02:00
diff --git a/UPGRADE-4.4.md b/UPGRADE-4.4.md
@@ -25,6 +25,11 @@ DependencyInjection
        factory: ['@factory_service', method]
    ```
 
+HttpClient
+----------
+
+ * Added method `cancel()` to `ResponseInterface`
+
 Messenger
 ---------
 
diff --git a/UPGRADE-5.0.md b/UPGRADE-5.0.md
@@ -220,6 +220,11 @@ FrameworkBundle
  * Support for the legacy directory structure in `translation:update` and `debug:translation` commands has been removed.
  * Removed the "Psr\SimpleCache\CacheInterface" / "cache.app.simple" service, use "Symfony\Contracts\Cache\CacheInterface" / "cache.app" instead.
 
+HttpClient
+----------
+
+ * Added method `cancel()` to `ResponseInterface`
+
 HttpFoundation
 --------------
 
diff --git a/src/Symfony/Component/HttpClient/CHANGELOG.md b/src/Symfony/Component/HttpClient/CHANGELOG.md
@@ -1,6 +1,11 @@
 CHANGELOG
 =========
 
+4.4.0
+-----
+
+ * added `$response->cancel()`
+
 4.3.0
 -----
 
diff --git a/src/Symfony/Component/HttpClient/Response/ResponseTrait.php b/src/Symfony/Component/HttpClient/Response/ResponseTrait.php
@@ -169,6 +169,15 @@ public function toArray(bool $throw = true): array
         return $content;
     }
 
+    /**
+     * {@inheritdoc}
+     */
+    public function cancel(): void
+    {
+        $this->info['error'] = 'Response has been canceled.';
+        $this->close();
+    }
+
     /**
      * Closes the response and all its network handles.
      */
diff --git a/src/Symfony/Contracts/HttpClient/ResponseInterface.php b/src/Symfony/Contracts/HttpClient/ResponseInterface.php
@@ -71,6 +71,11 @@ public function getContent(bool $throw = true): string;
      */
     public function toArray(bool $throw = true): array;
 
+    /**
+     * Cancels the response.
+     */
+    public function cancel(): void;
+
     /**
      * Returns info coming from the transport layer.
      *
