README

关联ID是一个唯一的标识值，它附加到请求和消息中，允许引用特定的交易或事件链。

展示

某些负载均衡器或WAF提供这样的附加头，因此您只需规范化其名称并将其传播到您的系统中（子请求、日志等）。

关联ID的检测方式为

CF-RAY
X-Correlation-ID
X-Request-ID

如果没有找到任何内容，则使用UUID生成器生成一个新的ID，并将其添加为X-Correlation-ID并返回到响应中。

实现

只需将中间件添加到您的dispatcher管道中。

// @todo: generate request

$dispatcher = new Dispatcher();
$dispatcher->pipe(new CorrelationIdMiddleware());

// @todo: add other middleware

$response = $dispatcher->handle($request);

关联ID也作为名为correlation-id的attribute可用。

headers和response header都可以被覆盖。

// @todo: generate request

$correlationMiddleware = new CorrelationIdMiddleware(
    [
        'X-Custom-Header',
        CorrelationIdMiddleware::HEADER_CORRELATION_ID,
    ],
    'X-Custom-Header'
);

$dispatcher = new Dispatcher();
$dispatcher->pipe($correlationMiddleware);

// @todo: add other middleware

$response = $dispatcher->handle($request);

注意：可以通过在构造函数中将第二个参数指定为false来跳过在响应中添加关联ID头。

文档

关联ID的价值

适用于微服务架构的关联ID

woody / middleware-correlation-id

维护者

详细信息

README

展示

实现

文档