rinkplanner/hub/app/util.php
torsten 055a2919c3 feat: Kür-Hub mit Einladungen, Uploads und API
- PHP-App unter hub/ für rinkplanner-hub.programmschmiede.de
- MariaDB-Schema, Argon2id, Sessions, CSRF und Ratenbegrenzung
- Einladungscodes, Admin-Bereich und Kür-Pakete mit Audiodatei
- JSON-API v1 mit Bearer-Tokens für die Godot-App
- Deployment und Erstinstallation über tools/deploy_hub.sh
- Doku und Credentials-Vorlage ergänzt
2026-11-11 13:14:26 +01:00

320 lines
8.4 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?php
declare(strict_types=1);
/**
* Kleine Helfer: Konfiguration, Session, CSRF, Ausgabe, Zeit und Dateien.
*/
function config(string $key, mixed $default = null): mixed
{
$value = $GLOBALS['hub_config'] ?? [];
foreach (explode('.', $key) as $part) {
if (!is_array($value) || !array_key_exists($part, $value)) {
return $default;
}
$value = $value[$part];
}
return $value;
}
function is_https(): bool
{
if (!empty($_SERVER['HTTPS']) && strtolower((string) $_SERVER['HTTPS']) !== 'off') {
return true;
}
return strtolower((string) ($_SERVER['HTTP_X_FORWARDED_PROTO'] ?? '')) === 'https';
}
function security_headers(): void
{
header('X-Content-Type-Options: nosniff');
header('X-Frame-Options: DENY');
header('X-Robots-Tag: noindex, nofollow, noarchive');
header('Referrer-Policy: same-origin');
header('Permissions-Policy: camera=(), microphone=(), geolocation=()');
header(
"Content-Security-Policy: default-src 'self'; img-src 'self' data:; "
. "style-src 'self'; script-src 'none'; media-src 'self'; "
. "form-action 'self'; frame-ancestors 'none'; base-uri 'none'"
);
header('Cache-Control: no-store');
if (is_https()) {
header('Strict-Transport-Security: max-age=15552000');
}
}
function start_session(): void
{
if (session_status() === PHP_SESSION_ACTIVE) {
return;
}
$absolute = (int) config('app.session_absolute_seconds', 2592000);
ini_set('session.use_strict_mode', '1');
ini_set('session.use_only_cookies', '1');
ini_set('session.cookie_httponly', '1');
ini_set('session.cookie_samesite', 'Lax');
ini_set('session.cookie_secure', is_https() ? '1' : '0');
ini_set('session.cookie_path', '/');
ini_set('session.gc_maxlifetime', (string) $absolute);
session_name('RHUB_SESSION');
session_start();
}
function utc_now(): string
{
return gmdate('Y-m-d H:i:s');
}
function utc_after(int $seconds): string
{
return gmdate('Y-m-d H:i:s', time() + $seconds);
}
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;
}
function redirect(string $path, int $status = 303): never
{
header('Location: ' . url($path), true, $status);
exit;
}
function client_ip(): string
{
$ip = (string) ($_SERVER['REMOTE_ADDR'] ?? '');
return $ip !== '' ? substr($ip, 0, 45) : '0.0.0.0';
}
function user_agent(): string
{
return substr((string) ($_SERVER['HTTP_USER_AGENT'] ?? ''), 0, 255);
}
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 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 e_attr(mixed $value): string
{
return e($value);
}
function fmt_dt(?string $utc): string
{
if ($utc === null || $utc === '') {
return '–';
}
try {
$date = new DateTimeImmutable($utc, new DateTimeZone('UTC'));
return $date->setTimezone(new DateTimeZone('Europe/Berlin'))->format('d.m.Y H:i');
} catch (Throwable) {
return '–';
}
}
function human_bytes(int|float|null $bytes): string
{
$bytes = (float) ($bytes ?? 0);
if ($bytes < 1024) {
return number_format($bytes, 0, ',', '.') . ' B';
}
$units = ['KB', 'MB', 'GB'];
$index = -1;
do {
$bytes /= 1024;
$index++;
} while ($bytes >= 1024 && $index < count($units) - 1);
return number_format($bytes, 1, ',', '.') . ' ' . $units[$index];
}
function truncate_text(string $value, int $length): string
{
if (mb_strlen($value, 'UTF-8') <= $length) {
return $value;
}
return mb_substr($value, 0, max(0, $length - 1), 'UTF-8') . '…';
}
function clean_filename(string $name): string
{
$name = basename(str_replace('\\', '/', $name));
$name = preg_replace('/[\x00-\x1F\x7F]/u', '', $name) ?? '';
$name = trim($name);
if ($name === '' || $name === '.' || $name === '..') {
return 'datei';
}
return mb_substr($name, 0, 190, 'UTF-8');
}
/** Dateiname für Content-Disposition: ASCII-Fallback plus UTF-8-Variante. */
function content_disposition(string $filename): string
{
$filename = clean_filename($filename);
$ascii = preg_replace('/[^\x20-\x7E]/', '_', $filename) ?? 'datei';
$ascii = str_replace(['"', '\\', ';'], '_', $ascii);
return 'attachment; filename="' . $ascii . '"; filename*=UTF-8\'\'' . rawurlencode($filename);
}
function flash(string $type, string $message): void
{
$_SESSION['flash'][] = ['type' => $type, 'message' => $message];
}
function flash_secret(string $label, string $value): void
{
$_SESSION['flash'][] = ['type' => 'secret', 'label' => $label, 'value' => $value];
}
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 '<input type="hidden" name="_csrf" value="' . e(csrf_token()) . '">';
}
function csrf_valid(): bool
{
$sent = $_POST['_csrf'] ?? '';
return is_string($sent) && $sent !== '' && hash_equals(csrf_token(), $sent);
}
function csrf_require(): void
{
if (!csrf_valid()) {
abort_page(419, 'Die Sitzung ist abgelaufen. Bitte die Seite neu laden.');
}
}
function wants_json(): bool
{
$path = (string) parse_url((string) ($_SERVER['REQUEST_URI'] ?? ''), PHP_URL_PATH);
return str_starts_with($path, '/api/')
|| str_contains(strtolower((string) ($_SERVER['HTTP_ACCEPT'] ?? '')), 'application/json');
}
function json_response(mixed $data, int $status = 200): never
{
http_response_code($status);
header('Content-Type: application/json; charset=utf-8');
echo json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
exit;
}
function json_input(): array
{
$raw = file_get_contents('php://input');
if (is_string($raw) && $raw !== '') {
$decoded = json_decode($raw, true);
if (is_array($decoded)) {
return $decoded;
}
}
return $_POST;
}
function render(string $view, array $data = []): string
{
$file = HUB_ROOT . '/views/' . $view . '.php';
if (!is_file($file)) {
throw new RuntimeException('View fehlt: ' . $view);
}
extract($data, EXTR_SKIP);
ob_start();
require $file;
return (string) ob_get_clean();
}
function render_page(string $view, array $data = [], string $title = 'Kür-Hub'): void
{
$content = render($view, $data);
echo render('layout', [
'title' => $title,
'content' => $content,
'user' => auth_user(),
]);
}
function abort_page(int $status, string $message): never
{
http_response_code($status);
$content = render('error', ['status' => $status, 'message' => $message]);
echo render('layout', [
'title' => 'Fehler ' . $status,
'content' => $content,
'user' => auth_user(),
]);
exit;
}
function abort_api(int $status, string $code, string $message): never
{
json_response(['error' => ['code' => $code, 'message' => $message]], $status);
}
function password_policy_error(string $password, string $username = ''): ?string
{
$length = mb_strlen($password, 'UTF-8');
if ($length < 10) {
return 'Das Passwort muss mindestens 10 Zeichen lang sein.';
}
if ($length > 200) {
return 'Das Passwort darf höchstens 200 Zeichen lang sein.';
}
if ($username !== '' && mb_strtolower($password) === mb_strtolower($username)) {
return 'Das Passwort darf nicht dem Benutzernamen entsprechen.';
}
return null;
}
function hub_log(string $message): void
{
error_log('Hub: ' . $message);
}