Files
deskhub/DeskHub-Webseite/tests/mail_text.php
T
2026-10-22 18:59:44 +00:00

103 lines
8.7 KiB
PHP

<?php
declare(strict_types=1);
/**
* Prüft die Umwandlung eingehender E-Mails in Ticket-Text (includes/mail_text.php): CSS und Skripte, versteckte Vorschautexte und
* unsichtbare Füllzeichen landen nicht im Ticket, Absätze und Listen bleiben lesbar, Text-Teile werden bevorzugt, Kodierungen
* (Base64, Quoted-Printable, ISO-8859-1) und Anhänge werden richtig behandelt.
*/
require_once dirname(__DIR__) . '/includes/mail_text.php';
$failures = [];
$total = 0;
$check = function (bool $ok, string $what) use (&$failures, &$total): void { $total++; if (!$ok) $failures[] = $what; };
// ── Eine Newsletter-Mail wie die von Meta (Stil-Block, versteckter Vorschautext, Füllzeichen, Tabellen-Layout) ─────────────────
$meta = <<<'HTML'
<html><head><meta charset="utf-8"><title>Meta</title>
<style type="text/css">@media all and (max-width: 480px){*[class].ib_t{min-width:100%!important}*[class].ib_row{display:block!important}}
.d_mb_show{display:none}.mb_text h1,.mb_text h2{line-height:normal}.mb_work_text a{color:#1270e9}</style>
<script>var x = "tracking";</script></head>
<body>
<!-- Kommentar, der nicht erscheinen soll -->
<div style="display:none;max-height:0px;overflow:hidden">Versteckter Vorschautext&#847;&zwnj;&nbsp;&#847;&zwnj;&nbsp;</div>
<table><tr><td><h1>Dein Meta-Konto steht bereit</h1></td></tr>
<tr><td><p>Dein upgedatetes Konto funktioniert &uuml;ber Meta-Apps und -Ger&auml;te hinweg.</p></td></tr>
<tr><td>windelgeschichten<br>Instagram<br>&nbsp;mlukas6993 &nbsp; Threads</td></tr></table>
<ul><li>Ein Login f&uuml;r alle Apps.</li><li>Verbesserte Sicherheitsfunktionen.</li></ul>
<p>Viele Gr&uuml;&szlig;e<br>Meta</p>
<img src="https://example.org/pixel.gif" alt="">
<a href="https://example.org/x">Meta-Konten entdecken</a>
<span style="font-size:0px">Abstandshalter</span>
</body></html>
HTML;
$t = mail_html_to_text($meta);
$check(!str_contains($t, '@media') && !str_contains($t, '{') && !str_contains($t, 'ib_row') && !str_contains($t, 'line-height'), 'Kein CSS im Text');
$check(!str_contains($t, 'tracking') && !str_contains($t, 'var x'), 'Kein Skript im Text');
$check(!str_contains($t, 'Kommentar') && !str_contains($t, 'Versteckter Vorschautext') && !str_contains($t, 'Abstandshalter'), 'Kommentare und versteckte Elemente fehlen');
$check(!str_contains($t, "\u{034F}") && !str_contains($t, "\u{200C}") && !str_contains($t, "\u{00A0}"), 'Unsichtbare Füllzeichen und geschützte Leerzeichen sind weg');
$check(str_contains($t, "Dein Meta-Konto steht bereit\n") && str_contains($t, 'über Meta-Apps und -Geräte hinweg.'), 'Überschrift und Absatz mit Umlauten bleiben lesbar');
$check(str_contains($t, "• Ein Login für alle Apps.\n• Verbesserte Sicherheitsfunktionen."), 'Listen werden zu Aufzählungszeilen');
$check(str_contains($t, "windelgeschichten\nInstagram\nmlukas6993 Threads"), 'Zeilenumbrüche (br) bleiben, doppelte Leerzeichen werden zusammengefasst');
$check(str_contains($t, "Viele Grüße\nMeta") && str_contains($t, 'Meta-Konten entdecken'), 'Grußformel und Linktext bleiben');
$check(!preg_match("/\n{3,}/", $t) && $t === trim($t), 'Keine Leerzeilen-Flut, kein Leerraum am Anfang oder Ende');
$check(strlen($t) < 700, 'Der Text ist kurz und lesbar (' . strlen($t) . ' Zeichen)');
// ── Weitere HTML-Fälle ───────────────────────────────────────────────────────
$check(mail_html_to_text('<p>Hallo <b>Welt</b> &amp; Co &lt;3</p>') === 'Hallo Welt & Co <3', 'Entitäten werden entschlüsselt, Tags entfernt');
$check(mail_html_to_text('<div>Zeile 1</div><div>Zeile 2</div>') === "Zeile 1\nZeile 2", 'Blöcke werden zu eigenen Zeilen');
$check(mail_html_to_text('<img src="x.png" alt="Logo der Firma"> Text') === 'Logo der Firma Text', 'Alternativtext von Bildern bleibt');
$check(mail_html_to_text('') === '' && mail_html_to_text(" \n ") === '', 'Leere Mail bleibt leer');
$check(mail_html_to_text('<p style="visibility:hidden">weg</p><p>da</p>') === 'da', 'Unsichtbare Absätze fallen weg');
$check(mail_html_to_text('Nur Text ohne Tags, aber mit Umlauten äöü') === 'Nur Text ohne Tags, aber mit Umlauten äöü', 'Text ohne HTML bleibt unverändert');
$check(mail_html_to_text_regex('<style>a{color:red}</style><p>Hallo</p><br>Welt') === "Hallo\n\nWelt" || str_contains(mail_html_to_text_regex('<style>a{color:red}</style><p>Hallo</p><br>Welt'), 'Hallo'), 'Ersatzweg ohne DOM entfernt Stil-Blöcke');
$check(!str_contains(mail_html_to_text_regex('<style>a{color:red}</style><p>Hallo</p>'), 'color'), 'Ersatzweg: kein CSS');
// ── Kodierungen ──────────────────────────────────────────────────────────────
$check(mail_decode_part(base64_encode("Grüße"), 3, 'utf-8') === 'Grüße', 'Base64');
$check(mail_decode_part("Gr=C3=BC=C3=9Fe", 4, 'utf-8') === 'Grüße', 'Quoted-Printable');
$check(mail_decode_part(mb_convert_encoding('Grüße', 'ISO-8859-1', 'UTF-8'), 0, 'iso-8859-1') === 'Grüße', 'ISO-8859-1 wird nach UTF-8 umgewandelt');
$check(mail_decode_part(chunk_split(base64_encode(mb_convert_encoding('Äpfel', 'Windows-1252', 'UTF-8'))), 3, 'windows-1252') === 'Äpfel', 'Base64 mit Zeilenumbrüchen und Windows-1252');
$check(mail_decode_part('ohne Angabe', 0, '') === 'ohne Angabe', 'Ohne Zeichensatz');
// ── Mail-Aufbau (wie imap_fetchstructure ihn liefert) ────────────────────────
$param = fn(string $a, string $v) => (object) ['attribute' => $a, 'value' => $v];
$text = fn(string $sub, int $enc = 0, string $charset = 'utf-8', array $extra = []) => (object) array_merge(['type' => 0, 'subtype' => $sub, 'encoding' => $enc, 'ifparameters' => 1, 'parameters' => [$param('charset', $charset)]], $extra);
$multi = fn(array $parts) => (object) ['type' => 1, 'subtype' => 'ALTERNATIVE', 'parts' => $parts];
$fetchFrom = function (array $bodies) { return fn(string $no) => $bodies[$no] ?? ''; };
// multipart/alternative: Text bevorzugt
$s = $multi([$text('PLAIN'), $text('HTML')]);
$check(mail_best_text($s, $fetchFrom(['1' => 'Das ist der einfache Text der Mail mit genug Inhalt.', '2' => '<p>Das ist <b>HTML</b></p><style>x{}</style>'])) === 'Das ist der einfache Text der Mail mit genug Inhalt.', 'Alternativ-Mail: der Text-Teil wird bevorzugt');
// nur HTML (Newsletter)
$s = $text('HTML', 4);
$check(mail_best_text($s, $fetchFrom(['1' => quoted_printable_encode('<style>.a{x:y}</style><h1>Hallo</h1><p>Willkommen</p>')])) === "Hallo\nWillkommen", 'Reine HTML-Mail: nur der sichtbare Text, ohne CSS');
// Text-Teil ist nur eine Floskel, HTML hat den Inhalt
$s = $multi([$text('PLAIN'), $text('HTML')]);
$long = '<p>' . str_repeat('Der eigentliche Inhalt steht nur in der HTML-Fassung. ', 6) . '</p>';
$check(str_contains(mail_best_text($s, $fetchFrom(['1' => 'Bitte HTML ansehen', '2' => $long])), 'eigentliche Inhalt'), 'Kurze Text-Floskel: die HTML-Fassung wird genommen');
// Anhänge werden übersprungen, verschachtelte Teile gefunden
$att = $text('PLAIN', 0, 'utf-8', ['ifdisposition' => 1, 'disposition' => 'attachment']);
$nested = (object) ['type' => 1, 'subtype' => 'MIXED', 'parts' => [$multi([$text('PLAIN', 3), $text('HTML', 3)]), $att]];
$b64 = base64_encode('Text im verschachtelten Teil mit ausreichend vielen Zeichen drin.');
$check(mail_best_text($nested, $fetchFrom(['1.1' => $b64, '1.2' => base64_encode('<p>html</p>'), '2' => 'ANHANG-INHALT'])) === 'Text im verschachtelten Teil mit ausreichend vielen Zeichen drin.', 'Verschachtelte Teile (1.1) und Base64; Anhang wird ignoriert');
$parts = mail_collect_text_parts($nested);
$check(count($parts) === 2 && $parts[0]['no'] === '1.1' && $parts[1]['no'] === '1.2', 'Teil-Nummern stimmen mit IMAP überein');
// Anhang mit Dateiname (ohne disposition) zählt nicht als Text
$named = $text('PLAIN', 0, 'utf-8', ['parameters' => [$param('name', 'protokoll.txt')]]);
$check(mail_collect_text_parts($named) === [], 'Textdatei als Anhang wird nicht als Mailtext gelesen');
// Nicht-Text (Bild) ergibt nichts
$check(mail_collect_text_parts((object) ['type' => 5, 'subtype' => 'PNG']) === [], 'Bild-Teil ist kein Text');
// ISO-8859-1-Mail
$s = $text('PLAIN', 0, 'iso-8859-1');
$check(mail_best_text($s, $fetchFrom(['1' => mb_convert_encoding('Größe und Straße sind wichtig für diese Anfrage, bitte prüfen.', 'ISO-8859-1', 'UTF-8')])) === 'Größe und Straße sind wichtig für diese Anfrage, bitte prüfen.', 'Mail in ISO-8859-1');
// leere Mail
$check(mail_best_text($text('PLAIN'), $fetchFrom(['1' => ''])) === '', 'Leere Mail ergibt leeren Text (das Ticket zeigt dann „kein Inhalt“)');
if ($failures) {
fwrite(STDERR, "Fehlgeschlagen:\n - " . implode("\n - ", $failures) . "\n");
exit(1);
}
echo "Mail text checks passed ({$total} Prüfungen).\n";