[HttpClient][WebProfilerBundle] Add button to copy a request as a cURL command

Author: Jérôme Deuchnord

DataCollector/HttpClientDataCollector.php

@@ -163,8 +163,61 @@ private function collectOnClient(TraceableHttpClient $client): array
             unset($traces[$i]['info']); // break PHP reference used by TraceableHttpClient
             $traces[$i]['info'] = $this->cloneVar($info);
             $traces[$i]['options'] = $this->cloneVar($trace['options']);
+            $traces[$i]['curlCommand'] = $this->getCurlCommand($trace);
         }
 
         return [$errorCount, $traces];
     }
+
+    private function getCurlCommand(array $trace): ?string
+    {
+        $debug = explode("\n", $trace['info']['debug']);
+        $url = $trace['url'];
+        $command = ['curl', '--compressed'];
+
+        $dataArg = [];
+
+        if ($json = $trace['options']['json'] ?? null) {
+            $dataArg[] = '--data '.escapeshellarg(json_encode($json, \JSON_PRETTY_PRINT));
+        } elseif ($body = $trace['options']['body'] ?? null) {
+            if (\is_string($body)) {
+                $dataArg[] = '--data '.escapeshellarg($body);
+            } elseif (\is_array($body)) {
+                foreach ($body as $key => $value) {
+                    $dataArg[] = '--data '.escapeshellarg("$key=$value");
+                }
+            } else {
+                return null;
+            }
+        }
+
+        $dataArg = empty($dataArg) ? null : implode(' ', $dataArg);
+
+        foreach ($debug as $line) {
+            $line = substr($line, 0, -1);
+
+            if (str_starts_with('< ', $line)) {
+                // End of the request, beginning of the response. Stop parsing.
+                break;
+            }
+
+            if ('' === $line || preg_match('/^[*<]|(Host: )/', $line)) {
+                continue;
+            }
+
+            if (preg_match('/^> ([A-Z]+)/', $line, $match)) {
+                $command[] = sprintf('--request %s', $match[1]);
+                $command[] = sprintf('--url %s', escapeshellarg($url));
+                continue;
+            }
+
+            $command[] = '--header '.escapeshellarg($line);
+        }
+
+        if (null !== $dataArg) {
+            $command[] = $dataArg;
+        }
+
+        return implode(" \\\n  ", $command);
+    }
 }

Tests/DataCollector/HttpClientDataCollectorTest.php

@@ -166,6 +166,81 @@ public function testItIsEmptyAfterReset()
         $this->assertEquals(0, $sut->getRequestCount());
     }
 
+    /**
+     * @requires extension openssl
+     */
+    public function testItGeneratesCurlCommandsAsExpected()
+    {
+        $sut = new HttpClientDataCollector();
+        $sut->registerClient('http_client', $this->httpClientThatHasTracedRequests([
+                [
+                    'method' => 'GET',
+                    'url' => 'https://symfony.com/releases.json',
+                ],
+            ]));
+        $sut->collect(new Request(), new Response());
+        $collectedData = $sut->getClients();
+        self::assertCount(1, $collectedData['http_client']['traces']);
+        $curlCommand = $collectedData['http_client']['traces'][0]['curlCommand'];
+        self::assertEquals("curl \\
+  --compressed \\
+  --request GET \\
+  --url 'https://symfony.com/releases.json' \\
+  --header 'Accept: */*' \\
+  --header 'Accept-Encoding: gzip' \\
+  --header 'User-Agent: Symfony HttpClient/Native'", $curlCommand
+);
+    }
+
+    /**
+     * @requires extension openssl
+     */
+    public function testItDoesNotFollowRedirectionsWhenGeneratingCurlCommands()
+    {
+        $sut = new HttpClientDataCollector();
+        $sut->registerClient('http_client', $this->httpClientThatHasTracedRequests([
+                [
+                    'method' => 'GET',
+                    'url' => 'http://symfony.com/releases.json',
+                ],
+            ]));
+        $sut->collect(new Request(), new Response());
+        $collectedData = $sut->getClients();
+        self::assertCount(1, $collectedData['http_client']['traces']);
+        $curlCommand = $collectedData['http_client']['traces'][0]['curlCommand'];
+        self::assertEquals("curl \\
+  --compressed \\
+  --request GET \\
+  --url 'http://symfony.com/releases.json' \\
+  --header 'Accept: */*' \\
+  --header 'Accept-Encoding: gzip' \\
+  --header 'User-Agent: Symfony HttpClient/Native'", $curlCommand
+);
+    }
+
+    /**
+     * @requires extension openssl
+     */
+    public function testItDoesNotGeneratesCurlCommandsForUnsupportedBodyType()
+    {
+        $sut = new HttpClientDataCollector();
+        $sut->registerClient('http_client', $this->httpClientThatHasTracedRequests([
+                [
+                    'method' => 'GET',
+                    'url' => 'https://symfony.com/releases.json',
+                    'options' => [
+                        'body' => static fn (int $size): string => '',
+                    ],
+                ],
+            ]));
+        $sut->collect(new Request(), new Response());
+        $collectedData = $sut->getClients();
+        self::assertCount(1, $collectedData['http_client']['traces']);
+        $curlCommand = $collectedData['http_client']['traces'][0]['curlCommand'];
+        self::assertNull($curlCommand
+);
+    }
+
     private function httpClientThatHasTracedRequests($tracedRequests): TraceableHttpClient
     {
         $httpClient = new TraceableHttpClient(new NativeHttpClient());