vocento/request-id

HTTP Request identifier to trace requests through microservices calls

v1.2.0 2025-07-01 07:46 UTC

Requires

• php: >=7.4
• ramsey/uuid: ^3|^4

Requires (Dev)

• phpunit/phpunit: ^9.0

proprietary

README

This library contains the class and the way a RequestId should be used between the microservices calls.

Installation

To install the library, include the package as a requirement in your composer.json file.

composer require vocento/request-id

Usage

To create a new request id, import the class and the call the method create.

<?php
...
use Vocento\RequestId;

class Foo
{
    ...
    public function method()
    {
        ...
        // Create a new request id
        $requestId = RequestId::create();
            
        // Create a request id from var
        $requestId = RequestId::create($currentRequestId);
        
        // Create a request id from string
        $requestId = RequestId::create('my-own-request-id');
        
        // Get the request id value
        $requestId->getId();
        
        // Get the request id header name
        $headerName = RequestId::HEADER_NAME;
        $headerName = $requestId->getHeaderName();
        ...
    }
    ...
}