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 = '';
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')) . '…';
}