*/ private array $features = []; private string $lastError = ''; public function __construct( private string $host, private int $port, private string $secure, private float $timeout = 15.0, ) { } public function connect(): void { $socket = $this->open($this->host); if ($socket === false) { // Manche Netze haben kein IPv6, der Name liefert aber eine AAAA-Adresse: // zweiter Versuch über die IPv4-Adresse, Zertifikat bleibt an den Namen gebunden. $ipv4 = gethostbyname($this->host); if ($ipv4 !== $this->host && filter_var($ipv4, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4) !== false) { $socket = $this->open($ipv4); } } if ($socket === false) { throw new RuntimeException(sprintf('SMTP-Verbindung zu %s:%d fehlgeschlagen (%s)', $this->host, $this->port, $this->lastError !== '' ? $this->lastError : 'Grund unbekannt')); } stream_set_timeout($socket, (int) max(1, (int) ceil($this->timeout))); $this->socket = $socket; $this->expect(220); $this->ehlo(); if ($this->secure === 'tls') { if (!array_key_exists('starttls', $this->features)) { throw new RuntimeException('Server bietet kein STARTTLS an.'); } $this->cmd('STARTTLS', 220); $ok = @stream_socket_enable_crypto($socket, true, STREAM_CRYPTO_METHOD_TLS_CLIENT); if ($ok !== true) { throw new RuntimeException('TLS-Aushandlung fehlgeschlagen (Zertifikat oder Protokoll).'); } $this->ehlo(); } } public function authenticate(string $user, string $password): void { $mechanisms = strtoupper($this->features['auth'] ?? ''); if (str_contains($mechanisms, 'PLAIN')) { $this->cmd('AUTH PLAIN ' . base64_encode("\0" . $user . "\0" . $password), 235); return; } if (str_contains($mechanisms, 'LOGIN')) { $this->cmd('AUTH LOGIN', 334); $this->cmd(base64_encode($user), 334); $this->cmd(base64_encode($password), 235); return; } throw new RuntimeException('Server bietet weder AUTH PLAIN noch AUTH LOGIN an.'); } public function sendMail(string $from, string $to, string $raw): void { $this->cmd('MAIL FROM:<' . $from . '>', 250); $this->cmd('RCPT TO:<' . $to . '>', 250); $this->cmd('DATA', 354); // Dot-Stuffing nach RFC 5321: eine Zeile, die mit "." beginnt, wird verdoppelt. $stuffed = preg_replace('/^\./m', '..', str_replace(["\r\n", "\r"], "\n", $raw)); $this->writeRaw(str_replace("\n", "\r\n", (string) $stuffed) . "\r\n.\r\n"); $this->expect(250); } /** @return resource */ private function context() { return stream_context_create(['ssl' => [ 'verify_peer' => true, 'verify_peer_name' => true, 'peer_name' => $this->host, 'SNI_enabled' => true, 'crypto_method' => STREAM_CRYPTO_METHOD_TLS_CLIENT, ]]); } /** @return resource|false */ private function open(string $target) { $scheme = $this->secure === 'ssl' ? 'ssl' : 'tcp'; $errno = 0; $errstr = ''; $socket = @stream_socket_client( $scheme . '://' . $target . ':' . $this->port, $errno, $errstr, $this->timeout, STREAM_CLIENT_CONNECT, $this->context() ); if ($socket === false) { $this->lastError = $errstr !== '' ? $errstr : 'Fehler ' . $errno; return false; } return $socket; } public function quit(): void { if ($this->socket === null) { return; } try { @fwrite($this->socket, "QUIT\r\n"); } catch (Throwable) { // Abschluss ist nicht kritisch. } @fclose($this->socket); $this->socket = null; } private function ehlo(): void { $name = gethostname(); $response = $this->cmd('EHLO ' . ($name !== false && $name !== '' ? $name : 'localhost'), 250); $this->features = []; foreach (array_slice($response, 1) as $line) { $parts = preg_split('/[\s=]+/', trim($line), 2); if (!is_array($parts) || $parts[0] === '') { continue; } $this->features[strtolower($parts[0])] = $parts[1] ?? ''; } if (!array_key_exists('auth', $this->features)) { // Manche Server liefern "AUTH=LOGIN PLAIN" – oben bereits normalisiert. $this->features['auth'] = $this->features['auth'] ?? ''; } } /** @return list Antwortzeilen ohne Statuscode */ private function cmd(string $line, int $expected): array { $this->writeRaw($line . "\r\n"); return $this->expect($expected); } /** @return list */ private function expect(int $expected): array { [$code, $lines] = $this->read(); if ($code !== $expected) { throw new RuntimeException(sprintf('SMTP-Dialog: Code %d statt %d (%s)', $code, $expected, implode(' ', $lines))); } return $lines; } /** @return array{0:int,1:list} */ private function read(): array { if ($this->socket === null) { throw new RuntimeException('Keine SMTP-Verbindung.'); } $lines = []; while (true) { $line = fgets($this->socket, 2048); if ($line === false) { throw new RuntimeException('SMTP-Antwort blieb aus (Zeitüberschreitung).'); } $line = rtrim($line, "\r\n"); if (preg_match('/^(\d{3})([ -])(.*)$/', $line, $m) !== 1) { throw new RuntimeException('Unerwartete SMTP-Antwort: ' . substr($line, 0, 80)); } $lines[] = $m[3]; if ($m[2] === ' ') { return [(int) $m[1], $lines]; } } } private function writeRaw(string $data): void { if ($this->socket === null) { throw new RuntimeException('Keine SMTP-Verbindung.'); } $remaining = $data; while ($remaining !== '') { $written = @fwrite($this->socket, $remaining); if ($written === false || $written === 0) { throw new RuntimeException('Schreiben auf die SMTP-Verbindung fehlgeschlagen.'); } $remaining = substr($remaining, $written); } } } /** @return array */ function mail_settings(): array { $mail = config('mail', []); return is_array($mail) ? $mail : []; } /** Ist der Versand eingerichtet und vollständig konfiguriert? */ function mail_ready(): bool { $settings = mail_settings(); return trim((string) ($settings['host'] ?? '')) !== '' && trim((string) ($settings['from'] ?? '')) !== '' && trim((string) ($settings['user'] ?? '')) !== '' && (string) ($settings['password'] ?? '') !== ''; } function mail_log(string $message): void { error_log('Westreiche-Mail: ' . $message); } /** Kodiert einen Header-Wert als RFC-2047-Wort (mit Folding für lange Betreffs). */ function mail_encode_header(string $value): string { if (preg_match('/^[\x20-\x7E]*$/', $value) === 1) { return $value; } $encoded = base64_encode($value); $words = str_split($encoded, 60); return implode("\r\n ", array_map(static fn (string $chunk): string => '=?UTF-8?B?' . $chunk . '?=', $words)); } function mail_display_name(string $name): string { if ($name === '') { return ''; } if (preg_match('/^[\x20-\x7E]+$/', $name) === 1) { return '"' . str_replace(['\\', '"'], ['\\\\', '\\"'], $name) . '"'; } return mail_encode_header($name); } /** Baut die vollständige Nachricht (Header + base64-Textkörper) mit CRLF-Zeilen. */ function mail_build(string $from, string $fromName, string $to, string $subject, string $text): string { $address = (string) substr((string) strrchr($from, '@'), 1); $domain = $address !== '' ? $address : 'zauberturm.de'; $name = mail_display_name($fromName); $headers = [ 'Date: ' . date('r'), 'From: ' . ($name !== '' ? $name . ' <' . $from . '>' : $from), 'To: ' . $to, 'Subject: ' . mail_encode_header($subject), 'Message-ID: <' . bin2hex(random_bytes(12)) . '@' . $domain . '>', 'MIME-Version: 1.0', 'Content-Type: text/plain; charset=UTF-8', 'Content-Transfer-Encoding: base64', 'X-Mailer: Westreiche Charakterverwaltung', ]; $normalized = str_replace(["\r\n", "\r"], "\n", $text); $body = rtrim(chunk_split(base64_encode($normalized), 76, "\r\n"), "\r\n"); return implode("\r\n", $headers) . "\r\n\r\n" . $body; } /** Verschickt eine reine Textmail; wirft bei Fehlern RuntimeException. */ function mail_send(string $to, string $subject, string $text): void { if (!mail_ready()) { throw new RuntimeException('Mailversand ist nicht eingerichtet.'); } if (filter_var($to, FILTER_VALIDATE_EMAIL) === false) { throw new RuntimeException('Ungültige Empfängeradresse: ' . $to); } $settings = mail_settings(); $secure = strtolower(trim((string) ($settings['secure'] ?? 'tls'))); if (!in_array($secure, ['tls', 'ssl'], true)) { $secure = 'tls'; } $port = (int) ($settings['port'] ?? 0); $from = trim((string) $settings['from']); $client = new WsSmtp( trim((string) $settings['host']), $port > 0 ? $port : ($secure === 'ssl' ? 465 : 587), $secure, (float) ($settings['timeout'] ?? 15) ); try { $client->connect(); $client->authenticate(trim((string) $settings['user']), (string) $settings['password']); $client->sendMail( $from, $to, mail_build($from, trim((string) ($settings['from_name'] ?? '')), $to, $subject, $text) ); } finally { $client->quit(); } } /** Text der Einladungsmail (auch für Passwort-Zurücksetzen passend). */ function mail_invite_text(array $user, array $invite): string { $name = trim((string) ($user['display_name'] ?? '')); if ($name === '') { $name = trim((string) ($user['username'] ?? '')); } $salutation = $name !== '' ? 'Hallo ' . $name . ',' : 'Hallo,'; $base = rtrim((string) config('app.public_url', ''), '/'); $path = rtrim((string) config('app.base_path', ''), '/'); $start = $base . ($path !== '' && !str_ends_with($base, $path) ? $path : ''); $expires = (new DateTimeImmutable((string) $invite['expires_at'], new DateTimeZone('UTC'))) ->setTimezone(new DateTimeZone('Europe/Berlin')) ->format('d.m.Y H:i'); return implode("\n", [ $salutation, '', 'für dich gibt es einen Zugang zur Westreiche-Chronik, dem Charakterverwalter', 'unserer Runde: ' . $start . '/', '', 'Bitte vergib dein Passwort über diesen Link – er ist einmal verwendbar und', 'gültig bis ' . $expires . ' Uhr:', '', $invite['url'], '', 'Danach kannst du dich mit deinem Benutzernamen oder dieser Adresse anmelden.', 'Wenn du nichts davon erwartest, ignoriere die Nachricht – ohne den Link', 'lässt sich nichts ändern.', '', 'Mögen die Sterne günstig stehen', 'die Chronik der Zauberturm-Runde', ]); } /** * Verschickt die Einladung, wenn möglich, und liefert den Status für die * Rückmeldung im Admin-Formular. * * @return array{sent:bool, to:string|null, reason:string} */ function mail_invite_result(array $user, array $invite): array { if (!mail_ready()) { return ['sent' => false, 'to' => null, 'reason' => 'not_configured']; } $to = trim((string) ($user['email'] ?? '')); if ($to === '') { return ['sent' => false, 'to' => null, 'reason' => 'no_address']; } try { mail_send($to, 'Dein Zugang zur Westreiche-Chronik', mail_invite_text($user, $invite)); return ['sent' => true, 'to' => $to, 'reason' => 'ok']; } catch (Throwable $error) { mail_log('Einladung an ' . $to . ' fehlgeschlagen: ' . $error->getMessage()); return ['sent' => false, 'to' => $to, 'reason' => 'error']; } } /** Zusatz für die Flash-Meldung nach dem Erzeugen einer Einladung. */ function mail_invite_note(array $result): string { if (($result['sent'] ?? false) === true) { return ' Einladung per E-Mail an ' . (string) $result['to'] . ' gesendet.'; } return match ($result['reason'] ?? '') { 'no_address' => ' Keine E-Mail-Adresse hinterlegt – Link bitte kopieren und weitergeben.', 'error' => ' E-Mail-Versand fehlgeschlagen – Link bitte kopieren und weitergeben.', default => '', }; }