Nexus API Reference

TracingWorkerTransport
in package
implements WorkerTransport

FinalYes
Tags
psalm-api

Tracing decorator for a WorkerTransport. On send it opens a Producer span, injects that span's context into the envelope's metadata so the trace survives the worker-thread boundary (the receiving actor opens a Consumer span from the metadata), and records transport metrics. Transport errors propagate; telemetry never breaks a send; disabled → pure delegation.

Table of Contents

Interfaces

WorkerTransport

Methods

__construct()  : mixed
close()  : void
Close the transport and release resources.
isStopped()  : bool
Whether stop() has been called on this transport.
listen()  : void
Register a listener for incoming envelopes.
send()  : void
Send an envelope to the target worker.
stop()  : void
Signal the transport to stop. The receive loop exits cooperatively on its next backoff wakeup (within ~10ms in the worst case).

Methods

isStopped()

Whether stop() has been called on this transport.

public isStopped() : bool
Return values
bool

listen()

Register a listener for incoming envelopes.

public listen(callable $onEnvelope) : void
Parameters
$onEnvelope : callable

send()

Send an envelope to the target worker.

public send(int $targetWorker, Envelope $envelope) : void
Parameters
$targetWorker : int
$envelope : Envelope

stop()

Signal the transport to stop. The receive loop exits cooperatively on its next backoff wakeup (within ~10ms in the worst case).

public stop() : void

Idempotent — calling stop() on an already-stopped transport is a no-op.

Required for graceful shutdown: without stop(), the receive loop blocks indefinitely and the worker cannot exit cleanly.


        
On this page

Search results