php-middleware/request-id

Request Id middleware with PSR-7

4.1.0 2020-12-08 00:15 UTC

README

Build Status

PSR-7 Request ID middleware

This middleware provide framework-agnostic possibility to generate and add to request/response's header Request ID (Correlation ID).

Installation

composer require php-middleware/request-id

Usage

This middleware require in contructor PhpMiddleware\RequestId\RequestIdProviderFactoryInterface implementation which must create a new RequestIdProviderInterface object. We provide RequestIdProvider default implementation.

$generator = new PhpMiddleware\RequestId\Generator\PhpUniqidGenerator();
$requestIdProvider = new PhpMiddleware\RequestId\RequestIdProviderFactory($generator);
$requestIdMiddleware = new PhpMiddleware\RequestId\RequestIdMiddleware($requestIdProvider);

$app = new MiddlewareRunner();
$app->add($requestIdMiddleware);
$app->run($request, $response);

All Provider factory constructor options:

  • PhpMiddleware\RequestId\Generator\GeneratorInterface $generator - generator implementation (required)
  • bool|PhpMiddleware\RequestId\OverridePolicy\OverridePolicyInterface $allowOverride (default true) - if true and request id header exists in incoming request, then value from request header will be used in middleware, using generator will be avoid
  • string $requestHeader (default X-Request-Id) - request header name

How to get request id in my application?

  • Middleware implements RequestIdProviderInterface, so you are able to use getRequestId() method,
  • from request-id attribute in ServerRequest object ($request->getAttribute(RequestIdMiddleware::ATTRIBUTE_NAME)).

Override policy

You can add your own logic to decide when override incoming request id. You can implement OverridePolicyInterface and pass it as $allowOverride variable in constructor.

Monolog processor

We provide simple Monolog processor to add request it to every log entry!

Request decorator

RequestDecorator adds header with request id to your request object. It's useful when your microservices communicate between using PSR-7 HTTP messages e.g. Guzzle.

Request Id generators

To generate request id you need to use implementation of PhpMiddleware\RequestId\Generator\GeneratorInterface. There are predefined generators in PhpMiddleware\RequestId\Generator\ namespace:

PhpUniqidGenerator

Simple generator using uniqid function.

RamseyUuid1Generator

UUID1 implementations of Ramsey\Uuid. To use it you need to add ramsey/uuid dependency to your composer.json.

RamseyUuid3Generator

UUID3 implementations of Ramsey\Uuid. To use it you need to add ramsey/uuid dependency to your composer.json.

RamseyUuid4Generator

UUID4 implementations of Ramsey\Uuid. To use it you need to add ramsey/uuid dependency to your composer.json.

RamseyUuid4StaticGenerator

Generates Uuid4 like RamseyUuid4Generator however it's not require any dependency (it use static factory method).

RamseyUuid5Generator

UUID5 implementations of Ramsey\Uuid. To use it you need to add ramsey/uuid dependency to your composer.json.

PrefixedGenerator

It adds prefix to generated request id.

Md5Generator

This generator converts generated request id to md5 hash.

It's just works with any modern php framework!

Middleware tested on:

Middleware should works with:

And any other modern framework supported middlewares and PSR-7.