cline/correlation

Generate and attach correlation identifiers to Laravel request context

3.0.1 2026-03-18 16:45 UTC

Requires

• php: ^8.5.0
• facade/ignition-contracts: ^1.0.2
• laravel/framework: ^11.0 || ^12.0 || ^13.0
• spatie/laravel-package-tools: ^1.93.0

Requires (Dev)

• cline/coding-standard: ^2.0.1
• cline/idempotency: ^2.0.1
• cline/mint: ^2.0.1
• orchestra/testbench: ^8.0 || ^9.0 || ^10.9
• symfony/var-dumper: ^6.0 || ^7.4.6 || ^8.0

Suggests

• cline/idempotency: Provides the default idempotency-based correlation identifier strategy.
• cline/mint: Optional. Provide flexible Mint-based correlation identifier generators.

MIT

• Brian Faust

• php

README

correlation

Generate and attach correlation identifiers to Laravel request context.

Requirements

Requires PHP 8.5+

Installation

composer require cline/correlation

Usage

// bootstrap/app.php (Laravel 12)
->withMiddleware(function (Middleware $middleware) {
    $middleware->append(\Cline\Correlation\Http\Middleware\AddCorrelationIdentifier::class);
})

// config/correlation.php
'strategy' => 'idempotency',
'context_key' => 'correlationIdentifier',

The default idempotency strategy hashes $request->json() to produce a stable correlation identifier.

// Use Mint (optional) after: composer require cline/mint
'strategy' => 'mint',
'strategies' => [
    'mint' => [
        'class' => \Cline\Correlation\Strategies\MintStrategy::class,
        'type' => 'ulid',
    ],
],

Change log

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING and CODE_OF_CONDUCT for details.

Security

If you discover any security related issues, please use the GitHub security reporting form rather than the issue queue.

Credits

• Brian Faust
• All Contributors

License

The MIT License. Please see License File for more information.