PSR-7 Request ID (Correlation ID) middleware
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
src
test
.gitignore
.scrutinizer.yml
.travis.yml
LICENSE
README.md
composer.json
phpunit.xml

README.md

Request ID middleware for PHP

Build Status Scrutinizer Code Quality Code Coverage 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

{
    "require": {
        "php-middleware/request-id": "^3.0.0"
    }
}

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\LogHttpMessages\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.