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. All-zero SpanIds are rejected at construction time per W3C spec.

Example usage:

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

Interfaces

Stringable

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.
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.

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 or is all zeros

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 or represents all zeros

Return values
self

generate()

Generate a new random SpanId.

public static generate() : self
Return values
self

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