Extrair Backup

O comando extract obtém os ficheiros e a base de dados de um backup WP Staging (.wpstg) sem necessitar de uma instalação WordPress em execução. É útil para recuperação de desastres, inspeção do site ou preparação de ficheiros para importação manual.

O que vai obter

Após a extração ficará com:

Todos os ficheiros WordPress (core, themes, plugins, uploads)
Ficheiro SQL da base de dados pronto a importar
wp-config.php com as definições originais

Extração básica

Extraia todos os ficheiros e a base de dados para o diretório de saída predefinido (./wpstaging-output):

wpstaging extract backup.wpstg

Ou utilize a opção --from:

wpstaging extract --from=backup.wpstg

Extrair de um URL remoto

Extraia diretamente a partir de um ficheiro de backup remoto, sem precisar de o transferir primeiro:

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

Ou passe o URL diretamente como argumento:

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

O que acontece:

Valida o ficheiro remoto (tamanho e formato)
Mostra informação sobre o backup
Pede confirmação antes de transferir
Transfere com indicador de progresso (suporta retoma para transferências interrompidas)

Extrair para um diretório personalizado

Indique onde extrair os ficheiros:

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

Forma abreviada:

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

Extrair com normalização da base de dados

Os backups WP Staging contêm marcadores no ficheiro da base de dados. Utilize --normalizedb para os substituir pelos valores reais, deixando o ficheiro SQL pronto a usar com ferramentas padrão de base de dados:

wpstaging extract --normalizedb backup.wpstg

Isto substitui marcadores como:

{WPSTG_TMP_PREFIX} → prefixo de tabela temporário
{WPSTG_FINAL_PREFIX} → prefixo de tabela final
{WPSTG_NULL} → NULL de SQL
{WPSTG_BINARY} → tipo de dados BINARY

Substituir o URL do site e o prefixo da base de dados

Extraia alterando o URL do site e o prefixo da base de dados para um novo ambiente:

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

Nota: A opção --normalizedb é obrigatória quando utiliza --site-url ou --db-prefix.

Filtrar o que extrair

Utilize as opções --only-* para extrair partes específicas do backup:

Opção	Curta	Descrição
`--only-wproot`	`-r`	Extrair apenas os ficheiros da raiz do WordPress
`--only-wpcontent`	`-w`	Extrair apenas o diretório wp-content
`--only-plugins`	`-i`	Extrair apenas os plugins
`--only-themes`	`-t`	Extrair apenas os themes
`--only-muplugins`	`-m`	Extrair apenas os must-use plugins
`--only-uploads`	`-u`	Extrair apenas os uploads
`--only-languages`	`-g`	Extrair apenas os ficheiros de idioma
`--only-dbfile`	`-b`	Extrair apenas o ficheiro da base de dados
`--only-dropins`	`-e`	Extrair apenas os ficheiros drop-in
`--only-file`	`-f`	Extrair apenas ficheiros com este nome

Exemplo – Extrair apenas o ficheiro da base de dados:

wpstaging extract --only-dbfile backup.wpstg

Exemplo – Extrair apenas os plugins:

wpstaging extract -i backup.wpstg

Ignorar partes específicas

Utilize as opções --skip-* para excluir partes da extração:

Opção	Curta	Descrição
`--skip-wproot`	`-R`	Ignorar os ficheiros da raiz do WordPress
`--skip-wpcontent`	`-W`	Ignorar o diretório wp-content
`--skip-plugins`	`-I`	Ignorar os plugins
`--skip-themes`	`-T`	Ignorar os themes
`--skip-muplugins`	`-M`	Ignorar os must-use plugins
`--skip-uploads`	`-U`	Ignorar os uploads
`--skip-languages`	`-G`	Ignorar os ficheiros de idioma
`--skip-dbfile`	`-B`	Ignorar o ficheiro da base de dados
`--skip-dropins`	`-E`	Ignorar os ficheiros drop-in
`--skip-file`	`-F`	Ignorar ficheiros com este nome

Exemplo – Extrair tudo exceto uploads:

wpstaging extract --skip-uploads backup.wpstg

Exemplo – Ignorar a base de dados e os uploads:

wpstaging extract -B -U backup.wpstg

Verificar os ficheiros extraídos

Verifique a integridade dos ficheiros extraídos comparando os checksums com o backup:

wpstaging extract --verify backup.wpstg

Comportamento de sobreposição

Por predefinição, a extração sobrepõe os ficheiros existentes. Para controlar este comportamento:

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

Todas as opções de extração

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 utilização comuns

Recuperação de desastres

Extraia os ficheiros de um backup quando a sua instalação WordPress estiver danificada:

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

Extrair apenas a base de dados para importação manual

Obtenha apenas o ficheiro SQL da base de dados:

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

Migrar para um novo domínio

Extraia com um novo URL de site para a migração:

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

Próximos passos

Restaurar o WordPress a partir de um Backup – Para uma restauração completa e automatizada
Inspecionar ficheiros de Backup – Veja o conteúdo do backup antes de extrair
Criar uma cópia local de um site WordPress – Configure uma cópia local baseada em Docker