Flow PHP

SpanId implements Stringable

Read onlyYes
FinalYes

An 8-byte (64-bit) span identifier compatible with OpenTelemetry W3C Trace Context.

SpanIds uniquely identify a span within a trace. An all-zero SpanId is considered "invalid" and indicates no active span.

Example usage:

$spanId = SpanId::generate();
echo $spanId->toHex(); // "00f067aa0ba902b7"

// Invalid span ID (all zeros)
$invalid = SpanId::invalid();
echo $invalid->isValid(); // false

Interfaces

Stringable

Constants

INVALID  = '0000000000000000'

Methods

__toString()  : string
equals()  : bool
Check if this SpanId equals another SpanId.
fromArray()  : self
Create a SpanId from a normalized array representation.
fromBytes()  : self
Create a SpanId from 8 raw bytes.
fromHex()  : self
Create a SpanId from a 16-character hexadecimal string.
generate()  : self
Generate a new random SpanId.
invalid()  : self
Get an invalid SpanId (all zeros).
isValid()  : bool
Check if this SpanId is valid (not all zeros).
normalize()  : array{hex: string}
Normalize the SpanId to an array representation for serialization.
toBytes()  : string
Get the SpanId as 8 raw bytes.
toHex()  : string
Get the SpanId as a 16-character lowercase hexadecimal string.

Constants

INVALID

public mixed INVALID = '0000000000000000'

Methods

__toString()

public __toString() : string
Return values
string

equals()

Check if this SpanId equals another SpanId.

public equals(self $other) : bool
Parameters
$other : self
Return values
bool

fromArray()

Create a SpanId from a normalized array representation.

public static fromArray(array{hex: string} $data) : self
Parameters
$data : array{hex: string}

Normalized SpanId data

Tags
throws
InvalidArgumentException

if the data is invalid

Return values
self

fromBytes()

Create a SpanId from 8 raw bytes.

public static fromBytes(string $bytes) : self
Parameters
$bytes : string

8 raw bytes

Tags
throws
InvalidArgumentException

if the byte string is not exactly 8 bytes

Return values
self

fromHex()

Create a SpanId from a 16-character hexadecimal string.

public static fromHex(string $hex) : self
Parameters
$hex : string

16-character lowercase hexadecimal string

Tags
throws
InvalidArgumentException

if the hex string is invalid

Return values
self

generate()

Generate a new random SpanId.

public static generate() : self
Return values
self

invalid()

Get an invalid SpanId (all zeros).

public static invalid() : self

Invalid SpanIds indicate no active span context.

Return values
self

isValid()

Check if this SpanId is valid (not all zeros).

public isValid() : bool

An all-zero SpanId indicates no active span context.

Return values
bool

normalize()

Normalize the SpanId to an array representation for serialization.

public normalize() : array{hex: string}
Return values
array{hex: string}

toBytes()

Get the SpanId as 8 raw bytes.

public toBytes() : string
Return values
string

toHex()

Get the SpanId as a 16-character lowercase hexadecimal string.

public toHex() : string
Return values
string 

        

        
    




    

    

                                

                

                                
    

        On this page

        
    


                

                            

            

    

        

            
Search results