Extraer Backup con WP Staging CLI

El comando extract extrae archivos y base de datos de un Backup de WP Staging (.wpstg) sin necesitar una instalación de WordPress en ejecución. Esto es útil para recuperación de desastres, inspección del sitio o preparación de archivos para importación manual.

Qué obtendrás

Tras la extracción, tendrás:

Todos los archivos de WordPress (núcleo, Themes, Plugins, uploads)
Archivo SQL de base de datos listo para importar
wp-config.php con la configuración original

Extracción básica

Extrae todos los archivos y la base de datos al directorio de salida predeterminado (./wpstaging-output):

wpstaging extract backup.wpstg

O usa el indicador --from:

wpstaging extract --from=backup.wpstg

Extraer desde URL remota

Extrae directamente desde un archivo de Backup remoto sin descargarlo manualmente primero:

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

O pasa la URL directamente como argumento:

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

Qué ocurre:

Valida el archivo remoto (tamaño y formato)
Muestra información del Backup
Pide confirmación antes de descargar
Descarga con indicador de progreso (admite reanudación de descargas interrumpidas)

Extraer a un directorio personalizado

Especifica dónde extraer los archivos:

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

Forma abreviada:

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

Extraer con normalización de base de datos

Los Backups de WP Staging contienen marcadores de posición en el archivo de base de datos. Usa --normalizedb para reemplazarlos con valores reales de modo que el archivo SQL esté listo para herramientas de base de datos estándar:

wpstaging extract --normalizedb backup.wpstg

Esto reemplaza marcadores de posición como:

{WPSTG_TMP_PREFIX} → prefijo de tabla temporal
{WPSTG_FINAL_PREFIX} → prefijo de tabla final
{WPSTG_NULL} → SQL NULL
{WPSTG_BINARY} → tipo de dato BINARY

Reemplazar URL del sitio y prefijo de base de datos

Extrae mientras cambias la URL del sitio y el prefijo de base de datos para un nuevo entorno:

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

Nota: el indicador --normalizedb es necesario cuando se usa --site-url o --db-prefix.

Filtrar qué extraer

Usa los indicadores --only-* para extraer partes específicas del Backup:

Indicador	Corto	Descripción
`--only-wproot`	`-r`	Extraer solo archivos raíz de WordPress
`--only-wpcontent`	`-w`	Extraer solo el directorio wp-content
`--only-plugins`	`-i`	Extraer solo Plugins
`--only-themes`	`-t`	Extraer solo Themes
`--only-muplugins`	`-m`	Extraer solo Plugins de uso obligatorio
`--only-uploads`	`-u`	Extraer solo uploads
`--only-languages`	`-g`	Extraer solo archivos de idioma
`--only-dbfile`	`-b`	Extraer solo el archivo de base de datos
`--only-dropins`	`-e`	Extraer solo archivos drop-in
`--only-file`	`-f`	Extraer solo archivos que coincidan con este nombre

Ejemplo: extraer solo el archivo de base de datos:

wpstaging extract --only-dbfile backup.wpstg

Ejemplo: extraer solo Plugins:

wpstaging extract -i backup.wpstg

Omitir partes específicas

Usa los indicadores --skip-* para excluir partes de la extracción:

Indicador	Corto	Descripción
`--skip-wproot`	`-R`	Omitir archivos raíz de WordPress
`--skip-wpcontent`	`-W`	Omitir el directorio wp-content
`--skip-plugins`	`-I`	Omitir Plugins
`--skip-themes`	`-T`	Omitir Themes
`--skip-muplugins`	`-M`	Omitir Plugins de uso obligatorio
`--skip-uploads`	`-U`	Omitir uploads
`--skip-languages`	`-G`	Omitir archivos de idioma
`--skip-dbfile`	`-B`	Omitir el archivo de base de datos
`--skip-dropins`	`-E`	Omitir archivos drop-in
`--skip-file`	`-F`	Omitir archivos que coincidan con este nombre

Ejemplo: extraer todo excepto uploads:

wpstaging extract --skip-uploads backup.wpstg

Ejemplo: omitir base de datos y uploads:

wpstaging extract -B -U backup.wpstg

Verificar archivos extraídos

Verifica la integridad de los archivos extraídos comparando checksums con el Backup:

wpstaging extract --verify backup.wpstg

Comportamiento de sobreescritura

Por defecto, la extracción sobreescribe los archivos existentes. Para controlar esto:

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

Todos los indicadores de extracción

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)

Casos de uso comunes

Recuperación de desastres

Extrae archivos de un Backup cuando tu instalación de WordPress está dañada:

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

Extraer solo la base de datos para importación manual

Obtén solo el archivo SQL de base de datos:

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

Migrar a un nuevo dominio

Extrae con la nueva URL del sitio para la migración:

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

Pasos siguientes

Restaurar WordPress desde un Backup – Para restauración automatizada completa
Inspeccionar archivos de Backup – Ver el contenido del Backup antes de extraerlo
Crear una copia local del sitio de WordPress – Configurar una copia local basada en Docker

Extraer Backup