Backup extrahieren

Der extract-Befehl extrahiert Dateien und die Datenbank aus einem WP Staging Backup (.wpstg), ohne eine laufende WordPress-Installation zu benötigen. Dies ist nützlich für Disaster Recovery, Website-Inspektion oder die Vorbereitung von Dateien für den manuellen Import.

Was du erhältst

Nach der Extraktion hast du:

Alle WordPress-Dateien (Core, Themes, Plugins, Uploads)
Datenbank-SQL-Datei bereit für den Import
wp-config.php mit den Originaleinstellungen

Einfache Extraktion

Extrahiere alle Dateien und die Datenbank in das Standardausgabeverzeichnis (./wpstaging-output):

wpstaging extract backup.wpstg

Oder verwende das --from-Flag:

wpstaging extract --from=backup.wpstg

Von einer Remote-URL extrahieren

Extrahiere direkt aus einer entfernten Backup-Datei, ohne sie vorher manuell herunterzuladen:

wpstaging extract --from=https://example.com/backups/backup.wpstg

Oder übergib die URL direkt als Argument:

wpstaging extract https://example.com/backups/backup.wpstg

Was passiert:

Validiert die entfernte Datei (Größe und Format)
Zeigt Backup-Informationen an
Fragt vor dem Download um Bestätigung
Download mit Fortschrittsanzeige (unterstützt Wiederaufnahme bei unterbrochenen Downloads)

In benutzerdefiniertes Verzeichnis extrahieren

Gib an, wohin die Dateien extrahiert werden sollen:

wpstaging extract --outputdir=/var/www/restored-site backup.wpstg

Kurzform:

wpstaging extract -o /var/www/restored-site backup.wpstg

Mit Datenbank-Normalisierung extrahieren

WP Staging Backups enthalten Platzhalter in der Datenbankdatei. Verwende --normalizedb, um sie durch tatsächliche Werte zu ersetzen, damit die SQL-Datei für Standard-Datenbanktools bereit ist:

wpstaging extract --normalizedb backup.wpstg

Dies ersetzt Platzhalter wie:

{WPSTG_TMP_PREFIX} → temporary table prefix
{WPSTG_FINAL_PREFIX} → final table prefix
{WPSTG_NULL} → SQL NULL
{WPSTG_BINARY} → BINARY data type

Website-URL und Datenbankpräfix ersetzen

Extrahiere und ändere dabei die Website-URL und das Datenbankpräfix für eine neue Umgebung:

wpstaging extract --normalizedb \
  --site-url=https://newdomain.com \
  --db-prefix=wp_new_ \
  backup.wpstg

Hinweis: Das --normalizedb-Flag ist erforderlich, wenn --site-url oder --db-prefix verwendet wird.

Filtern, was extrahiert wird

Verwende --only-*-Flags, um bestimmte Teile des Backups zu extrahieren:

Flag	Short	Beschreibung
`--only-wproot`	`-r`	Nur WordPress-Root-Dateien extrahieren
`--only-wpcontent`	`-w`	Nur wp-content-Verzeichnis extrahieren
`--only-plugins`	`-i`	Nur Plugins extrahieren
`--only-themes`	`-t`	Nur Themes extrahieren
`--only-muplugins`	`-m`	Extract only must-use plugins
`--only-uploads`	`-u`	Nur Uploads extrahieren
`--only-languages`	`-g`	Extract only language files
`--only-dbfile`	`-b`	Extract only database file
`--only-dropins`	`-e`	Extract only drop-in files
`--only-file`	`-f`	Extract only files matching this name

Beispiel – Nur die Datenbankdatei extrahieren:

wpstaging extract --only-dbfile backup.wpstg

Beispiel – Nur Plugins extrahieren:

wpstaging extract -i backup.wpstg

Bestimmte Teile überspringen

Verwende --skip-*-Flags, um Teile von der Extraktion auszuschließen:

Flag	Short	Beschreibung
`--skip-wproot`	`-R`	WordPress-Root-Dateien überspringen
`--skip-wpcontent`	`-W`	wp-content-Verzeichnis überspringen
`--skip-plugins`	`-I`	Plugins überspringen
`--skip-themes`	`-T`	Themes überspringen
`--skip-muplugins`	`-M`	Skip must-use plugins
`--skip-uploads`	`-U`	Uploads überspringen
`--skip-languages`	`-G`	Skip language files
`--skip-dbfile`	`-B`	Skip database file
`--skip-dropins`	`-E`	Skip drop-in files
`--skip-file`	`-F`	Skip files matching this name

Beispiel – Alles außer Uploads extrahieren:

wpstaging extract --skip-uploads backup.wpstg

Beispiel – Datenbank und Uploads überspringen:

wpstaging extract -B -U backup.wpstg

Extrahierte Dateien überprüfen

Überprüfe die Integrität der extrahierten Dateien durch Vergleich der Prüfsummen mit dem Backup:

wpstaging extract --verify backup.wpstg

Überschreibverhalten

Standardmäßig überschreibt die Extraktion vorhandene Dateien. Um dies zu steuern:

# Skip overwriting (default is yes)
wpstaging extract --overwrite=no backup.wpstg

Alle Extract-Flags

Flags:
  -o, --outputdir string   Directory for extracted files (default: ./wpstaging-output)
  -n, --normalizedb        Normalize database files during extraction
      --overwrite string   Overwrite existing extraction directory (yes/no) (default "yes")
      --site-url string    Specify a new WordPress site URL
      --verify             Verify integrity of extracted files
      --db-prefix string   Specify a new WordPress database table prefix
      --from string        Backup file path or remote URL (http/https)

Häufige Anwendungsfälle

Disaster Recovery

Extrahiere Dateien aus einem Backup, wenn deine WordPress-Installation defekt ist:

wpstaging extract --normalizedb --outputdir=/var/www/recovery backup.wpstg

Nur Datenbank für manuellen Import extrahieren

Hole nur die Datenbank-SQL-Datei:

wpstaging extract --only-dbfile --normalizedb backup.wpstg

Zu neuer Domain migrieren

Extrahiere mit neuer Website-URL für die Migration:

wpstaging extract --normalizedb \
  --site-url=https://newsite.com \
  --outputdir=/var/www/newsite \
  backup.wpstg

Nächste Schritte

Restore WordPress from Backup – Für vollständig automatisierte Wiederherstellung
Inspect Backup Files – Backup-Inhalte vor der Extraktion anzeigen
Create a Local Copy of WordPress Site – Eine Docker-basierte lokale Kopie einrichten