M3 Mailversand und Public-Landingpage vorbereiten

- Mail-Transport fuer Reset- und Verifizierungslinks ergaenzen - Public-Landingpage mit Hero-Asset und App-CTAs bauen - Mail-Flow-Test, Smoke-Abdeckung und SaaS-Doku aktualisieren
2026-07-13 20:38:01 +02:00
parent 9f2e1bdfb1
commit b0e21bbb0a
12 changed files with 462 additions and 20 deletions
@@ -0,0 +1,151 @@
+<?php
+
+declare(strict_types=1);
+
+require_once __DIR__ . '/bootstrap.php';
+
+function saas_mail_transport(): string
+{
+    $default = app_is_dev() ? 'log' : 'mail';
+
+    return strtolower((string)app_env('APP_MAIL_TRANSPORT', $default));
+}
+
+function saas_mail_from(): string
+{
+    return (string)app_env('APP_MAIL_FROM', 'noreply@kaffeeliste.local');
+}
+
+function saas_mail_from_name(): string
+{
+    return (string)app_env('APP_MAIL_FROM_NAME', 'Kaffeeliste');
+}
+
+function saas_app_base_url(): string
+{
+    $configured = app_env('APP_BASE_URL');
+    if ($configured !== null) {
+        return rtrim($configured, '/');
+    }
+
+    if (PHP_SAPI !== 'cli' && !empty($_SERVER['HTTP_HOST'])) {
+        $scheme = app_is_https() ? 'https' : 'http';
+
+        return $scheme . '://' . rtrim((string)$_SERVER['HTTP_HOST'], '/');
+    }
+
+    return 'http://localhost';
+}
+
+function saas_app_url(string $path): string
+{
+    return saas_app_base_url() . '/' . ltrim($path, '/');
+}
+
+function saas_mail_headers(): string
+{
+    $fromName = str_replace(["\r", "\n"], '', saas_mail_from_name());
+    $from = str_replace(["\r", "\n"], '', saas_mail_from());
+
+    return implode("\r\n", [
+        "From: {$fromName} <{$from}>",
+        "Reply-To: {$from}",
+        'Content-Type: text/plain; charset=UTF-8',
+    ]);
+}
+
+function saas_log_mail(string $to, string $subject, string $body): array
+{
+    $logDir = (string)app_env('APP_MAIL_LOG_DIR', APP_ROOT . '/var/mail');
+    if (!is_dir($logDir)) {
+        @mkdir($logDir, 0700, true);
+    }
+
+    if (!is_dir($logDir) || !is_writable($logDir)) {
+        return [
+            'ok' => false,
+            'transport' => 'log',
+            'error' => 'mail log directory is not writable',
+        ];
+    }
+
+    $file = rtrim($logDir, '/') . '/mail_' . date('Ymd_His') . '_' . bin2hex(random_bytes(6)) . '.txt';
+    $content = "To: {$to}\nSubject: {$subject}\n\n{$body}\n";
+
+    if (file_put_contents($file, $content) === false) {
+        return [
+            'ok' => false,
+            'transport' => 'log',
+            'error' => 'mail log write failed',
+        ];
+    }
+
+    return [
+        'ok' => true,
+        'transport' => 'log',
+        'path' => $file,
+    ];
+}
+
+function saas_send_mail(string $to, string $subject, string $body): array
+{
+    $to = trim($to);
+    if (!filter_var($to, FILTER_VALIDATE_EMAIL)) {
+        return [
+            'ok' => false,
+            'transport' => saas_mail_transport(),
+            'error' => 'invalid recipient',
+        ];
+    }
+
+    if (saas_mail_transport() === 'log') {
+        return saas_log_mail($to, $subject, $body);
+    }
+
+    $sent = mail($to, $subject, $body, saas_mail_headers());
+
+    return [
+        'ok' => $sent,
+        'transport' => 'mail',
+        'error' => $sent ? null : 'mail transport failed',
+    ];
+}
+
+function saas_send_password_reset_mail(string $to, string $token): array
+{
+    $link = saas_app_url('passwort-zuruecksetzen.php?token=' . urlencode($token));
+    $body = implode("\n", [
+        'Hallo,',
+        '',
+        'fuer dein Kaffeeliste-Konto wurde ein Passwort-Reset angefordert.',
+        'Oeffne diesen Link, um ein neues Passwort zu setzen:',
+        '',
+        $link,
+        '',
+        'Der Link ist zeitlich begrenzt und kann nur einmal verwendet werden.',
+        'Falls du den Reset nicht angefordert hast, kannst du diese Nachricht ignorieren.',
+        '',
+        'Deine Kaffeeliste',
+    ]);
+
+    return saas_send_mail($to, 'Kaffeeliste Passwort zuruecksetzen', $body);
+}
+
+function saas_send_email_verification_mail(string $to, string $token): array
+{
+    $link = saas_app_url('email-verifizieren.php?token=' . urlencode($token));
+    $body = implode("\n", [
+        'Hallo,',
+        '',
+        'bitte bestaetige deine E-Mail-Adresse fuer Kaffeeliste.',
+        'Oeffne dazu diesen Link:',
+        '',
+        $link,
+        '',
+        'Der Link ist zeitlich begrenzt und kann nur einmal verwendet werden.',
+        '',
+        'Deine Kaffeeliste',
+    ]);
+
+    return saas_send_mail($to, 'Kaffeeliste E-Mail bestaetigen', $body);
+}