self::text($p['callsign'] ?? '', 64), 'vorname' => self::text($p['vorname'] ?? '', 64), 'nachname' => self::text($p['nachname'] ?? '', 64), 'fraktion' => self::text($d['fraktion'] ?? '', 80), 'teilstreitkraft' => self::text($d['teilstreitkraft'] ?? '', 80), 'rang' => self::text($d['rang'] ?? '', 120), 'verwendung' => self::text($d['verwendung'] ?? '', 80), 'status' => in_array($d['status'] ?? '', SM_STATUS, true) ? $d['status'] : 'aktiv', ]; } private static function squadKurz(array $zeile): ?array { if ($zeile['squad_id'] === null) { return null; } $squad = DB::eine('SELECT id, name, fuehrer_id FROM sm_squad WHERE id = ?', [$zeile['squad_id']]); return $squad === null ? null : [ 'id' => (int) $squad['id'], 'name' => $squad['name'], 'ist_fuehrer' => (int) $squad['fuehrer_id'] === (int) $zeile['id'], ]; } /** Vollstaendige Sicht auf einen eigenen Charakter. */ public static function eigeneZeile(array $zeile): array { return [ 'id' => (int) $zeile['id'], 'lokale_id' => $zeile['lokale_id'], 'aktennummer' => $zeile['aktennummer'], 'version' => (int) $zeile['version'], 'geaendert_am' => $zeile['geaendert_am'], 'portraet' => $zeile['portraet'] !== null, 'squad' => self::squadKurz($zeile), 'daten' => json_decode($zeile['daten'], true) ?: new stdClass(), ]; } /** Kurzfassung fuer die Liste aller Charaktere. $zeile braucht "spieler" aus sm_nutzer. */ public static function zusammenfassung(array $zeile, array $betrachter): array { return [ 'id' => (int) $zeile['id'], 'aktennummer' => $zeile['aktennummer'], 'callsign' => $zeile['callsign'], 'vorname' => $zeile['vorname'], 'nachname' => $zeile['nachname'], 'rang' => $zeile['rang'], 'fraktion' => $zeile['fraktion'], 'teilstreitkraft' => $zeile['teilstreitkraft'], 'verwendung' => $zeile['verwendung'], 'status' => $zeile['status'], 'spieler' => $zeile['spieler'], 'eigener' => (int) $zeile['nutzer_id'] === (int) $betrachter['id'], 'portraet' => $zeile['portraet'] !== null, 'squad' => self::squadKurz($zeile), 'geaendert_am' => $zeile['geaendert_am'], ]; } public static function speichern(array $nutzer, string $lokaleId, mixed $daten, ?int $basisVersion, bool $erzwingen): array { if (!preg_match('/^[0-9a-f]{32}$/', $lokaleId)) { throw new SmFehler('lokale_id_ungueltig', 'Ungültige Akten-ID.'); } if (!is_array($daten)) { throw new SmFehler('daten_ungueltig', 'Die Akte ist unvollständig.'); } if (strlen((string) json_encode($daten)) > self::MAX_DATEN_BYTES) { throw new SmFehler('akte_zu_gross', 'Die Akte ist zu groß.', 413); } $felder = self::felder($daten); $nutzerId = (int) $nutzer['id']; return DB::transaktion(function () use ($nutzerId, $lokaleId, $daten, $felder, $basisVersion, $erzwingen) { $vorhanden = DB::eine('SELECT * FROM sm_charakter WHERE nutzer_id = ? AND lokale_id = ?' . DB::sperre(), [$nutzerId, $lokaleId]); if ($vorhanden !== null) { if ($basisVersion !== null && $basisVersion !== (int) $vorhanden['version'] && !$erzwingen) { throw new SmFehler('konflikt', 'Die Akte wurde inzwischen an anderer Stelle geändert.', 409, ['charakter' => self::eigeneZeile($vorhanden)]); } $id = (int) $vorhanden['id']; $daten['aktennummer'] = $vorhanden['aktennummer']; DB::aktualisieren('sm_charakter', $felder + [ 'daten' => self::json($daten), 'version' => (int) $vorhanden['version'] + 1, 'geaendert_am' => DB::jetzt(), ], 'id = ?', [$id]); } else { $anzahl = (int) DB::wert('SELECT COUNT(*) FROM sm_charakter WHERE nutzer_id = ?', [$nutzerId]); if ($anzahl >= self::MAX_JE_NUTZER) { throw new SmFehler('zu_viele_charaktere', 'Mehr als ' . self::MAX_JE_NUTZER . ' Charaktere pro Konto sind nicht möglich.', 409); } $id = DB::einfuegen('sm_charakter', $felder + [ 'nutzer_id' => $nutzerId, 'lokale_id' => $lokaleId, 'daten' => '{}', 'version' => 1, 'erstellt_am' => DB::jetzt(), 'geaendert_am' => DB::jetzt(), ]); $daten['aktennummer'] = sprintf('SM-%s-%04d', gmdate('Y'), $id); DB::aktualisieren('sm_charakter', ['aktennummer' => $daten['aktennummer'], 'daten' => self::json($daten)], 'id = ?', [$id]); } return self::eigeneZeile(DB::eine('SELECT * FROM sm_charakter WHERE id = ?', [$id])); }); } private static function json(array $daten): string { return json_encode($daten, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_THROW_ON_ERROR); } public static function eigene(array $nutzer): array { $zeilen = DB::alle('SELECT * FROM sm_charakter WHERE nutzer_id = ? ORDER BY erstellt_am, id', [$nutzer['id']]); return array_map([self::class, 'eigeneZeile'], $zeilen); } private static function eigenerMitSperre(array $nutzer, string $lokaleId): array { $zeile = DB::eine('SELECT * FROM sm_charakter WHERE nutzer_id = ? AND lokale_id = ?' . DB::sperre(), [$nutzer['id'], $lokaleId]); if ($zeile === null) { throw new SmFehler('charakter_nicht_gefunden', 'Diese Akte gibt es auf dem Server nicht.', 404); } return $zeile; } public static function loeschen(array $nutzer, string $lokaleId): void { DB::transaktion(function () use ($nutzer, $lokaleId) { self::loeschenIntern(self::eigenerMitSperre($nutzer, $lokaleId)); }); } /** Fuer die Verwaltung: Loeschen ohne Besitzpruefung. */ public static function loeschenNachId(int $id): void { DB::transaktion(function () use ($id) { $zeile = DB::eine('SELECT * FROM sm_charakter WHERE id = ?' . DB::sperre(), [$id]); if ($zeile !== null) { self::loeschenIntern($zeile); } }); } private static function loeschenIntern(array $zeile): void { Squads::beimLoeschen($zeile); self::bildDateiLoeschen($zeile['portraet']); DB::ausfuehren('DELETE FROM sm_charakter WHERE id = ?', [$zeile['id']]); } public static function alleVonNutzerLoeschen(int $nutzerId): void { foreach (DB::alle('SELECT * FROM sm_charakter WHERE nutzer_id = ?', [$nutzerId]) as $zeile) { self::loeschenIntern($zeile); } } // -- Portraets --------------------------------------------------------- private static function bildDateiLoeschen(?string $datei): void { if ($datei !== null && preg_match('/^[0-9]+-[0-9a-f]{16}\.png$/', $datei)) { @unlink(sm_daten_ordner('portraets') . '/' . $datei); } } /** * Nimmt ein Bild an und speichert es neu als PNG, hoechstens 512 Pixel. * Das Neuzeichnen verwirft alles ausser den Bildpunkten - eingeschleuster * Code in einer Bilddatei kommt so nicht auf den Server. */ public static function portraetSetzen(array $nutzer, string $lokaleId, string $base64): array { if (!function_exists('imagecreatefromstring')) { throw new SmFehler('server_ohne_gd', 'Der Server kann gerade keine Bilder verarbeiten.', 500); } $roh = base64_decode($base64, true); if ($roh === false || $roh === '') { throw new SmFehler('bild_ungueltig', 'Das Bild konnte nicht gelesen werden.'); } if (strlen($roh) > self::MAX_BILD_BYTES) { throw new SmFehler('bild_zu_gross', 'Das Bild ist zu groß (höchstens 8 MB).', 413); } $info = @getimagesizefromstring($roh); $erlaubt = [IMAGETYPE_JPEG, IMAGETYPE_PNG, IMAGETYPE_WEBP, IMAGETYPE_GIF]; if ($info === false || !in_array($info[2], $erlaubt, true)) { throw new SmFehler('bild_ungueltig', 'Erlaubt sind JPG, PNG, WebP und GIF.'); } if ($info[0] * $info[1] > 40_000_000) { throw new SmFehler('bild_zu_gross', 'Das Bild hat zu viele Bildpunkte.', 413); } $quelle = @imagecreatefromstring($roh); if ($quelle === false) { throw new SmFehler('bild_ungueltig', 'Das Bild konnte nicht gelesen werden.'); } [$breite, $hoehe] = [imagesx($quelle), imagesy($quelle)]; $faktor = min(1, self::BILD_KANTE / max($breite, $hoehe)); $nb = max(1, (int) round($breite * $faktor)); $nh = max(1, (int) round($hoehe * $faktor)); $ziel = imagecreatetruecolor($nb, $nh); imagealphablending($ziel, false); imagesavealpha($ziel, true); imagefill($ziel, 0, 0, imagecolorallocatealpha($ziel, 0, 0, 0, 127)); imagecopyresampled($ziel, $quelle, 0, 0, 0, 0, $nb, $nh, $breite, $hoehe); return DB::transaktion(function () use ($nutzer, $lokaleId, $ziel) { $zeile = self::eigenerMitSperre($nutzer, $lokaleId); $datei = $zeile['id'] . '-' . Sicherheit::zufall(8) . '.png'; if (!imagepng($ziel, sm_daten_ordner('portraets') . '/' . $datei, 6)) { throw new SmFehler('bild_speichern', 'Das Bild konnte nicht gespeichert werden.', 500); } self::bildDateiLoeschen($zeile['portraet']); DB::aktualisieren('sm_charakter', ['portraet' => $datei, 'geaendert_am' => DB::jetzt()], 'id = ?', [$zeile['id']]); return self::eigeneZeile(DB::eine('SELECT * FROM sm_charakter WHERE id = ?', [$zeile['id']])); }); } public static function portraetEntfernen(array $nutzer, string $lokaleId): array { return DB::transaktion(function () use ($nutzer, $lokaleId) { $zeile = self::eigenerMitSperre($nutzer, $lokaleId); self::bildDateiLoeschen($zeile['portraet']); DB::aktualisieren('sm_charakter', ['portraet' => null, 'geaendert_am' => DB::jetzt()], 'id = ?', [$zeile['id']]); return self::eigeneZeile(DB::eine('SELECT * FROM sm_charakter WHERE id = ?', [$zeile['id']])); }); } /** Pfad zur Bilddatei eines Charakters oder null. */ public static function bildPfad(int $id): ?string { $datei = DB::wert('SELECT portraet FROM sm_charakter WHERE id = ?', [$id]); if (!is_string($datei) || !preg_match('/^[0-9]+-[0-9a-f]{16}\.png$/', $datei)) { return null; } $pfad = sm_daten_ordner('portraets') . '/' . $datei; return is_file($pfad) ? $pfad : null; } // -- Fuer alle sichtbar ------------------------------------------------- private const LISTE_SQL = 'SELECT c.*, n.benutzername AS spieler FROM sm_charakter c JOIN sm_nutzer n ON n.id = c.nutzer_id WHERE n.gesperrt = 0'; public static function alle(array $nutzer, string $suche = '', string $fraktion = ''): array { $sql = self::LISTE_SQL; $werte = []; $suche = trim($suche); if ($suche !== '') { $muster = '%' . str_replace(['!', '%', '_'], ['!!', '!%', '!_'], mb_substr($suche, 0, 64)) . '%'; $sql .= " AND (c.callsign LIKE ? ESCAPE '!' OR c.vorname LIKE ? ESCAPE '!'" . " OR c.nachname LIKE ? ESCAPE '!' OR n.benutzername LIKE ? ESCAPE '!')"; array_push($werte, $muster, $muster, $muster, $muster); } if (trim($fraktion) !== '') { $sql .= ' AND c.fraktion = ?'; $werte[] = trim($fraktion); } $sql .= ' ORDER BY c.callsign, c.nachname, c.id LIMIT 500'; return array_map(fn($zeile) => self::zusammenfassung($zeile, $nutzer), DB::alle($sql, $werte)); } public static function ansehen(array $nutzer, int $id): array { $zeile = DB::eine(self::LISTE_SQL . ' AND c.id = ?', [$id]); if ($zeile === null) { throw new SmFehler('charakter_nicht_gefunden', 'Diesen Charakter gibt es nicht.', 404); } return self::zusammenfassung($zeile, $nutzer) + ['daten' => json_decode($zeile['daten'], true) ?: new stdClass()]; } }