Formatierter Text mit Werkzeugleiste und HTML-Ansicht (Schema v12)

Textblöcke dürfen ab v12 Auszeichnung tragen: fett, kursiv,
unterstrichen, durchgestrichen, Code, hervorgehoben, hoch- und
tiefgestellt, Absätze, Listen und Links.

Die Entscheidung, was erlaubt ist, fällt auf dem Server beim
Speichern - nicht im Editor und nicht beim Rendern. Was in der
Datenbank landet, ist damit schon sicher, also kann kein Renderer das
Filtern vergessen, und eine manipulierte Anfrage speichert nichts,
was der Editor nicht anbietet.

Nicht erlaubte Elemente werden ausgepackt, nicht gelöscht: der Text
bleibt, nur die Auszeichnung geht. script, style, iframe und
Verwandte verschwinden samt Inhalt, weil Auspacken ihren Code als
Text sichtbar machen würde. Attribute fallen weg außer href an a,
und auch das nur nach Adressprüfung.

Ausgegeben wird formatierter Text nur ab v12, dann in einem div statt
einem p, weil die Positivliste Absätze und Listen enthält. Ältere
Dokumente behalten Klartextsemantik und werden weiter maskiert.

Eine Inkonsistenz nebenbei behoben: ein Text mit einem < behielt
echte Zeilenumbrüche, während alles andere <br> benutzte.

Geprüft: 182 PHP-Tests / 685 Assertions unter PHP 8.2.12 und 8.4.22,
darunter dreizehn Fälle durch den Filter mit acht Angriffen, dazu
Editortest mit axe und öffentliche Browserprüfung. Die Werkzeugleiste
selbst ist nicht bedient und nicht mit einem Screenreader geprüft.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

src/Content/PageRepository.php

@@ -12,7 +12,7 @@ final class PageRepository
     public const RESERVED_SLUGS = ['admin', 'media', 'assets', 'favicon', 'kategorie', 'schlagwort', 'feed', 'beitraege'];
     public const MAX_DEPTH = 4;
 
-    public function __construct(private Connection $db, private DocumentValidator $validator, private SiteSettings $settings)
+    public function __construct(private Connection $db, private DocumentValidator $validator, private SiteSettings $settings, private RichText $richText = new RichText())
     {
     }
 
@@ -30,6 +30,7 @@ final class PageRepository
         if (!in_array($type, ['page', 'post'], true)) {
             throw new InvalidPage('Unbekannter Inhaltstyp.');
         }
+        $document = $this->richText->normaliseDocument($document);
         $this->validator->validate($document);
 
         return $this->db->transactional(function () use ($slug, $parentId, $type, $document, $locale): string {
@@ -304,6 +305,9 @@ final class PageRepository
 
     public function saveDraft(string $pageId, array $document, int $expectedVersion): string
     {
+        // Sanitising happens before validating and before storing, so the database never holds
+        // markup the allowlist would reject and no renderer has to remember to filter.
+        $document = $this->richText->normaliseDocument($document);
         $this->validator->validate($document);
 
         return $this->db->transactional(function () use ($pageId, $document, $expectedVersion): string {