Wie misst und reduziert man technische Schulden einer Unternehmenswebsite?

Technische Schulden einer Website per Scan inventarisieren, mit einer Matrix aus Wirkung und Aufwand priorisieren, in den Wartungsplan einbauen und zwischen Neuaufbau und schrittweiser Verbesserung entscheiden.
Technische Zusammenfassung
Technologie
WordPress, PHP, PHP_CodeSniffer, PHPCompatibilityWP, Composer, npm
Thema
Inventar und Priorisierung technischer Schulden
Niveau
Mittel bis fortgeschritten
Voraussetzungen
  • Zugang zu Quellcode und Server der Website
  • Staging-Umgebung
In diesem Beitrag7 Abschnitte

Unternehmenswebsites brechen selten über Nacht zusammen. Häufiger ist dieses Bild: Jede Änderung dauert länger als die vorige, jedes Update macht etwas mehr Angst, und schließlich will niemand die Website mehr anfassen. Das nennt man technische Schulden; Abkürzungen, die früher für Geschwindigkeit genommen wurden, schlagen heute als Zinsen auf jede Wartungsarbeit auf. Im Folgenden beschreiben wir, wie Schulden inventarisiert, nach Wirkung und Aufwand priorisiert werden und anhand welcher Schwellen die Entscheidung „Neu bauen oder schrittweise verbessern?“ getroffen wird.

Typische Quellen technischer Schulden in Webprojekten

Technische Schulden sind nicht dasselbe wie „schlechter Code“. Eine bewusst genommene und schriftlich festgehaltene Abkürzung ist beherrschbar; eine Gewohnheit, an die sich niemand erinnert, nicht. Bei Websites häufen sich Schulden meist aus diesen Quellen an:

  • Veraltete Laufzeitumgebung: Nicht unterstützte PHP-Version, altes MariaDB/MySQL, eigener Code oder Plugins, die nur mit altem PHP laufen. Das blockiert Sicherheitsupdates direkt.
  • In das Theme eingebettete Geschäftslogik: Hunderte Zeilen Integrationscode in functions.php, eigene Beitragstypen und Shortcodes, die bei einem Theme-Wechsel verloren gehen.
  • Kopierte Vorlagen: Im Child-Theme überschriebene WooCommerce- oder Plugin-Vorlagen. Aktualisiert das Haupt-Plugin die Vorlage, bleibt die Kopie veraltet; WooCommerce meldet dies im Status-Bildschirm (System Status) als veraltete Vorlagenüberschreibungen.
  • Rohes HTML im Page Builder: HTML-Widgets, Inline-CSS, pro Seite kopierte Komponenten. Die visuelle Bearbeitung endet; eine Designänderung wird auf Dutzenden Seiten manuell vorgenommen.
  • Plugin-Anhäufung: Plugins mit überlappender Funktion, verwaiste Plugins oder Plugins mit abgelaufener Lizenz.
  • Undokumentierte Integrationen: Skripte in der Server-Crontab, an die sich niemand erinnert, im Code eingebettete API-Schlüssel, FTP-Übertragungen, die nur eine Person kennt.
  • Lücken bei Umgebung und Prozess: Code ohne Versionskontrolle, fehlende Testumgebung, manuelle Deployments.
  • Veraltete Abhängigkeiten: Skripte, die von einer alten jQuery-Version oder jQuery Migrate abhängen, nicht aktualisierte Composer- und npm-Pakete.

Am teuersten wird in der Praxis meist die undokumentierte Integration. Wer das Skript geschrieben hat, ist gegangen. Dass es überhaupt läuft, merkt man erst, wenn es stoppt.

Wie ein Inventar technischer Schulden erstellt wird

Das Inventar entsteht nicht aus einer Code-Review-Sitzung, sondern aus einem systematischen Scan. Prüfreihenfolge: zuerst Umgebung, dann Code, dann Inhalte, zuletzt Prozess.

Scan von Umgebung und Abhängigkeiten

Der Supportstatus der PHP-Version wird auf der Seite der unterstützten PHP-Versionen geprüft. Die Kompatibilität eigenen Codes mit der Zielversion lässt sich mit PHP_CodeSniffer und dem Regelsatz PHPCompatibilityWP statisch scannen:

# Mit Composer als Entwicklungsabhaengigkeit installieren
# (Composer 2.2+ kann fuer das PHPCS-Installer-Plugin eine allow-plugins-Freigabe verlangen)
composer require --dev phpcompatibility/phpcompatibility-wp:"*"

# Theme und eigene Plugins fuer PHP 8.2 und neuer scannen
vendor/bin/phpcs -p wp-content/themes/eigenes-theme wp-content/plugins/eigenes-plugin \
  --standard=PHPCompatibilityWP --runtime-set testVersion 8.2- \
  --extensions=php --report=summary

# Veraltungsstand der Paketabhaengigkeiten
composer outdated --direct
npm outdated

Ein statischer Scan erfasst nicht alles. Für dynamische Aufrufe und Warnungen zur Laufzeit müssen in der Testumgebung mit der Ziel-PHP-Version reale Szenarien durchgespielt und das Fehlerlog beobachtet werden. Die Umstellung selbst behandelt als eigenes Projekt der Leitfaden Umstellung der PHP-Version planen.

Scan von Code und Konfiguration

  • Zeilenzahl bei Theme und eigenen Plugins, ob sie in der Versionskontrolle liegen, Datum der letzten Änderung.
  • Liste der Vorlagenüberschreibungen im Child-Theme und Versionsunterschied zur Hauptvorlage.
  • Im Code fest eingetragene URLs, API-Schlüssel und Passwörter (für den Anfang genügt eine einfache Suche wie grep -rn "api_key\|password\|http://" wp-content/themes).
  • Server-Crontab (crontab -l, /etc/cron.d/) und WordPress-Cron-Aufgaben (wp cron event list).

Scan von Inhalten und Page Builder

Ermittelt wird die Zahl der Seiten mit HTML-Widgets, Inline-Styles und eigenen Shortcodes. Da Elementor die Seitendaten als JSON im Metafeld _elementor_data speichert, lässt sich der Widget-Typ in diesem Feld suchen. Die folgende Abfrage liefert die Zahl der Beiträge und Vorlagen mit HTML-Widget (passen Sie das Tabellenpräfix an die Ausgabe von wp db prefix an; das Ergebnis kann auch Revisionen zählen):

wp db query 'SELECT COUNT(DISTINCT post_id) FROM wp_postmeta
  WHERE meta_key = "_elementor_data"
  AND meta_value LIKE "%\"widgetType\":\"html\"%";'

Diese Zahl beantwortet die Frage „Wie viele Seiten berührt eine Designänderung?“. Es ist auch die erste Zahl, die man der Geschäftsführung zeigt.

Prozessscan

Versionskontrolle, Testumgebung, Test der Backup-Wiederherstellung, Deployment-Methode und Dokumentation werden mit Ja/Nein erfasst. Eine Prozesslücke ist für sich kein Codeproblem; sie verteuert aber die Tilgung aller anderen Schulden. Gibt es keine Testumgebung, wird jede Korrektur live vorgenommen.

Priorisierung mit einer Matrix aus Wirkung und Aufwand

Jeder Punkt im Inventar wird auf zwei Achsen bewertet. Die Wirkung ist das Risiko und die Reibung, die der Punkt heute verursacht: Sicherheitslücke, blockiertes Update, Performanceverlust, verlängerte Änderungsdauer. Der Aufwand ist Arbeitsmenge und Risiko, um den Punkt zu schließen. Eine Skala von 1–3 genügt den meisten Teams; Ziel ist keine präzise Berechnung, sondern die Diskussion in eine gemeinsame Sprache zu bringen.

Beispielpunkt Auswirkung Aufwand Entscheidung
Nicht unterstützte PHP-Version Hoch Mittel Sofort planen
Im Code eingebetteter API-Schlüssel Hoch Niedrig Sofort erledigen
Veraltete Kopien von WooCommerce-Vorlagen Mittel Niedrig Sofort erledigen
Verwaistes Formular-Plugin Hoch Mittel Sofort planen
Mit HTML-Widgets gebaute Seiten Mittel Hoch Schrittweise, mit Redesign verbinden
Undokumentiertes Cron-Skript Mittel Niedrig Dokumentieren, dann bewerten
Nicht genutzter eigener Beitragstyp Niedrig Niedrig Bei Gelegenheit

Die vier Bereiche werden so gelesen: hohe Wirkung und geringer Aufwand „sofort erledigen“; hohe Wirkung und hoher Aufwand „als Projekt planen“; geringe Wirkung und geringer Aufwand „erledigen, wenn der Bereich ohnehin angefasst wird“; geringe Wirkung und hoher Aufwand „bewusst akzeptieren und dokumentieren“. Unterschätzen Sie die letzte Gruppe nicht. Nicht jede Schuld muss getilgt werden; dass sie akzeptiert wurde, muss aber schriftlich festgehalten sein, damit sie nicht in jeder Besprechung neu aufgerollt wird.

Punkte, die Sicherheit und Updates blockieren, werden unabhängig von der Matrix vorgezogen. Ein einziges Plugin, das von einer nicht unterstützten PHP-Version abhängt, kann die Aktualisierung aller anderen Komponenten der Website stoppen. Das ist die Kettenwirkung.

Arbeiten zum Schuldenabbau in den Wartungsplan einbauen

Wer auf ein separates „Aufräumprojekt“ wartet, baut Schulden selten ab; dieses Projekt wird gegenüber neuen Feature-Wünschen immer verschoben. Bewährt hat sich, den Schuldenabbau zum festen Bestandteil der regelmäßigen Wartung zu machen:

  • Feste Kapazität: Jeden Monat wird ein bestimmter Block der Wartungsstunden für Schuldenpunkte reserviert. Außer bei dringenden Arbeiten wird er nicht für andere Aufgaben verwendet.
  • Wo Sie etwas anfassen, korrigieren Sie: Wird eine Seite oder Komponente für eine neue Anforderung geöffnet, werden kleine Schuldenpunkte in diesem Bereich in derselben Arbeit geschlossen.
  • Erfassung neuer Schulden: Wegen eines Liefertermins bewusst genommene Abkürzungen werden am selben Tag ins Inventar geschrieben; „das korrigieren wir später“ bleibt nicht mündlich.
  • Vierteljährliche Überprüfung: Das Inventar wird neu bewertet, geschlossene Punkte werden markiert, neue hinzugefügt.

Wie sich der Schuldenabbau im Wartungsvertrag niederschlägt, beschreibt zusammen mit Definitionen zu Umfang und Priorität der Beitrag SLA im Website-Wartungsvertrag. Um Schulden aus Plugins auszusortieren, ist der Leitfaden Plugin-Inventar und sicheres Entfernen direkt anwendbar.

Neu schreiben oder schrittweise verbessern

Je größer die Schulden, desto verlockender der Vorschlag „machen wir alles neu“. Manchmal ist das die richtige Entscheidung. Es erfordert aber, die über Jahre angesammelten impliziten Anforderungen der alten Website (Weiterleitungen, Formularintegrationen, eigene Felder, URLs mit SEO-Wert) neu zu entdecken; jede nicht entdeckte kehrt auf der neuen Website als Störung zurück. Für die Entscheidung lassen sich diese Schwellen nutzen:

Status Schrittweise Verbesserung Neuaufbau
Core und Plugins lassen sich aktualisieren Geeignet Nicht erforderlich
Laufzeitumgebung lässt sich nicht auf eine unterstützte Version bringen Schwierig Starker Kandidat
Designänderungen werden Seite für Seite manuell vorgenommen Umstellung pro Komponente Geeignet, wenn mit Redesign verbunden
Geschäftslogik ist über Theme-Dateien verteilt Zuerst in ein Plugin verlagern Geeignet, wenn sich die Architektur ändert
Auch Informationsarchitektur und Inhalte ändern sich Begrenzter Nutzen Geeignet

Ein bei schrittweiser Verbesserung häufig genutztes Muster ist, neue Komponenten neben den alten aufzubauen und den Traffic Schritt für Schritt auf die neuen umzulenken: zuerst Vorlagen und globale Styles, dann die am häufigsten geänderten Seitengruppen, zuletzt selten angefasste Seiten. Jeder Schritt sollte einzeln veröffentlicht und rückgängig gemacht werden können. Ein Schritt, der nicht rückgängig zu machen ist, ist nicht schrittweise.

Fällt die Wahl auf einen Neuaufbau, ist das größte Risiko ein Verlust der Sichtbarkeit in Suchmaschinen durch verlorene URLs und Inhalte; die Weiterleitungs- und Prüfschritte aus dem Leitfaden SEO-Verluste bei der Migration vermeiden sollten Teil des Plans sein. Steht auch ein Plattformwechsel zur Debatte, bietet der Vergleich zwischen WordPress und Next.js einen zusätzlichen Entscheidungsrahmen.

Checkliste zur Bewertung technischer Schulden

  • Versionen von PHP, Datenbank und Webserver wurden anhand des Supportkalenders geprüft.
  • Eigene Themes und Plugins liegen in der Versionskontrolle; bekannt ist, wer die letzte Änderung vorgenommen hat.
  • Der PHP-Kompatibilitätsscan wurde für die Zielversion ausgeführt, die Ergebnisse wurden festgehalten.
  • Vorlagenüberschreibungen wurden aufgelistet, Versionsunterschiede zur Hauptvorlage notiert.
  • Im Code eingebettete Geheimnisse (Schlüssel, Passwörter) wurden erkannt; ihre Verlagerung in Umgebungsvariablen oder eine Konfigurationsdatei ist geplant.
  • Server- und WordPress-Cron-Aufgaben wurden dokumentiert.
  • Die Zahl der Seiten mit HTML-Widgets und Inline-Styles wurde ermittelt.
  • Jeder Punkt wurde nach Wirkung und Aufwand bewertet; akzeptierte Schulden wurden mit Begründung festgehalten.
  • Im Wartungsplan ist feste Kapazität für den Schuldenabbau reserviert.
  • Wird ein Neuaufbau erwogen, liegen URL-Inventar und Weiterleitungsplan vor.

Führt das Inventar zu einer Modernisierungsentscheidung, beschreibt die Leistung Modernisierung alter Websites den passenden Umfang; wird der Schuldenabbau im Rahmen der regelmäßigen Wartung bevorzugt, die Seite Wartungs- und Supportverträge für Websites.

Häufig gestellte Fragen

Sind technische Schulden immer schlecht?

Nein. Eine für einen Liefertermin bewusst genommene und dokumentierte Abkürzung ist eine vernünftige Entscheidung. Das Problem ist, wenn Schulden nicht dokumentiert werden und sich ohne Rückzahlungsplan anhäufen. Manche Schulden mit geringer Wirkung können bewusst akzeptiert und nie getilgt werden.

Wie erkläre ich technische Schulden der Geschäftsführung?

Formulieren Sie die Punkte nicht in Fachbegriffen, sondern als Geschäftsergebnis: Updates sind nicht möglich, eine Sicherheitslücke lässt sich nicht schließen, eine Änderung dauert so und so viele Tage. Eine Matrix aus Wirkung und Aufwand erleichtert es, anschaulich zu zeigen, welche Arbeit warum zuerst erledigt wird.

Setzt ein Neuaufbau der Website die technischen Schulden auf null?

Kurzfristig schließt er viele Punkte; werden die impliziten Anforderungen der alten Website aber nicht aufgedeckt, entstehen neue Probleme. Werden auf der neuen Website Inventar, Wartungsrhythmus und Dokumentationsdisziplin nicht eingeführt, häufen sich die Schulden erneut an.

Genügt ein PHP-Kompatibilitätsscan allein?

Nein. PHPCompatibility führt eine statische Analyse durch; dynamische Aufrufe und Laufzeitwarnungen erfasst es eventuell nicht. Ergänzen Sie den Scan, indem Sie in der Testumgebung mit der Ziel-PHP-Version reale Nutzungsszenarien durchspielen und das Fehlerlog beobachten.

Support

Kontaktieren Sie uns für Support oder eine Bestandsaufnahme zu diesem Thema.

Kontaktformular
[email protected]

Eretek Web

Wir bauen Unternehmenswebsites, WordPress- und CMS-Plattformen, Intranet- und SharePoint-Portale, Dokumentenmanagement sowie Formular- und Freigabeprozesse auf und halten sie sicher und aktuell.

Wissenszentrum

Weitere Beiträge