rinkplanner/hub/app/util.php
torsten 9819311403 feat: Website und Hub zweisprachig (Deutsch/Englisch)
Website (rinkplanner.programmschmiede.de) liegt jetzt im Repo unter web/:
Sprachweiche nach Accept-Language (der User-Agent enthält keine Sprache),
/de/ und /en/ als eigene URLs mit hreflang, Cookie für die manuelle Wahl,
Texte in web/i18n.php, Markup in web/template.php. Deployment über
tools/deploy_web.sh (--sync, --check, --all); /index.html leitet weiter.

Hub: optionale englische Oberfläche über den DE/EN-Umschalter, Cookie
RHUB_LANG, Route /language. Alle Texte (Views, Meldungen, Validierung,
API-messages) stehen in hub/app/i18n_strings.php und laufen über t();
Datum und Zahlen folgen der Sprache. Die API behält ihre code-Felder und
antwortet ohne Cookie weiter deutsch.

deploy_hub.sh --check prüft jetzt Schlüsselparität und fehlende t()-Schlüssel.
Doku: docs/website.md neu, docs/hub.md und AGENTS.md ergänzt.
2026-11-12 22:38:32 +01:00

333 lines
8.8 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;
}
/** Cache-Buster für /assets/: bei Änderungen an hub.css erhöhen. */
const HUB_ASSET_VERSION = '3';
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'));
$format = hub_locale() === 'en' ? 'Y-m-d H:i' : 'd.m.Y H:i';
return $date->setTimezone(new DateTimeZone('Europe/Berlin'))->format($format);
} catch (Throwable) {
return '–';
}
}
/** Zahl mit den Trennzeichen der aktuellen Sprache. */
function fmt_number(float $value, int $decimals = 1): string
{
if (hub_locale() === 'en') {
return number_format($value, $decimals, '.', ',');
}
return number_format($value, $decimals, ',', '.');
}
function human_bytes(int|float|null $bytes): string
{
$bytes = (float) ($bytes ?? 0);
if ($bytes < 1024) {
return fmt_number($bytes, 0) . ' B';
}
$units = ['KB', 'MB', 'GB'];
$index = -1;
do {
$bytes /= 1024;
$index++;
} while ($bytes >= 1024 && $index < count($units) - 1);
return fmt_number($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, t('auth.session_expired'));
}
}
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 = null): void
{
$content = render($view, $data);
echo render('layout', [
'title' => $title ?? t('page.title_default'),
'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' => t('page.title_error', ['status' => $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 t('password.min');
}
if ($length > 200) {
return t('password.max');
}
if ($username !== '' && mb_strtolower($password) === mb_strtolower($username)) {
return t('password.same_as_username');
}
return null;
}
function hub_log(string $message): void
{
error_log('Hub: ' . $message);
}