Extraire un Backup

La commande extract extrait les fichiers et la base de données d’un Backup WP Staging (.wpstg) sans nécessiter une installation WordPress en cours d’exécution. C’est utile pour la récupération après sinistre, l’inspection du site ou la préparation des fichiers pour une importation manuelle.

Ce que tu obtiendras

Après l’extraction, tu auras :

Tous les fichiers WordPress (cœur, Themes, Plugins, uploads)
Fichier SQL de base de données prêt à l’importation
wp-config.php avec les paramètres d’origine

Extraction de base

Extrais tous les fichiers et la base de données dans le répertoire de sortie par défaut (./wpstaging-output) :

wpstaging extract backup.wpstg

Ou utilise l’option --from :

wpstaging extract --from=backup.wpstg

Extraire depuis une URL distante

Extrais directement depuis un fichier de Backup distant sans le télécharger manuellement au préalable :

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

Ou passe l’URL directement comme argument :

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

Ce qui se passe :

Valide le fichier distant (taille et format)
Affiche les informations du Backup
Demande une confirmation avant le téléchargement
Télécharge avec un indicateur de progression (prend en charge la reprise pour les téléchargements interrompus)

Extraire vers un répertoire personnalisé

Spécifie où extraire les fichiers :

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

Forme courte :

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

Extraire avec normalisation de la base de données

Les Backups WP Staging contiennent des espaces réservés dans le fichier de base de données. Utilise --normalizedb pour les remplacer par des valeurs réelles afin que le fichier SQL soit prêt pour les outils de base de données standard :

wpstaging extract --normalizedb backup.wpstg

Cela remplace les espaces réservés comme :

{WPSTG_TMP_PREFIX} → préfixe de table temporaire
{WPSTG_FINAL_PREFIX} → préfixe de table final
{WPSTG_NULL} → SQL NULL
{WPSTG_BINARY} → type de données BINARY

Remplacer l’URL du site et le préfixe de base de données

Extrais en changeant l’URL du site et le préfixe de base de données pour un nouvel environnement :

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

Note : L’option --normalizedb est requise lors de l’utilisation de --site-url ou --db-prefix.

Filtrer ce qui doit être extrait

Utilise les options --only-* pour extraire des parties spécifiques du Backup :

Option	Courte	Description
`--only-wproot`	`-r`	Extraire uniquement les fichiers racine WordPress
`--only-wpcontent`	`-w`	Extraire uniquement le répertoire wp-content
`--only-plugins`	`-i`	Extraire uniquement les Plugins
`--only-themes`	`-t`	Extraire uniquement les Themes
`--only-muplugins`	`-m`	Extraire uniquement les Plugins must-use
`--only-uploads`	`-u`	Extraire uniquement les uploads
`--only-languages`	`-g`	Extraire uniquement les fichiers de langue
`--only-dbfile`	`-b`	Extraire uniquement le fichier de base de données
`--only-dropins`	`-e`	Extraire uniquement les fichiers drop-in
`--only-file`	`-f`	Extraire uniquement les fichiers correspondant à ce nom

Exemple – Extraire uniquement le fichier de base de données :

wpstaging extract --only-dbfile backup.wpstg

Exemple – Extraire uniquement les Plugins :

wpstaging extract -i backup.wpstg

Ignorer des parties spécifiques

Utilise les options --skip-* pour exclure des parties de l’extraction :

Option	Courte	Description
`--skip-wproot`	`-R`	Ignorer les fichiers racine WordPress
`--skip-wpcontent`	`-W`	Ignorer le répertoire wp-content
`--skip-plugins`	`-I`	Ignorer les Plugins
`--skip-themes`	`-T`	Ignorer les Themes
`--skip-muplugins`	`-M`	Ignorer les Plugins must-use
`--skip-uploads`	`-U`	Ignorer les uploads
`--skip-languages`	`-G`	Ignorer les fichiers de langue
`--skip-dbfile`	`-B`	Ignorer le fichier de base de données
`--skip-dropins`	`-E`	Ignorer les fichiers drop-in
`--skip-file`	`-F`	Ignorer les fichiers correspondant à ce nom

Exemple – Extraire tout sauf les uploads :

wpstaging extract --skip-uploads backup.wpstg

Exemple – Ignorer la base de données et les uploads :

wpstaging extract -B -U backup.wpstg

Vérifier les fichiers extraits

Vérifie l’intégrité des fichiers extraits en comparant les sommes de contrôle avec le Backup :

wpstaging extract --verify backup.wpstg

Comportement de remplacement

Par défaut, l’extraction remplace les fichiers existants. Pour contrôler ce comportement :

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

Toutes les options d’extraction

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)

Cas d’utilisation courants

Récupération après sinistre

Extrais les fichiers d’un Backup lorsque ton installation WordPress est défaillante :

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

Extraire uniquement la base de données pour une importation manuelle

Obtiens juste le fichier SQL de base de données :

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

Migrer vers un nouveau domaine

Extrais avec la nouvelle URL du site pour la migration :

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

Prochaines étapes

Restaurer WordPress depuis un Backup – Pour une restauration automatique complète
Inspecter les fichiers de Backup – Visualiser le contenu du Backup avant l’extraction
Créer une copie locale d’un site WordPress – Configurer une copie locale basée sur Docker