61 lines
1.7 KiB
PHP
61 lines
1.7 KiB
PHP
<?php
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Framework\Http;
|
|
|
|
use App\Framework\Attributes\Singleton;
|
|
|
|
/**
|
|
* Service zur Verwaltung der Request-ID für den aktuellen Request.
|
|
* Nutzt HMAC-Signierung, um die Integrität der IDs zu gewährleisten.
|
|
*/
|
|
#[Singleton]
|
|
final class RequestIdGenerator
|
|
{
|
|
private const string REQUEST_ID_HEADER = 'X-Request-ID';
|
|
|
|
private ?RequestId $requestId = null;
|
|
private string $secret;
|
|
|
|
/**
|
|
* Initialisiert den RequestIdGenerator mit einem optionalen Secret
|
|
*/
|
|
public function __construct(string $secret = '')
|
|
{
|
|
// Secret über eine Umgebungsvariable beziehen, falls nicht angegeben
|
|
$this->secret = $secret ?: ($_ENV['APP_SECRET'] ?? 'default-secret-change-me');
|
|
}
|
|
|
|
/**
|
|
* Generiert eine neue Request-ID oder validiert und verwendet eine bestehende
|
|
*/
|
|
public function generate(): RequestId
|
|
{
|
|
if ($this->requestId === null) {
|
|
// Prüfen, ob eine Request-ID im Header vorhanden ist
|
|
$headerRequestId = $_SERVER[str_replace('-', '_', 'HTTP_' . self::REQUEST_ID_HEADER)] ?? null;
|
|
|
|
// Neue RequestId erstellen (validiert automatisch die Header-ID, falls vorhanden)
|
|
$this->requestId = new RequestId($headerRequestId, $this->secret);
|
|
}
|
|
|
|
return $this->requestId;
|
|
}
|
|
|
|
/**
|
|
* Gibt die aktuelle Request-ID zurück oder null, wenn noch keine generiert wurde
|
|
*/
|
|
public function getCurrentId(): ?RequestId
|
|
{
|
|
return $this->requestId;
|
|
}
|
|
|
|
/**
|
|
* Gibt den Header-Namen für die Request-ID zurück
|
|
*/
|
|
public static function getHeaderName(): string
|
|
{
|
|
return self::REQUEST_ID_HEADER;
|
|
}
|
|
}
|