Inspecionar Backup

O WP Staging CLI dispõe de comandos para inspecionar ficheiros de backup sem os extrair. Isto é útil para confirmar o conteúdo do backup, consultar metadados e perceber o que está dentro de um backup antes de o extrair.

Comandos de inspeção disponíveis

Ver o cabeçalho do Backup

O cabeçalho contém informação básica sobre o formato do backup:

wpstaging dump-header backup.wpstg

Ou utilize o alias curto:

wpstaging dh backup.wpstg

Exemplo de saída:

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

Isto ajuda-o a confirmar:

• Que o ficheiro de backup é válido
• A versão do formato (v1 ou v2)
• Que ferramenta criou o backup

Ver os metadados do Backup

Os metadados contêm informação detalhada sobre o backup e o site de origem:

wpstaging dump-metadata backup.wpstg

Ou utilize o alias curto:

wpstaging dm backup.wpstg

Exemplo de saída:

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 informação é útil para:

• Confirmar que tem o backup correto
• Verificar o URL do site original antes da restauração
• Perceber as versões do WordPress e do PHP utilizadas
• Conhecer o prefixo da base de dados para a configuração

Ver o índice de ficheiros

O índice de ficheiros mostra todos os ficheiros incluídos no backup:

wpstaging dump-index backup.wpstg

Ou utilize o alias curto:

wpstaging di backup.wpstg

Exemplo de saída:

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 dados detalhados do índice

Para obter informação mais detalhada, incluindo tamanhos e offsets dos ficheiros, utilize a opção --data:

wpstaging dump-index --data backup.wpstg

Exemplo de saída:

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
...

A vista detalhada mostra:

• Path: caminho do ficheiro relativo à raiz do WordPress
• Size: tamanho original do ficheiro em bytes
• Offset: posição dentro do ficheiro de backup
• Chunks: número de blocos de dados (os ficheiros grandes são divididos)

Casos de utilização

Verificar o Backup antes da restauração

Antes de restaurar um backup, verifique o seu conteúdo:

# 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 a data e a origem do Backup

Quando tem vários ficheiros de backup e precisa de os identificar:

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

Verificar a presença de ficheiros específicos

Confirme se determinados ficheiros estão incluídos antes da extração:

# 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

Diagnosticar problemas do Backup

Se a extração falhar, utilize estes 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

Opção de diretório de saída

Todos os comandos de inspeção suportam a opção --outputdir para ficheiros temporários:

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

Compreender a estrutura do Backup

Os backups do WP Staging usam um formato proprietário com os seguintes componentes:

• Cabeçalho: identificador de versão e informação do formato
• Metadados: informação do backup serializada em PHP (data de criação, dados do site, etc.)
• Índice de ficheiros: lista comprimida de ficheiros com caminhos, tamanhos e offsets de blocos
• Dados dos ficheiros: conteúdo dos ficheiros dividido em blocos e comprimido

Os comandos de inspeção interpretam estas secções sem extrair o backup completo, sendo rápidos mesmo para backups grandes.

Próximos passos

• Extrair ficheiros de Backup – Extrair o conteúdo do backup
• Restaurar o WordPress a partir de um Backup – Restauração completa do site
• Criar uma cópia local de um site WordPress – Ambiente local baseado em Docker