Estrarre un Backup WordPress

Il comando extract estrae file e database da un Backup WP Staging (.wpstg) senza bisogno di un’installazione WordPress attiva. È utile per il ripristino d’emergenza, l’ispezione del sito o per preparare i file da importare manualmente.

Cosa otterrai

Al termine dell’estrazione avrai:

Tutti i file di WordPress (core, Theme, Plugin, uploads)
Il file SQL del database pronto per l’importazione
wp-config.php con le impostazioni originali

Estrazione di base

Estrai tutti i file e il database nella directory di output predefinita (./wpstaging-output):

wpstaging extract backup.wpstg

In alternativa, usa il flag --from:

wpstaging extract --from=backup.wpstg

Estrarre da un URL remoto

Estrai direttamente da un file di Backup remoto, senza scaricarlo prima manualmente:

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

Oppure passa l’URL direttamente come argomento:

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

Cosa succede:

Convalida il file remoto (dimensione e formato)
Mostra le informazioni del Backup
Chiede conferma prima di avviare il download
Esegue il download con indicatore di avanzamento (supporta la ripresa dei download interrotti)

Estrarre in una directory personalizzata

Specifica dove estrarre i file:

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

Forma abbreviata:

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

Estrazione con normalizzazione del database

I Backup di WP Staging contengono dei segnaposto nel file del database. Usa --normalizedb per sostituirli con i valori reali, così il file SQL sarà pronto per gli strumenti di database standard:

wpstaging extract --normalizedb backup.wpstg

Questo sostituisce segnaposto come:

{WPSTG_TMP_PREFIX} → prefisso temporaneo delle tabelle
{WPSTG_FINAL_PREFIX} → prefisso finale delle tabelle
{WPSTG_NULL} → NULL SQL
{WPSTG_BINARY} → tipo di dato BINARY

Sostituire l’URL del sito e il prefisso del database

Estrai cambiando l’URL del sito e il prefisso del database per un nuovo ambiente:

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

Nota: il flag --normalizedb è obbligatorio quando si usa --site-url o --db-prefix.

Filtrare cosa estrarre

Usa i flag --only-* per estrarre solo parti specifiche del Backup:

Flag	Breve	Descrizione
`--only-wproot`	`-r`	Estrai solo i file della root di WordPress
`--only-wpcontent`	`-w`	Estrai solo la directory wp-content
`--only-plugins`	`-i`	Estrai solo i Plugin
`--only-themes`	`-t`	Estrai solo i Theme
`--only-muplugins`	`-m`	Estrai solo i must-use Plugin
`--only-uploads`	`-u`	Estrai solo gli uploads
`--only-languages`	`-g`	Estrai solo i file delle lingue
`--only-dbfile`	`-b`	Estrai solo il file del database
`--only-dropins`	`-e`	Estrai solo i file drop-in
`--only-file`	`-f`	Estrai solo i file che corrispondono a questo nome

Esempio – Estrarre solo il file del database:

wpstaging extract --only-dbfile backup.wpstg

Esempio – Estrarre solo i Plugin:

wpstaging extract -i backup.wpstg

Saltare parti specifiche

Usa i flag --skip-* per escludere alcune parti dall’estrazione:

Flag	Breve	Descrizione
`--skip-wproot`	`-R`	Salta i file della root di WordPress
`--skip-wpcontent`	`-W`	Salta la directory wp-content
`--skip-plugins`	`-I`	Salta i Plugin
`--skip-themes`	`-T`	Salta i Theme
`--skip-muplugins`	`-M`	Salta i must-use Plugin
`--skip-uploads`	`-U`	Salta gli uploads
`--skip-languages`	`-G`	Salta i file delle lingue
`--skip-dbfile`	`-B`	Salta il file del database
`--skip-dropins`	`-E`	Salta i file drop-in
`--skip-file`	`-F`	Salta i file che corrispondono a questo nome

Esempio – Estrarre tutto tranne gli uploads:

wpstaging extract --skip-uploads backup.wpstg

Esempio – Saltare database e uploads:

wpstaging extract -B -U backup.wpstg

Verificare i file estratti

Verifica l’integrità dei file estratti confrontando i checksum con quelli del Backup:

wpstaging extract --verify backup.wpstg

Comportamento di sovrascrittura

Per impostazione predefinita, l’estrazione sovrascrive i file esistenti. Per controllare questo comportamento:

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

Tutti i flag di estrazione

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)

Casi d’uso comuni

Ripristino d’emergenza

Estrai i file da un Backup quando la tua installazione WordPress non funziona:

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

Estrarre solo il database per l’importazione manuale

Ottieni solo il file SQL del database:

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

Migrare a un nuovo dominio

Estrai con un nuovo URL del sito per la migrazione:

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

Prossimi passi

Ripristinare WordPress da un Backup – Per un ripristino automatico completo
Ispezionare i file di Backup – Visualizza il contenuto del Backup prima di estrarlo
Creare una copia locale del sito WordPress – Configura una copia locale basata su Docker

Estrarre un Backup