Ispezionare un Backup

WP Staging CLI offre comandi per ispezionare i file di Backup senza estrarli. È utile per verificare il contenuto di un Backup, controllarne i metadati e capire cosa contiene prima di procedere con l’estrazione.

Comandi di ispezione disponibili

Visualizzare l’header del Backup

L’header contiene le informazioni di base sul formato del Backup:

wpstaging dump-header backup.wpstg

In alternativa usa l’alias breve:

wpstaging dh backup.wpstg

Esempio di output:

Backup Header Information
-------------------------
Format Version: v2
Compression: gzip
Created By: WP STAGING Pro 5.x

Questo ti aiuta a verificare:

• Che il file di Backup sia valido
• La versione del formato (v1 o v2)
• Quale strumento ha creato il Backup

Visualizzare i metadati del Backup

I metadati contengono informazioni dettagliate sul Backup e sul sito di origine:

wpstaging dump-metadata backup.wpstg

In alternativa usa l’alias breve:

wpstaging dm backup.wpstg

Esempio di output:

Backup Metadata
---------------
Site URL: https://example.com
Site Name: My WordPress Site
WordPress Version: 6.4.2
PHP Version: 8.1.27
Database Prefix: wp_
Backup Date: 2024-01-15 14:30:00 UTC
Backup Size: 1.2 GB
Files Count: 15,432
Is Multisite: No

Queste informazioni sono utili per:

• Verificare di avere il Backup corretto
• Controllare l’URL originale del sito prima del ripristino
• Capire quali versioni di WordPress e PHP sono state utilizzate
• Conoscere il prefisso del database da configurare

Visualizzare l’indice dei file

L’indice dei file mostra tutti i file inclusi nel Backup:

wpstaging dump-index backup.wpstg

In alternativa usa l’alias breve:

wpstaging di backup.wpstg

Esempio di output:

File Index
----------
wp-config.php
wp-content/themes/twentytwentyfour/style.css
wp-content/themes/twentytwentyfour/functions.php
wp-content/plugins/wp-staging-pro/wp-staging-pro.php
wp-content/uploads/2024/01/image.jpg
...
Total: 15,432 files

Visualizzare l’indice in modalità dettagliata

Per informazioni più dettagliate, comprese dimensioni dei file e offset, usa il flag --data:

wpstaging dump-index --data backup.wpstg

Esempio di output:

File Index (Detailed)
---------------------
Path                                          Size        Offset      Chunks
wp-config.php                                 3,245       1024        1
wp-content/themes/twentytwentyfour/style.css  45,678      4,269       1
wp-content/uploads/2024/01/large-image.jpg    5,234,567   50,000      3
...

La vista dettagliata mostra:

• Path: percorso del file relativo alla root di WordPress
• Size: dimensione originale del file in byte
• Offset: posizione all’interno del file di Backup
• Chunks: numero di chunk di dati (i file di grandi dimensioni vengono suddivisi)

Casi d’uso

Verificare un Backup prima del ripristino

Prima di ripristinare un Backup, controllane il contenuto:

# Check it's the right site
wpstaging dm backup.wpstg

# Verify specific files are included
wpstaging di backup.wpstg | grep wp-config.php
wpstaging di backup.wpstg | grep "my-custom-plugin"

Identificare data e origine del Backup

Quando hai più file di Backup e devi distinguerli:

# Check each backup's metadata
wpstaging dm backup-2024-01-15.wpstg
wpstaging dm backup-2024-01-20.wpstg

Cercare file specifici

Verifica che alcuni file siano presenti prima dell’estrazione:

# Check if database file is included
wpstaging di backup.wpstg | grep "\.sql"

# Check for specific plugin
wpstaging di backup.wpstg | grep "woocommerce"

# Check for uploads
wpstaging di backup.wpstg | grep "wp-content/uploads" | head -20

Risolvere i problemi del Backup

Se l’estrazione fallisce, usa questi comandi per la diagnosi:

# Verify backup is valid
wpstaging dh backup.wpstg

# Check if metadata is readable
wpstaging dm backup.wpstg

# Verify file index is intact
wpstaging di backup.wpstg

Opzione directory di output

Tutti i comandi di ispezione supportano il flag --outputdir per i file temporanei:

wpstaging dump-metadata --outputdir=/tmp/wpstaging backup.wpstg

Capire la struttura del Backup

I Backup di WP Staging usano un formato proprietario composto da queste sezioni:

• Header: identificatore di versione e informazioni sul formato
• Metadata: informazioni del Backup serializzate in PHP (data di creazione, info sul sito, ecc.)
• File Index: elenco compresso dei file con percorsi, dimensioni e offset dei chunk
• File Data: contenuti dei file suddivisi in chunk e compressi

I comandi di ispezione analizzano queste sezioni senza estrarre l’intero Backup, risultando rapidi anche con Backup di grandi dimensioni.

Prossimi passi

• Estrarre i file di Backup – Estrai il contenuto del Backup
• Ripristinare WordPress da un Backup – Ripristino completo del sito
• Creare una copia locale del sito WordPress – Ambiente locale basato su Docker