Inspeccionar Backup

WP Staging CLI provides commands to inspect backup files without extracting them. This is useful for verifying backup contents, checking backup metadata, and understanding what’s inside a backup before extraction.

Comandos de inspección disponibles

Ver la cabecera del Backup

La cabecera contiene información básica sobre el formato del Backup:

wpstaging dump-header backup.wpstg

O usa el alias abreviado:

wpstaging dh backup.wpstg

Ejemplo de salida:

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

Esto te ayuda a verificar:

• El archivo de Backup es válido
• La versión del formato (v1 o v2)
• Qué herramienta creó el Backup

Ver los metadatos del Backup

Los metadatos contienen información detallada sobre el Backup y el sitio de origen:

wpstaging dump-metadata backup.wpstg

O usa el alias abreviado:

wpstaging dm backup.wpstg

Ejemplo de salida:

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

Esta información es útil para:

• Verificar que tienes el Backup correcto
• Comprobar la URL original del sitio antes de la restauración
• Entender las versiones de WordPress y PHP utilizadas
• Conocer el prefijo de base de datos para la configuración

Ver el índice de archivos

El índice de archivos muestra todos los archivos incluidos en el Backup:

wpstaging dump-index backup.wpstg

O usa el alias abreviado:

wpstaging di backup.wpstg

Ejemplo de salida:

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

Ver datos detallados del índice

Para información más detallada, incluidos tamaños de archivo y desplazamientos, usa el indicador --data:

wpstaging dump-index --data backup.wpstg

Ejemplo de salida:

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 detallada muestra:

• Ruta: ruta del archivo relativa a la raíz de WordPress
• Tamaño: tamaño original del archivo en bytes
• Desplazamiento: posición en el archivo de Backup
• Fragmentos: número de fragmentos de datos (los archivos grandes se dividen)

Casos de uso

Verificar el Backup antes de la restauración

Antes de restaurar un Backup, comprueba su contenido:

# 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"

Identificar la fecha y el origen del Backup

Cuando tienes varios archivos de Backup y necesitas identificarlos:

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

Comprobar archivos específicos

Verifica que los archivos específicos están incluidos antes de la extracción:

# 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

Solucionar problemas de Backup

Si la extracción falla, usa estos comandos para diagnosticar:

# 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

Opción de directorio de salida

Todos los comandos de inspección admiten el indicador --outputdir para archivos temporales:

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

Entender la estructura del Backup

Los Backups de WP Staging usan un formato propietario con estos componentes:

• Cabecera: identificador de versión e información de formato
• Metadatos: información del Backup serializada en PHP (fecha de creación, información del sitio, etc.)
• Índice de archivos: lista comprimida de archivos con rutas, tamaños y desplazamientos de fragmentos
• Datos de archivos: contenido de archivos fragmentado y comprimido

Los comandos de inspección analizan estas secciones sin extraer el Backup completo, lo que los hace rápidos incluso para Backups de gran tamaño.

Pasos siguientes

• Extraer archivos de Backup – Extrae el contenido del Backup
• Restaurar WordPress desde un Backup – Restauración completa del sitio
• Create a Local Copy of WordPress Site – Docker-based local environment