Suchen und Ersetzen in WordPress: Dry Run richtig nutzen

Ein Administrator möchte eine Produktbezeichnung in der Datenbank umbenennen. Die erste Vorschau meldet 18.000 Treffer einschließlich Bestellnotizen, Benutzernamen und Logtabellen, obwohl weniger als 200 redaktionelle Seiten erwartet werden. Ein erfolgreicher Dry Run würde beim sofortigen Schreiben den falschen Umfang freigeben.

Hier erfahren Sie, wie ein Dry Run vorbereitet und bewertet wird, warum eine plausible Trefferzahl allein nicht genügt und welche Angaben zwischen Vorschau und Schreibvorgang unverändert bleiben müssen.

Was das Thema bedeutet

Ein Dry Run wertet Suche und Umfang aus, ohne Ersatzwerte dauerhaft zu schreiben. Das Ergebnis schätzt Tabellen, Spalten oder Zeilen, die mit den aktuellen Optionen geändert würden. Es ist eine Entscheidungsgrundlage, kein Beweis für einen späteren identischen Schreibvorgang: Datenbank, Filter, Werkzeugversion und Auswahl können sich dazwischen ändern.

• Erfassen Sie exakten Such- und Ersatztext, Großschreibung und Regex-Optionen, Tabellen, Spaltenausschlüsse, Zeilenkennungen, Trefferzahlen, Werkzeugversion, Snapshot-Zeit und repräsentative Beispiele.
• Ordnen Sie Vorschautreffer nach zuständigem Datenbereich und Zweck statt nur nach Gesamtsumme; Redaktion, Accounts, Handel, Logs, Caches und Erweiterungskonfiguration brauchen unterschiedliche Freigaben.
• Schreiben Sie nicht bei ungeklärter Zuständigkeit, unerklärter Trefferzahl, geschützten Kennungen, Geheimnissen im Bericht, unkontrollierbarer Paralleländerung oder abweichender Schreibkonfiguration.

Ein realistisches WordPress-Beispiel

Die Vorschau meldet 18.000 Treffer, obwohl weniger als 200 redaktionelle Seiten erwartet werden. Bestellnotizen, Benutzernamen und Logtabellen gehören offenbar ebenfalls zum Suchraum. Statt das Ergebnis als Erfolg zu werten, grenzt der Administrator Tabellen und Spalten ein und prüft Beispiele aus jeder verbleibenden Datenart.

Warum es wichtig ist und wann es eingesetzt wird

Ein Dry Run ist vor jeder breiten oder noch nicht genau bekannten Ersetzung sinnvoll. Er wird wiederholt, sobald sich Suchwert, Ersatzwert, Tabellenumfang, Ausschlüsse, Datenstand oder Werkzeugversion ändern. Erst eine nachvollziehbare Auswahl darf in den Schreibvorgang übernommen werden.

Ordnen Sie Treffer nach ihrem Zweck: redaktionelle Inhalte, Konten, Bestelldaten, Logs und Plugin-Konfiguration benötigen unterschiedliche Freigaben. Verbergen Sie sensible Beispielwerte im Bericht. Stoppen Sie bei unbekannter Zuständigkeit, unerklärten Trefferzahlen oder parallelen Änderungen an der Datenbank.

Der einfache Weg für Einsteiger

1. Legen Sie Such- und Ersatztext, Großschreibung, Tabellen und Ausschlüsse fest.
2. Starten Sie den Dry Run und ordnen Sie die Treffer nach redaktionellen Inhalten, Konten, Bestellungen, Logs und Plugin-Konfiguration.
3. Prüfen Sie aus jeder Gruppe konkrete Beispiele und entfernen Sie Bereiche ohne fachliche Freigabe aus dem Auftrag.
4. Speichern Sie Bericht, Werkzeugversion und vollständigen Optionssatz zusammen mit dem Datenbankzeitpunkt.
5. Schreiben Sie erst, wenn Trefferzahl und Stichproben plausibel sind und während des Laufs niemand die betroffenen Daten bearbeitet.

Der technische Weg

Die technische Freigabe bindet Datenbankstand, Werkzeugversion und Optionsfingerabdruck an den gespeicherten Bericht. Nach dem einmaligen Schreibvorgang werden erwartete Treffer und ausdrücklich geschützte Kontrollwerte verglichen.

• Wiederholen Sie unmittelbar davor die Vorschau auf der aktuellen Datenbank, erklären Sie Zählabweichungen, schreiben Sie einmal, vergleichen Sie betroffene Zeilen mit der Freigabe und prüfen Sie positive wie negative Stichproben.
• Maskieren Sie sensible Beispielwerte im Bericht und kennzeichnen Sie Treffer, deren Wirkung erst beim Lesen durch WordPress oder ein Plugin entsteht.
• Der Schreiblauf übernimmt den freigegebenen Tabellenumfang und die Ausschlüsse unverändert; der Bericht weist Abweichungen in Treffer- oder Schreibzahl gesondert aus.
• Archivieren Sie Vorschau und Ausführungsbericht unter derselben Änderungskennung, damit sich jede geschriebene Zeile auf die Freigabe zurückführen lässt.

Risiken, häufige Fehler, Backup und Rollback

Ein Dry Run schreibt zwar keine Ersatzwerte, kann aber trotzdem zu breit angelegt sein oder sensible Inhalte im Bericht offenlegen. Eine alte Vorschau verliert außerdem ihre Aussagekraft, wenn inzwischen Beiträge bearbeitet oder Optionen geändert wurden. Sichern Sie die Datenbank und frieren Sie den geprüften Optionssatz für das Wartungsfenster ein.

• Besonders kritisch sind Treffer in Konten, Bestelldaten und Plugin-Konfigurationen; diese Bereiche dürfen nicht aufgrund einer plausiblen Gesamtsumme mitfreigegeben werden.
• Vor dem Schreiben wird geprüft, ob parallele Bearbeitung, Regex-Rückbezüge oder fehlende Sperren den seit dem Dry Run entstandenen Datenstand verändert haben.
• Jede Änderung an Eingabe, Optionen, Schema, Datenstand, Werkzeugversion oder Freigabe macht den gespeicherten Bericht ungültig.
• Geschützte Kennungen, Geheimnisse im Bericht oder eine abweichende Schreibkonfiguration blockieren die Ausführung unabhängig davon, ob der Dry Run technisch fehlerfrei war.

Dokumentieren Sie Such- und Ersatzwert, Tabellen, Ausschlüsse, Werkzeugversion, Zeitpunkt und Trefferzahlen. Ein Schreibvorgang wird nicht allein wegen eines fehlerfreien Dry Runs freigegeben, sondern erst nach der Prüfung repräsentativer Treffer und ausdrücklich geschützter Gegenbeispiele.

Passende AIOWS-Artikel

• WordPress Suchen und Ersetzen ohne serialisierte Daten zu beschädigen
• Text in allen WordPress-Beiträgen und Seiten ersetzen
• WordPress Suchen-und-Ersetzen rückgängig machen

Fazit und empfohlener Weg

Empfohlen ist, den Dry Run als prüfbaren Änderungsantrag zu behandeln: Treffer klassifizieren, Umfang verengen, Belege schwärzen, Optionen einfrieren und direkt vor Ausführung wiederholen. Freigegeben werden Stichproben und Verantwortliche, nicht ein grünes Vorschauetikett.

Offizielle Quellen

• WP-CLI-Befehl search-replace