This bundle allows sending requests to a Symfony Messenger transport to be handled later by a consumer.
Make sure Composer is installed globally, as explained in the installation chapter of the Composer documentation.
Open a command console, enter your project directory and execute:
composer require pond5/async-request-bundle
- Add config file
# config/packages/pond5_async_request.yaml
pond5_async_request:
#header: X-Request-Async # user defined header name to indicate asynchronous request - X-Request-Async used by default
#methods: [DELETE, PATCH, POST, PUT] # HTTP methods that should support async requests
transport: async-request # messenger transport name, ignored if messenger routing for Pond5\AsyncRequestBundle\Message\AsyncRequestNotification is configured manually
# can be omitted when using transport configured in another file (e.g. messenger.yaml)
framework:
messenger:
transports:
async-request: '%env(MESSENGER_TRANSPORT_DSN)%'
- Download the Bundle
Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:
composer require pond5/async-request-bundle
- Enable the Bundle
Then, enable the bundle by adding it to the list of registered bundles
in the config/bundles.php
file of your project:
// config/bundles.php
return [
// ...
Pond5\AsyncRequestBundle\Pond5AsyncRequestBundle::class => ['all' => true],
];
- Add
X-Request-Async
header aDELETE, PATCH, POST, PUT
request, e.g.
curl -i -X POST http://example.org/endpoint -H "X-Request-Async: 1"
Symfony should respond with 202
status code and empty body:
HTTP/1.1 202 Accepted
Content-Length: 0
- Handle the request/consume the message
bin/console messenger:consume
- Install dev dependencies.
composer install
- Run unit tests.
bin/phpunit