cline/traycer

Generate and attach tracing identifiers to Laravel request context

1.0.0 2026-02-04 04:38 UTC

Requires

• php: ^8.5.0
• illuminate/contracts: ^11.0 || ^12.0
• illuminate/support: ^11.0 || ^12.0
• spatie/laravel-package-tools: ^1.92.7

Requires (Dev)

• cline/coding-standard: ^1.6.3
• cline/idempotency: ^1.0.1
• cline/mint: ^1.2
• orchestra/testbench: ^8.0 || ^9.0 || ^10.9
• symfony/var-dumper: ^6.0 || ^7.4.4

Suggests

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

MIT

• Brian Faust

• php

README

traycer

Generate and attach tracing identifiers to Laravel request context.

Requirements

Requires PHP 8.5+

Installation

composer require cline/traycer

Usage

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

// config/traycer.php
'strategy' => 'idempotency',
'context_key' => 'tracingIdentifier',

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

// Use Mint (optional) after: composer require cline/mint
'strategy' => 'mint',
'strategies' => [
    'mint' => [
        'class' => \Cline\Traycer\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.