Merge branch '6.4' into 7.0

* 6.4: (99 commits)
  [HttpClient][Messenger] add `PingWebhookMessage` and `PingWebhookMessageHandler`
  Use Stringable interface as much as possible
  [Messenger][Process] add `RunProcessMessage` and `RunProcessMessageHandler`
  Add generics to the progress bar iteration methods
  [SecurityBundle] Allow an array of `pattern` in firewall configuration
  [FrameworkBundle] Simplify marking store configuration
  [PsrHttpMessageBridge] Patch return types and fix CS
  [PsrHttpMessageBridge] Import the bridge into the monorepo
  Prepare release 2.3.1
  Fix CS
  Don't rely on Request::getPayload() to populate the parsed body
  Prepare release 2.3.0
  Implement ValueResolverInterface
  Leverage `Request::getPayload()` to populate the parsed body of PSR-7 requests
  Add native types where possible
  cs fix
  Prepare the 2.2.0 release
  Bump psr/http-message version
  Drop support for Symfony 4
  Adjustments for PHP CS Fixer 3
  ...

Author: derrabus

CHANGELOG.md

@@ -12,6 +12,7 @@ CHANGELOG
 
  * Add `HarFileResponseFactory` testing utility, allow to replay responses from `.har` files
  * Add `max_retries` option to `RetryableHttpClient` to adjust the retry logic on a per request level
+ * Add `PingWehookMessage` and `PingWebhookMessageHandler`
 
 6.3
 ---

Messenger/PingWebhookMessage.php

@@ -0,0 +1,31 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\HttpClient\Messenger;
+
+/**
+ * @author Kevin Bond <[email protected]>
+ */
+final class PingWebhookMessage implements \Stringable
+{
+    public function __construct(
+        public readonly string $method,
+        public readonly string $url,
+        public readonly array $options = [],
+        public readonly bool $throw = true,
+    ) {
+    }
+
+    public function __toString(): string
+    {
+        return "[{$this->method}] {$this->url}";
+    }
+}

Messenger/PingWebhookMessageHandler.php

@@ -0,0 +1,34 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\HttpClient\Messenger;
+
+use Symfony\Contracts\HttpClient\HttpClientInterface;
+use Symfony\Contracts\HttpClient\ResponseInterface;
+
+/**
+ * @author Kevin Bond <[email protected]>
+ */
+class PingWebhookMessageHandler
+{
+    public function __construct(
+        private readonly HttpClientInterface $httpClient,
+    ) {
+    }
+
+    public function __invoke(PingWebhookMessage $message): ResponseInterface
+    {
+        $response = $this->httpClient->request($message->method, $message->url, $message->options);
+        $response->getHeaders($message->throw);
+
+        return $response;
+    }
+}

Tests/Messenger/PingWebhookMessageHandlerTest.php

@@ -0,0 +1,80 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\HttpClient\Tests\Messenger;
+
+use PHPUnit\Framework\TestCase;
+use Symfony\Component\HttpClient\Exception\ClientException;
+use Symfony\Component\HttpClient\Messenger\PingWebhookMessage;
+use Symfony\Component\HttpClient\Messenger\PingWebhookMessageHandler;
+use Symfony\Component\HttpClient\MockHttpClient;
+use Symfony\Component\HttpClient\Response\MockResponse;
+
+/**
+ * @author Kevin Bond <[email protected]>
+ */
+final class PingWebhookMessageHandlerTest extends TestCase
+{
+    public function testSuccessfulPing()
+    {
+        $client = new MockHttpClient([
+            function ($method, $url) {
+                $this->assertSame('POST', $method);
+                $this->assertSame('https://endpoint.com/key', $url);
+
+                return new MockResponse('a response');
+            },
+        ]);
+        $handler = new PingWebhookMessageHandler($client);
+        $response = $handler(new PingWebhookMessage('POST', 'https://endpoint.com/key'));
+
+        $this->assertSame(200, $response->getStatusCode());
+        $this->assertSame('a response', $response->getContent());
+        $this->assertSame('https://endpoint.com/key', $response->getInfo('url'));
+    }
+
+    public function testPingErrorThrowsException()
+    {
+        $client = new MockHttpClient([
+            function ($method, $url) {
+                $this->assertSame('POST', $method);
+                $this->assertSame('https://endpoint.com/key', $url);
+
+                return new MockResponse('a response', ['http_code' => 404]);
+            },
+        ]);
+
+        $handler = new PingWebhookMessageHandler($client);
+
+        $this->expectException(ClientException::class);
+
+        $handler(new PingWebhookMessage('POST', 'https://endpoint.com/key'));
+    }
+
+    public function testPingErrorDoesNotThrowException()
+    {
+        $client = new MockHttpClient([
+            function ($method, $url) {
+                $this->assertSame('POST', $method);
+                $this->assertSame('https://endpoint.com/key', $url);
+
+                return new MockResponse('a response', ['http_code' => 404]);
+            },
+        ]);
+
+        $handler = new PingWebhookMessageHandler($client);
+        $response = $handler(new PingWebhookMessage('POST', 'https://endpoint.com/key', throw: false));
+
+        $this->assertSame(404, $response->getStatusCode());
+        $this->assertSame('a response', $response->getContent(false));
+        $this->assertSame('https://endpoint.com/key', $response->getInfo('url'));
+    }
+}

composer.json

@@ -38,6 +38,7 @@
         "psr/http-client": "^1.0",
         "symfony/dependency-injection": "^6.4|^7.0",
         "symfony/http-kernel": "^6.4|^7.0",
+        "symfony/messenger": "^6.4|^7.0",
         "symfony/process": "^6.4|^7.0",
         "symfony/stopwatch": "^6.4|^7.0"
     },