pond5/async-request-bundle

This bundle allows sending requests to a Symfony Messenger transport to be handled later by a consumer

Installs: 67

Dependents: 0

Suggesters: 0

Security: 0

Stars: 1

Watchers: 12

Forks: 0

Open Issues: 0

Type:symfony-bundle

1.1 2021-07-11 19:47 UTC

This package is auto-updated.

Last update: 2021-09-22 15:25:19 UTC


README

Pond5 Async Request Bundle codecov Latest Stable Version Total Downloads

This bundle allows sending requests to a Symfony Messenger transport to be handled later by a consumer.

Installation

Make sure Composer is installed globally, as explained in the installation chapter of the Composer documentation.

Applications that use Symfony Flex

Open a command console, enter your project directory and execute:

composer require pond5/async-request-bundle

Applications that don't use Symfony Flex

  1. 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)%'
  1. 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
  1. 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],
];

Usage

  1. Add X-Request-Async header a DELETE, 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
  1. Handle the request/consume the message
bin/console messenger:consume

Test

  1. Install dev dependencies.
composer install
  1. Run unit tests.
bin/phpunit