feature #14391 [Messenger] Added SQS Messenger docs (Simperfit, Nyholm)

This PR was submitted for the 5.x branch but it was merged into the 5.1 branch instead.

Discussion
----------

[Messenger] Added SQS Messenger docs

This will close #13328 and fix #13093

Commits
-------

cf4331b Sort alphabetically
7d530ac Typos
d198bb7 minor
5fa1465 Typo
f56ddd3 Syntax fix
d2fdd03 syntax
689df8c cs
47dbe33 Added SQS Messenger docs
9dd75a9 feat: add amazon sqs to docs

Author: wouterj

messenger.rst

@@ -1151,6 +1151,72 @@ during a request::
         :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\KernelTestCase`
         or :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\WebTestCase`.
 
+Amazon SQS
+~~~~~~~~~~
+
+.. versionadded:: 5.1
+
+    The Amazon SQS transport has been added in Symfony 5.1
+    Install it by running:
+
+    .. code-block:: terminal
+
+        $ composer require symfony/amazon-sqs-messenger
+
+The ``SQS`` transport configuration looks like this:
+
+.. code-block:: bash
+
+    # .env
+    MESSENGER_TRANSPORT_DSN=sqs://AKIAIOSFODNN7EXAMPLE:j17M97ffSVoKI0briFoo9a@sqs.eu-west-3.amazonaws.com/messages
+    #MESSENGER_TRANSPORT_DSN=sqs://localhost:9494/messages?sslmode=disable
+
+.. note::
+
+    The transport will automatically create queues that are needed. This
+    can be disabled setting the "auto_setup" option to ``false``.
+
+A number of options can be configured via the DSN or via the ``options`` key
+under the transport in ``messenger.yaml``:
+
+==================  ======================================  ======================
+     Option         Description                             Default
+==================  ======================================  ======================
+access_key          AWS access key
+account             Identifier of the AWS account           The owner of the credentials
+auto_setup          Whether the table should be created     true
+                    automatically during send / get.
+buffer_size         Number of messages to prefetch          9
+endpoint            Absolute URL to the SQS service         https://sqs.eu-west-1.amazonaws.com
+poll_timeout        Wait for new message duration in        0.1
+                    seconds
+queue_name          Name of the queue                       messages
+region              Name of the AWS region                  eu-west-1
+secret_key          AWS secret key
+visibility_timeout  Amount of seconds the message will      Queue's configuration
+                    not be visible (`Visibility Timeout`_)
+wait_time           `Long polling`_ duration in seconds     20
+==================  ======================================  ======================
+
+.. note::
+
+    The ``wait_time`` parameter defines the maximum duration Amazon SQS should
+    wait until a message is available in a queue before sending a response.
+    It helps reducing the cost of using Amazon SQS by eliminating the number
+    of empty responses.
+
+    The ``poll_timeout`` parameter defines the duration the receiver should wait
+    before returning null. It avoids blocking other receivers from being called.
+
+.. note::
+
+    If the queue name is suffixed by ``.fifo``, AWS will create a `FIFO queue`_.
+    Use the stamp :class:`Symfony\\Component\\Messenger\\Bridge\\AmazonSqs\\Transport\\AmazonSqsFifoStamp`
+    to define the ``Message group ID`` and the ``Message deduplication ID``.
+
+    FIFO queues don't support setting a delay per message, a value of ``delay: 0``
+    is required in the retry strategy settings.
+
 Serializing Messages
 ~~~~~~~~~~~~~~~~~~~~
 
@@ -1294,7 +1360,6 @@ by tagging the handler service with ``messenger.message_handler``
                 'handles' => SmsNotification::class,
             ]);
 
-
 Possible options to configure with tags are:
 
 * ``bus``
@@ -1595,7 +1660,6 @@ middleware and *only* include your own:
             ],
         ]);
 
-
 .. note::
 
     If a middleware service is abstract, a different instance of the service will
@@ -1724,3 +1788,6 @@ Learn more
 .. _`streams`: https://redis.io/topics/streams-intro
 .. _`Supervisor docs`: http://supervisord.org/
 .. _`SymfonyCasts' message serializer tutorial`: https://symfonycasts.com/screencast/messenger/transport-serializer
+.. _`Long polling`: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-short-and-long-polling.html
+.. _`Visibility Timeout`: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
+.. _`FIFO queue`: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html