Link-Validator für TYPO3

Kaputte Links kosten Rankings und Vertrauen, und die meisten TYPO3-Websites haben davon mehr als erwartet

Eine TYPO3-Website mit 500 Seiten hat im Durchschnitt 3.000-5.000 Links. Davon sind erfahrungsgemäß 2-5% defekt: gelöschte Seiten, geänderte URLs externer Websites, Tippfehler in manuell eingegebenen Links. Das sind 60-250 Broken Links, die Besucher auf 404-Seiten schicken und Google signalisieren, dass die Website schlecht gepflegt ist. Ein automatischer Link-Check prüft interne und externe Links und meldet Probleme, bevor sie sich auf Rankings und Nutzererfahrung auswirken.

TYPO3 bringt einen eigenen Linkvalidator im Core mit (EXT:linkvalidator). dreipc_linkvalidator ist weder im TER noch auf Packagist oder GitHub veröffentlicht; was die Extension gegenüber dem Core zusätzlich kann, lässt sich deshalb nicht prüfen. Für Websites mit mehr als 200 Seiten ist ein automatisierter Link-Check kein Luxus, sondern Pflicht.

Typische Einsatzszenarien

Corporate Websites mit externen Verlinkungen. Unternehmenswebsites verlinken auf Partner, Lieferanten, Fachverbände, Gesetzestexte und Presseartikel. Externe URLs ändern sich ohne Vorwarnung. Ein Link auf eine EU-Verordnung funktioniert heute, wird aber nächste Woche verschoben. Der Core-Linkvalidator prüft externe Links per HTTP-Request und meldet Adressen, die einen Fehler liefern oder nicht antworten.

Universitäten und Bildungseinrichtungen. Hochschul-Websites gehören zu den link-intensivsten Seiten überhaupt: Studienordnungen, Formulare, Vorlesungsverzeichnisse, Personenverzeichnisse, Partnerhochschulen. Bei einer Hochschul-Website mit 12.000 Seiten fand der Link-Check 1.400 defekte Links, davon 800 interne (gelöschte Seiten, umstrukturierte Bereiche) und 600 externe.

Redaktionelle Portale mit Archiv-Content. News-Portale und Magazine mit tausenden Artikeln verlinken untereinander und auf externe Quellen. Über Jahre sammeln sich Broken Links an, besonders in älteren Artikeln. Ein monatlicher Link-Check identifiziert neue Probleme, bevor sie sich häufen.

Technische Architektur

Grundlage jeder Link-Prüfung in TYPO3 ist der Core-Linkvalidator. Er prüft Links auf Datenbankebene: Er analysiert die Felder bodytext, header_link und andere konfigurierte Felder in der Content-Tabelle, identifiziert Links auf gelöschte Seiten oder Dateien und prüft externe URLs per HTTP-Request.

Die Prüfung läuft als TYPO3 Scheduler-Task. Typische Konfiguration: einmal pro Woche nachts. Der Task durchsucht alle konfigurierten Tabellen und Felder nach Links, unterscheidet zwischen internen Links (t3://page?uid=123), Datei-Links (t3://file?uid=456) und externen Links (https://…), und prüft jeden Link auf Erreichbarkeit.

Interne Links werden gegen die TYPO3-Datenbank geprüft: Existiert die verlinkte Seite noch? Ist sie nicht versteckt, nicht gelöscht, nicht zeitlich abgelaufen? Datei-Links prüfen, ob die referenzierte Datei im FAL noch existiert. Externe Links werden per HTTP HEAD-Request geprüft (schneller als GET, da kein Body übertragen wird). Bei HEAD-Fehler folgt ein GET als Fallback.

Die Ergebnisse zeigt das Backend-Modul „Check Links“: tabellarisch, filterbar nach Link-Typ (intern, extern, Datei) und nach Tiefe im Seitenbaum. Jeder Eintrag enthält das Element, den Seitenpfad, das Linkziel, die Fehlermeldung und einen Stift, der direkt ins Bearbeitungsformular führt.

Häufige Probleme und Lösungen

False Positives bei externen Links. Manche Websites blockieren automatisierte Requests (Bot-Protection, Cloudflare Challenge). Der Link funktioniert im Browser, aber der Linkvalidator meldet 403 oder Timeout. Lösung: Einen aussagekräftigen User-Agent-Header setzen, den Timeout großzügig wählen (beides per TSconfig) und bekannte False-Positive-Domains ausschließen, mit einer eigenen Prüfklasse oder mit brofix (siehe unten). Bei einem Kunden reduzierten diese Anpassungen die False-Positive-Rate von 12% auf unter 2%.

Prüfung dauert zu lange bei großen Websites. 10.000 externe Links zu prüfen dauert bei sequentieller Abarbeitung mehrere Stunden. Lösung: Die Prüfung nachts über den Scheduler laufen lassen statt über den Button im Modul, sie auf mehrere Tasks für einzelne Bereiche des Seitenbaums verteilen und die Prüffrequenz anpassen (externe Links wöchentlich, interne täglich; interne Links sind schnell per DB-Query prüfbar).

Redakteure ignorieren die Berichte. Der häufigste Grund für wachsende Broken-Link-Listen: Niemand fühlt sich zuständig. Lösung: E-Mail-Benachrichtigungen an die zuständigen Redakteure aktivieren. Schon der Core-Linkvalidator versendet aus dem Scheduler-Task einen Report per E-Mail, je Task für einen Startpunkt im Seitenbaum. Mit einem Task pro Bereich erhält jeder Redakteur nur die Broken Links in “seinem” Bereich.

Migration und Versions-Kompatibilität

TYPO3s Core-Linkvalidator (EXT:linkvalidator) ist seit TYPO3 4.5 Bestandteil des Core und wird kontinuierlich weiterentwickelt. In TYPO3 v12 und v13 ist der Core-Linkvalidator deutlich verbessert: bessere Performance, neue UI im Backend, Scheduler-Integration überarbeitet. dreipc_linkvalidator ist weder im TER noch auf Packagist veröffentlicht, eine offizielle Version für v12 und v13 gibt es dort also nicht.

Für Projekte auf TYPO3 v12/v13 stellt sich die Frage, ob dreipc_linkvalidator noch nötig ist. Der Core-Linkvalidator bringt das Nötige seit TYPO3 4.5 selbst mit: HTTP-basierte Prüfung externer Links, Scheduler-Integration, E-Mail-Reports und eine Backend-Ansicht mit Filterung. Seit v13 muss die Prüfung externer Links allerdings ausdrücklich eingeschaltet werden. Was fehlt, ist eine Whitelist für False Positives.

Die Alternative: im Core-Linkvalidator die Prüfklasse für externe Links durch eine eigene ersetzen, die bekannte False-Positive-Domains überspringt, oder die Extension brofix nutzen, die eine solche Ausschlussliste mitbringt. Alternativ gibt es externe Tools (Screaming Frog, Ahrefs, Semrush), die Broken Links als Teil ihres SEO-Audits prüfen, aber nicht in TYPO3 integriert sind. Gosign empfiehlt den Core-Linkvalidator in Kombination mit einem monatlichen externen Crawl für maximale Abdeckung.