vendor/open-telemetry/api/Trace/Propagation/TraceContextValidator.php


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

<?php

declare(strict_types=1);

namespace OpenTelemetry\API\Trace\Propagation;

use function strlen;

class TraceContextValidator
{
    public const TRACE_FLAG_LENGTH = 2;
    public const TRACE_VERSION_REGEX = '/^(?!ff)[\da-f]{2}$/';

    /**
     * @param string $traceVersion
     * @return bool Returns a value that indicates whether a trace version is valid.
     */
    public static function isValidTraceVersion(string $traceVersion): bool
    {
        return 1 === preg_match(self::TRACE_VERSION_REGEX, $traceVersion);
    }

    /**
     * @return bool Returns a value that indicates whether trace flag is valid
     * TraceFlags must be exactly 1 bytes (1 char) representing a bit field
     */
    public static function isValidTraceFlag(string $traceFlag): bool
    {
        return ctype_xdigit($traceFlag) && strlen($traceFlag) === self::TRACE_FLAG_LENGTH;
    }
}