README

Middleware for adding a request id to your Symfony Requests

Installation

First, add this project to your project's composer.json

$ composer require mymedia/stack-request-id ^2.0

Setting up

Update your app.php to include the middleware:

Before:

use Symfony\Component\HttpFoundation\Request;

$kernel = new AppKernel($env, $debug);
$kernel->loadClassCache();

$request = Request::createFromGlobals();
$response = $kernel->handle($request);
$response->send();
$kernel->terminate($request, $response);

After:

use Feedo\Stack\RequestId;
use Feedo\Stack\Uuid4RequestIdGenerator;
use Symfony\Component\HttpFoundation\Request;

$kernel = new AppKernel($env, $debug);

// Stack it!
$generator = new Uuid4RequestIdGenerator();
$stack = new RequestId($kernel, $generator);

$kernel->loadClassCache();

$request = Request::createFromGlobals();
$response = $stack->handle($request);
$response->send();
$kernel->terminate($request, $response);

Adding the request id to your monolog logs

If you use Symfony's MonologBundle you can add the request id to your monolog logs by adding the following service definition to your services.xml file:

<service id="feedo.stack.request_id.monolog_processor" class="Feedo\Stack\RequestId\MonologProcessor">
  <tag name="kernel.event_listener" event="kernel.request" method="onKernelRequest" priority="255" />
  <tag name="monolog.processor" />
</service>

Adding the request id to responses

If you need to send the request id back with the response you can enable the response header:

$generator = new Uuid4RequestIdGenerator();
$stack = new RequestId($kernel, $generator);
$stack->enableResponseHeader();

It is also possible to change response header's name:

$stack->enableResponseHeader('My-Custom-Request-Id');

If you don't have access to the RequestId object instance (StackPHP, for example) the response header can be set via the fourth argument of the RequestId constructor method.

$generator = new Uuid4RequestIdGenerator();
$stack = new RequestId($kernel, $generator, 'X-Request-Id', 'My-Custom-Request-Id');

The third argument, for reference, is the name of the header:

• That will be checked for a value before falling back to generating a new request ID,
• Used to store the resulting request ID inside Symfony's request object.

StackPHP's Middleware Builder

If you are already using StackPHP, just push the RequestId class into the builder.

$kernel = new AppKernel('dev', true);

$generator = new Uuid4RequestIdGenerator();
$stack = (new Stack\Builder)
    ->push('Feedo\Stack\RequestId', $generator, 'X-Request-Id', 'X-Request-Id')
    ->resolve($kernel);

$kernel->loadClassCache();

$request = Request::createFromGlobals();
$response = $stack->handle($request);
$response->send();
$kernel->terminate($request, $response);