format('d.m.Y H:i'); } function e(mixed $value): string { return htmlspecialchars((string) $value, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8'); } function url(string $path = '/'): string { $base = rtrim((string) config('app.base_path', ''), '/'); if ($path === '' || $path[0] !== '/') { $path = '/' . $path; } return $base . $path; } /** Cache-Buster: bei Änderungen an app.css/app.js erhöhen. */ const WS_ASSET_VERSION = '5'; function asset(string $path): string { return url('/assets/' . ltrim($path, '/')) . '?v=' . WS_ASSET_VERSION; } function redirect(string $path, int $status = 303): never { header('Location: ' . url($path), true, $status); exit; } function current_path(): string { $path = (string) parse_url((string) ($_SERVER['REQUEST_URI'] ?? '/'), PHP_URL_PATH); $base = rtrim((string) config('app.base_path', ''), '/'); if ($base !== '' && str_starts_with($path, $base)) { $path = substr($path, strlen($base)); } return '/' . trim($path, '/'); } function client_ip(): string { $ip = (string) ($_SERVER['REMOTE_ADDR'] ?? ''); return $ip !== '' ? substr($ip, 0, 45) : '0.0.0.0'; } function request_method(): string { return strtoupper((string) ($_SERVER['REQUEST_METHOD'] ?? 'GET')); } function is_post(): bool { return request_method() === 'POST'; } function post_string(string $key, string $default = ''): string { $value = $_POST[$key] ?? $default; return is_string($value) ? trim($value) : $default; } function post_int(string $key, int $default = 0): int { $value = $_POST[$key] ?? null; if (is_int($value)) { return $value; } return is_string($value) && preg_match('/^-?\d+$/', trim($value)) === 1 ? (int) $value : $default; } function query_string(string $key, string $default = ''): string { $value = $_GET[$key] ?? $default; return is_string($value) ? trim($value) : $default; } function query_int(string $key, int $default = 0): int { $value = $_GET[$key] ?? null; return is_numeric($value) ? (int) $value : $default; } function flash(string $type, string $message): void { $_SESSION['flash'][] = ['type' => $type, 'message' => $message]; } function flash_pull(): array { $items = $_SESSION['flash'] ?? []; unset($_SESSION['flash']); return is_array($items) ? $items : []; } function csrf_token(): string { if (empty($_SESSION['csrf'])) { $_SESSION['csrf'] = bin2hex(random_bytes(32)); } return (string) $_SESSION['csrf']; } function csrf_field(): string { return ''; } function csrf_valid(): bool { $sent = $_POST['_csrf'] ?? ''; return is_string($sent) && $sent !== '' && hash_equals(csrf_token(), $sent); } function require_post(): void { if (!is_post()) { abort_page(405, 'Diese Aktion erfordert ein Formular.'); } if (!csrf_valid()) { abort_page(419, 'Die Sitzung ist abgelaufen. Bitte erneut versuchen.'); } } function abort_page(int $status, string $message): never { http_response_code($status); $user = auth_user(); $title = 'Fehler ' . $status; $content = '

' . e($title) . '

' . e($message) . '

' . '

Zurück zur Übersicht

'; require WS_ROOT . '/views/layout.php'; exit; } /** Kürzt Text auf eine Zeichenzahl (mb-safe) und ergänzt eine Ellipse. */ function shorten(string $text, int $max): string { if (mb_strlen($text, 'UTF-8') <= $max) { return $text; } return rtrim(mb_substr($text, 0, $max - 1, 'UTF-8')) . '…'; }