summaryrefslogtreecommitdiff
path: root/vendor/open-telemetry/api/Trace/SpanContext.php
diff options
context:
space:
mode:
Diffstat (limited to 'vendor/open-telemetry/api/Trace/SpanContext.php')
-rw-r--r--vendor/open-telemetry/api/Trace/SpanContext.php127
1 files changed, 127 insertions, 0 deletions
diff --git a/vendor/open-telemetry/api/Trace/SpanContext.php b/vendor/open-telemetry/api/Trace/SpanContext.php
new file mode 100644
index 000000000..7da7c0701
--- /dev/null
+++ b/vendor/open-telemetry/api/Trace/SpanContext.php
@@ -0,0 +1,127 @@
+<?php
+
+declare(strict_types=1);
+
+namespace OpenTelemetry\API\Trace;
+
+use function hex2bin;
+
+final class SpanContext implements SpanContextInterface
+{
+ private static ?SpanContextInterface $invalidContext = null;
+
+ /**
+ * @see https://www.w3.org/TR/trace-context/#trace-flags
+ * @see https://www.w3.org/TR/trace-context/#sampled-flag
+ */
+ private bool $isSampled;
+
+ private string $traceId;
+ private string $spanId;
+ private ?TraceStateInterface $traceState;
+ private bool $isValid = true;
+ private bool $isRemote;
+ private int $traceFlags;
+
+ private function __construct(
+ string $traceId,
+ string $spanId,
+ int $traceFlags,
+ bool $isRemote,
+ TraceStateInterface $traceState = null
+ ) {
+ // TraceId must be exactly 16 bytes (32 chars) and at least one non-zero byte
+ // SpanId must be exactly 8 bytes (16 chars) and at least one non-zero byte
+ if (!SpanContextValidator::isValidTraceId($traceId) || !SpanContextValidator::isValidSpanId($spanId)) {
+ $traceId = SpanContextValidator::INVALID_TRACE;
+ $spanId = SpanContextValidator::INVALID_SPAN;
+ $this->isValid=false;
+ }
+
+ $this->traceId = $traceId;
+ $this->spanId = $spanId;
+ $this->traceState = $traceState;
+ $this->isRemote = $isRemote;
+ $this->isSampled = ($traceFlags & TraceFlags::SAMPLED) === TraceFlags::SAMPLED;
+ $this->traceFlags = $traceFlags;
+ }
+
+ public function getTraceId(): string
+ {
+ return $this->traceId;
+ }
+
+ public function getTraceIdBinary(): string
+ {
+ return hex2bin($this->traceId);
+ }
+
+ public function getSpanId(): string
+ {
+ return $this->spanId;
+ }
+
+ public function getSpanIdBinary(): string
+ {
+ return hex2bin($this->spanId);
+ }
+
+ public function getTraceState(): ?TraceStateInterface
+ {
+ return $this->traceState;
+ }
+
+ public function isSampled(): bool
+ {
+ return $this->isSampled;
+ }
+
+ public function isValid(): bool
+ {
+ return $this->isValid;
+ }
+
+ public function isRemote(): bool
+ {
+ return $this->isRemote;
+ }
+
+ public function getTraceFlags(): int
+ {
+ return $this->traceFlags;
+ }
+
+ /** @inheritDoc */
+ public static function createFromRemoteParent(string $traceId, string $spanId, int $traceFlags = TraceFlags::DEFAULT, ?TraceStateInterface $traceState = null): SpanContextInterface
+ {
+ return new self(
+ $traceId,
+ $spanId,
+ $traceFlags,
+ true,
+ $traceState,
+ );
+ }
+
+ /** @inheritDoc */
+ public static function create(string $traceId, string $spanId, int $traceFlags = TraceFlags::DEFAULT, ?TraceStateInterface $traceState = null): SpanContextInterface
+ {
+ return new self(
+ $traceId,
+ $spanId,
+ $traceFlags,
+ false,
+ $traceState,
+ );
+ }
+
+ /** @inheritDoc */
+ public static function getInvalid(): SpanContextInterface
+ {
+ if (null === self::$invalidContext) {
+ self::$invalidContext = self::create(SpanContextValidator::INVALID_TRACE, SpanContextValidator::INVALID_SPAN, 0);
+ }
+
+ return self::$invalidContext;
+ }
+}