Inspecter un Backup

WP Staging CLI fournit des commandes pour inspecter les fichiers de Backup sans les extraire. C’est utile pour vérifier le contenu des Backups, contrôler les métadonnées et comprendre ce que contient un Backup avant l’extraction.

Commandes d’inspection disponibles

Voir l’en-tête du Backup

L’en-tête contient des informations de base sur le format du Backup :

wpstaging dump-header backup.wpstg

Ou utilise l’alias court :

wpstaging dh backup.wpstg

Exemple de sortie :

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

Cela t’aide à vérifier :

• Le fichier de Backup est valide
• La version du format (v1 ou v2)
• Quel outil a créé le Backup

Voir les métadonnées du Backup

Les métadonnées contiennent des informations détaillées sur le Backup et le site source :

wpstaging dump-metadata backup.wpstg

Ou utilise l’alias court :

wpstaging dm backup.wpstg

Exemple de sortie :

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

Ces informations sont utiles pour :

• Vérifier que tu as le bon Backup
• Vérifier l’URL du site d’origine avant la restauration
• Comprendre les versions WordPress et PHP utilisées
• Connaître le préfixe de base de données pour la configuration

Voir l’index des fichiers

L’index des fichiers affiche tous les fichiers inclus dans le Backup :

wpstaging dump-index backup.wpstg

Ou utilise l’alias court :

wpstaging di backup.wpstg

Exemple de sortie :

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

Voir les données détaillées de l’index

Pour des informations plus détaillées incluant les tailles de fichiers et les décalages, utilise l’option --data :

wpstaging dump-index --data backup.wpstg

Exemple de sortie :

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 vue détaillée montre :

• Path : chemin du fichier relatif à la racine WordPress
• Size : taille du fichier d’origine en octets
• Offset : position dans le fichier de Backup
• Chunks : nombre de blocs de données (les grands fichiers sont divisés)

Cas d’utilisation

Vérifier le Backup avant la restauration

Avant de restaurer un Backup, vérifie son contenu :

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

Identifier la date et la source du Backup

Lorsque tu as plusieurs fichiers de Backup et que tu dois les identifier :

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

Rechercher des fichiers spécifiques

Vérifie que des fichiers spécifiques sont inclus avant l’extraction :

# 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

Diagnostiquer les problèmes de Backup

Si l’extraction échoue, utilise ces commandes pour diagnostiquer :

# 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

Option de répertoire de sortie

Toutes les commandes d’inspection prennent en charge l’option --outputdir pour les fichiers temporaires :

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

Comprendre la structure du Backup

Les Backups WP Staging utilisent un format propriétaire avec ces composants :

• En-tête : identifiant de version et informations de format
• Métadonnées : informations de Backup sérialisées en PHP (date de création, infos du site, etc.)
• Index des fichiers : liste compressée des fichiers avec chemins, tailles et décalages de blocs
• Données des fichiers : contenu des fichiers découpé en blocs et compressé

Les commandes d’inspection analysent ces sections sans extraire le Backup complet, ce qui les rend rapides même pour les grands Backups.

Prochaines étapes

• Extraire des fichiers de Backup – Extraire le contenu du Backup
• Restaurer WordPress depuis un Backup – Restauration complète du site
• Créer une copie locale d’un site WordPress – Environnement local basé sur Docker