bug #29037 [Messenger] Mark the component as experimental for 4.2 (fa…

…bpot)

This PR was merged into the 4.2-dev branch.

Discussion
----------

[Messenger] Mark the component as experimental for 4.2

| Q             | A
| ------------- | ---
| Branch?       | master
| Bug fix?      | yes
| New feature?  | no <!-- don't forget to update src/**/CHANGELOG.md files -->
| BC breaks?    | no     <!-- see https://symfony.com/bc -->
| Deprecations? | no <!-- don't forget to update UPGRADE-*.md and src/**/CHANGELOG.md files -->
| Tests pass?   | yes    <!-- please add some, will be required by reviewers -->
| Fixed tickets | n/a
| License       | MIT
| Doc PR        | n/a

<!--
Write a short README entry for your feature/bugfix here (replace this comment block.)
This will help people understand your PR and can be used as a start of the Doc PR.
Additionally:
 - Bug fixes must be submitted against the lowest branch where they apply
   (lowest branches are regularly merged to upper ones so they get the fixes too).
 - Features and deprecations must be submitted against the master branch.
-->

Commits
-------

7cb99fa [Messenger] marked the component as experimental for 4.2

src/Symfony/Component/Messenger/Command/ConsumeMessagesCommand.php

@@ -27,6 +27,8 @@
 
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class ConsumeMessagesCommand extends Command
 {

src/Symfony/Component/Messenger/Command/DebugCommand.php

@@ -22,6 +22,8 @@
  * A console command to debug Messenger information.
  *
  * @author Roland Franssen <franssen.roland@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class DebugCommand extends Command
 {

src/Symfony/Component/Messenger/DataCollector/MessengerDataCollector.php

@@ -20,6 +20,8 @@
 
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class MessengerDataCollector extends DataCollector implements LateDataCollectorInterface
 {

src/Symfony/Component/Messenger/DependencyInjection/MessengerPass.php

@@ -29,6 +29,8 @@
 
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class MessengerPass implements CompilerPassInterface
 {

src/Symfony/Component/Messenger/Envelope.php

@@ -17,6 +17,8 @@
  * A message wrapped in an envelope with stamps (configurations, markers, ...).
  *
  * @author Maxime Steinhausser <maxime.steinhausser@gmail.com>
+ *
+ * @experimental in 4.2
  */
 final class Envelope
 {

src/Symfony/Component/Messenger/Exception/ExceptionInterface.php

@@ -15,6 +15,8 @@
  * Base Message component's exception.
  *
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 interface ExceptionInterface extends \Throwable
 {

src/Symfony/Component/Messenger/Exception/InvalidArgumentException.php

@@ -13,6 +13,8 @@
 
 /**
  * @author Yonel Ceruto <yonelceruto@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class InvalidArgumentException extends \InvalidArgumentException implements ExceptionInterface
 {

src/Symfony/Component/Messenger/Exception/LogicException.php

@@ -13,6 +13,8 @@
 
 /**
  * @author Roland Franssen <franssen.roland@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class LogicException extends \LogicException implements ExceptionInterface
 {

src/Symfony/Component/Messenger/Exception/NoHandlerForMessageException.php

@@ -13,6 +13,8 @@
 
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class NoHandlerForMessageException extends \LogicException implements ExceptionInterface
 {

src/Symfony/Component/Messenger/Exception/RuntimeException.php

@@ -13,6 +13,8 @@
 
 /**
  * @author Fabien Potencier <fabien@symfony.com>
+ *
+ * @experimental in 4.2
  */
 class RuntimeException extends \RuntimeException implements ExceptionInterface
 {

src/Symfony/Component/Messenger/Exception/ValidationFailedException.php

@@ -15,6 +15,8 @@
 
 /**
  * @author Tobias Nyholm <tobias.nyholm@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class ValidationFailedException extends \RuntimeException implements ExceptionInterface
 {

src/Symfony/Component/Messenger/Handler/ChainHandler.php

@@ -17,6 +17,8 @@
  * Represents a collection of message handlers.
  *
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class ChainHandler
 {

src/Symfony/Component/Messenger/Handler/Locator/AbstractHandlerLocator.php

@@ -18,6 +18,8 @@
  * @author Samuel Roze <samuel.roze@gmail.com>
  *
  * @internal
+ *
+ * @experimental in 4.2
  */
 abstract class AbstractHandlerLocator implements HandlerLocatorInterface
 {

src/Symfony/Component/Messenger/Handler/Locator/ContainerHandlerLocator.php

@@ -16,6 +16,8 @@
 /**
  * @author Miha Vrhovnik <miha.vrhovnik@gmail.com>
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class ContainerHandlerLocator extends AbstractHandlerLocator
 {

src/Symfony/Component/Messenger/Handler/Locator/HandlerLocator.php

@@ -13,6 +13,8 @@
 
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class HandlerLocator extends AbstractHandlerLocator
 {

src/Symfony/Component/Messenger/Handler/Locator/HandlerLocatorInterface.php

@@ -15,6 +15,8 @@
 
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 interface HandlerLocatorInterface
 {

src/Symfony/Component/Messenger/Handler/MessageHandlerInterface.php

@@ -15,6 +15,8 @@
  * Marker interface for message handlers.
  *
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 interface MessageHandlerInterface
 {

src/Symfony/Component/Messenger/Handler/MessageSubscriberInterface.php

@@ -15,6 +15,8 @@
  * Handlers can implement this interface to handle multiple messages.
  *
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 interface MessageSubscriberInterface extends MessageHandlerInterface
 {

src/Symfony/Component/Messenger/MessageBus.php

@@ -18,6 +18,8 @@
  * @author Samuel Roze <samuel.roze@gmail.com>
  * @author Matthias Noback <matthiasnoback@gmail.com>
  * @author Nicolas Grekas <p@tchwork.com>
+ *
+ * @experimental in 4.2
  */
 class MessageBus implements MessageBusInterface
 {

src/Symfony/Component/Messenger/MessageBusInterface.php

@@ -13,6 +13,8 @@
 
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 interface MessageBusInterface
 {

src/Symfony/Component/Messenger/Middleware/ActivationMiddleware.php

@@ -17,6 +17,8 @@
  * Execute the inner middleware according to an activation strategy.
  *
  * @author Maxime Steinhausser <maxime.steinhausser@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class ActivationMiddleware implements MiddlewareInterface
 {

src/Symfony/Component/Messenger/Middleware/HandleMessageMiddleware.php

@@ -17,6 +17,8 @@
 
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class HandleMessageMiddleware implements MiddlewareInterface
 {

src/Symfony/Component/Messenger/Middleware/LoggingMiddleware.php

@@ -16,6 +16,8 @@
 
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class LoggingMiddleware implements MiddlewareInterface
 {

src/Symfony/Component/Messenger/Middleware/MiddlewareInterface.php

@@ -15,6 +15,8 @@
 
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 interface MiddlewareInterface
 {

src/Symfony/Component/Messenger/Middleware/SendMessageMiddleware.php

@@ -19,6 +19,8 @@
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
  * @author Tobias Schultze <http://tobion.de>
+ *
+ * @experimental in 4.2
  */
 class SendMessageMiddleware implements MiddlewareInterface
 {

src/Symfony/Component/Messenger/Middleware/StackInterface.php

@@ -13,6 +13,8 @@
 
 /**
  * @author Nicolas Grekas <p@tchwork.com>
+ *
+ * @experimental in 4.2
  */
 interface StackInterface
 {

src/Symfony/Component/Messenger/Middleware/StackMiddleware.php

@@ -15,6 +15,8 @@
 
 /**
  * @author Nicolas Grekas <p@tchwork.com>
+ *
+ * @experimental in 4.2
  */
 class StackMiddleware implements MiddlewareInterface, StackInterface
 {

src/Symfony/Component/Messenger/Middleware/TraceableMiddleware.php

@@ -18,6 +18,8 @@
  * Collects some data about a middleware.
  *
  * @author Maxime Steinhausser <maxime.steinhausser@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class TraceableMiddleware implements MiddlewareInterface
 {

src/Symfony/Component/Messenger/Middleware/ValidationMiddleware.php

@@ -18,6 +18,8 @@
 
 /**
  * @author Tobias Nyholm <tobias.nyholm@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class ValidationMiddleware implements MiddlewareInterface
 {

src/Symfony/Component/Messenger/README.md

@@ -4,6 +4,10 @@ Messenger Component
 The Messenger component helps application send and receive messages to/from other applications or via
 message queues.
 
+**This Component is experimental**. [Experimental
+features](https://symfony.com/doc/current/contributing/code/experimental.html)
+are not covered by Symfony's BC-break policy.
+
 Resources
 ---------
 

src/Symfony/Component/Messenger/Stamp/ReceivedStamp.php

@@ -22,6 +22,8 @@
  * @see SendMessageMiddleware
  *
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 final class ReceivedStamp implements StampInterface
 {

src/Symfony/Component/Messenger/Stamp/SerializerStamp.php

@@ -13,6 +13,8 @@
 
 /**
  * @author Maxime Steinhausser <maxime.steinhausser@gmail.com>
+ *
+ * @experimental in 4.2
  */
 final class SerializerStamp implements StampInterface
 {

src/Symfony/Component/Messenger/Stamp/StampInterface.php

@@ -17,6 +17,8 @@
  * Stamps must be serializable value objects for transport.
  *
  * @author Maxime Steinhausser <maxime.steinhausser@gmail.com>
+ *
+ * @experimental in 4.2
  */
 interface StampInterface
 {

src/Symfony/Component/Messenger/Stamp/ValidationStamp.php

@@ -15,6 +15,8 @@
 
 /**
  * @author Maxime Steinhausser <maxime.steinhausser@gmail.com>
+ *
+ * @experimental in 4.2
  */
 final class ValidationStamp implements StampInterface
 {

src/Symfony/Component/Messenger/Test/Middleware/MiddlewareTestCase.php

@@ -18,6 +18,8 @@
 
 /**
  * @author Nicolas Grekas <p@tchwork.com>
+ *
+ * @experimental in 4.2
  */
 abstract class MiddlewareTestCase extends TestCase
 {

src/Symfony/Component/Messenger/TraceableMessageBus.php

@@ -13,6 +13,8 @@
 
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class TraceableMessageBus implements MessageBusInterface
 {

src/Symfony/Component/Messenger/Transport/AmqpExt/AmqpFactory.php

@@ -11,6 +11,9 @@
 
 namespace Symfony\Component\Messenger\Transport\AmqpExt;
 
+/**
+ * @experimental in 4.2
+ */
 class AmqpFactory
 {
     public function createConnection(array $credentials): \AMQPConnection

src/Symfony/Component/Messenger/Transport/AmqpExt/AmqpReceiver.php

@@ -20,6 +20,8 @@
  * Symfony Messenger receiver to get messages from AMQP brokers using PHP's AMQP extension.
  *
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class AmqpReceiver implements ReceiverInterface
 {

src/Symfony/Component/Messenger/Transport/AmqpExt/AmqpSender.php

@@ -20,6 +20,8 @@
  * Symfony Messenger sender to send messages to AMQP brokers using PHP's AMQP extension.
  *
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class AmqpSender implements SenderInterface
 {

src/Symfony/Component/Messenger/Transport/AmqpExt/AmqpTransport.php

@@ -18,6 +18,8 @@
 
 /**
  * @author Nicolas Grekas <p@tchwork.com>
+ *
+ * @experimental in 4.2
  */
 class AmqpTransport implements TransportInterface
 {

src/Symfony/Component/Messenger/Transport/AmqpExt/AmqpTransportFactory.php

@@ -18,6 +18,8 @@
 
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 class AmqpTransportFactory implements TransportFactoryInterface
 {

src/Symfony/Component/Messenger/Transport/AmqpExt/Connection.php

@@ -19,6 +19,8 @@
  * @author Samuel Roze <samuel.roze@gmail.com>
  *
  * @final
+ *
+ * @experimental in 4.2
  */
 class Connection
 {

src/Symfony/Component/Messenger/Transport/AmqpExt/Exception/RejectMessageExceptionInterface.php

@@ -19,6 +19,8 @@
  * be rejected. Otherwise, it will be re-queued.
  *
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 interface RejectMessageExceptionInterface extends \Throwable
 {

src/Symfony/Component/Messenger/Transport/Receiver/ReceiverInterface.php

@@ -13,6 +13,8 @@
 
 /**
  * @author Samuel Roze <samuel.roze@gmail.com>
+ *
+ * @experimental in 4.2
  */
 interface ReceiverInterface
 {