time(), 'until' => time() + $maxSeconds, ])); } public static function deactivate(): void { $file = self::file(); if (is_file($file)) { @unlink($file); } } /** * @return array{since:int, until:int}|null */ public static function info(): ?array { $file = self::file(); if (!is_file($file)) { return null; } $data = json_decode((string)@file_get_contents($file), true); if (!is_array($data) || !isset($data['until'])) { // Aeltere oder beschaedigte Markierung: ab der Dateizeit rechnen, // damit auch sie von allein ablaeuft. $since = (int)@filemtime($file); return ['since' => $since, 'until' => $since + self::DEFAULT_MAX_SECONDS]; } return ['since' => (int)($data['since'] ?? 0), 'until' => (int)$data['until']]; } public static function isActive(): bool { $info = self::info(); if ($info === null) { return false; } if ($info['until'] <= time()) { self::deactivate(); return false; } return true; } /** Verbleibende Sekunden, mindestens 5 - fuer den Retry-After-Kopf. */ public static function retryAfter(): int { $info = self::info(); if ($info === null) { return 0; } return max(5, $info['until'] - time()); } }