Unpack tar gz : décompresser une archive sur WordPress

Une archive .tar.gz ressemble à une valise bien fermée : elle rassemble plusieurs fichiers et les compresse pour faciliter leur transfert. Pratique pour déplacer un thème, sauvegarder un site ou installer un ensemble de ressources. Mais une fois arrivée sur votre hébergement WordPress, il faut encore l’ouvrir au bon endroit — sans éparpiller son contenu dans tout le site.

La bonne méthode dépend surtout de vos accès : interface de gestion de l’hébergement, connexion SSH ou extension WordPress. Voici comment décompresser une archive proprement, vérifier le résultat et éviter les erreurs qui transforment une petite opération en séance de rangement numérique.

Que contient une archive .tar.gz ?

Le format .tar.gz combine deux opérations. D’abord, tar rassemble plusieurs fichiers et dossiers dans une seule archive. Ensuite, gzip compresse cette archive pour réduire sa taille. En général, la décompression inverse donc ces deux étapes et restitue l’arborescence d’origine.

On rencontre aussi les extensions .tgz et .tar.gzip. Elles désignent souvent un format équivalent, même si le nom le plus répandu reste .tar.gz. Attention à ne pas le confondre avec un fichier .zip : les deux formats ne se manipulent pas toujours avec les mêmes outils.

Sur un site WordPress, ce type d’archive peut contenir un thème, une extension, des images ou une sauvegarde complète. Le contenu n’est pas automatiquement prêt à être utilisé : il faut vérifier ce qui se trouve dans l’archive et choisir un emplacement adapté.

Avant de décompresser : trois vérifications utiles

La première vérification concerne l’origine du fichier. Une archive inconnue peut contenir des fichiers indésirables ou des scripts dangereux. Téléchargez-la depuis une source fiable et, si possible, vérifiez son empreinte ou faites-la analyser par votre outil de sécurité habituel.

Ensuite, regardez l’espace disponible sur l’hébergement. Une archive compressée de quelques centaines de mégaoctets peut occuper beaucoup plus de place une fois ouverte. Si votre espace est limité, la décompression peut échouer à mi-chemin et laisser derrière elle un dossier incomplet.

Enfin, choisissez soigneusement le dossier de destination. Le répertoire public du site contient les fichiers accessibles depuis le Web. Décompresser une sauvegarde complète à sa racine sans vérifier l’arborescence peut écraser des fichiers existants ou créer des dossiers inutiles. Une sauvegarde récente est une précaution simple, mais précieuse.

La méthode la plus simple : le gestionnaire de fichiers

La plupart des hébergeurs proposent un gestionnaire de fichiers accessible depuis leur espace d’administration. C’est souvent le choix le plus confortable si vous ne souhaitez pas utiliser de commandes. Les noms des menus varient selon l’hébergeur, mais le principe reste assez proche.

• Connectez-vous à l’espace de gestion de votre hébergement, puis ouvrez le gestionnaire de fichiers.

• Repérez le dossier du site concerné. Il peut s’appeler public_html, www ou porter le nom de domaine.

• Téléversez l’archive dans un dossier de travail, plutôt qu’à la racine du site si vous n’êtes pas certain de son contenu.

• Sélectionnez le fichier .tar.gz, puis choisissez l’action « Extraire » ou « Décompresser ».

• Indiquez le dossier de destination et vérifiez les fichiers créés avant de les déplacer.

Un détail mérite votre attention : certaines interfaces ne savent pas ouvrir directement une archive .tar.gz. Elles peuvent demander de décompresser d’abord la partie gzip, ce qui produit un fichier .tar, puis d’extraire celui-ci à son tour. Si le gestionnaire indique que le format n’est pas pris en charge, ce n’est pas forcément votre archive qui est en cause.

Après extraction, ouvrez le dossier obtenu et regardez sa structure. Si vous trouvez directement des fichiers comme style.css et functions.php, il peut s’agir du contenu d’un thème. Si vous voyez plutôt un dossier portant le nom du thème, c’est probablement ce dossier complet qu’il faudra placer dans wp-content/themes.

Décompresser avec SSH et la commande tar

Si votre hébergement autorise l’accès SSH, la ligne de commande est généralement la solution la plus rapide. Elle est particulièrement pratique pour les grosses archives, car le fichier reste sur le serveur : vous n’avez pas besoin de le télécharger sur votre ordinateur pour le renvoyer ensuite.

Connectez-vous au serveur avec les identifiants fournis par votre hébergeur, puis placez-vous dans le dossier où se trouve l’archive. La commande de base est :

tar -xzf archive.tar.gz

Les options indiquent à l’outil ce qu’il doit faire : -x extrait les fichiers, -z signale la compression gzip et -f désigne le fichier à traiter. L’ordre des lettres peut varier dans certaines formes de commande, mais écrire -xzf est une habitude courante.

Pour choisir explicitement le dossier de destination, utilisez l’option -C :

tar -xzf archive.tar.gz -C /chemin/vers/destination

Le dossier indiqué doit exister avant l’extraction. Par exemple, pour ouvrir une archive dans un répertoire de travail, vous pouvez créer celui-ci avec mkdir, puis lancer la commande depuis son emplacement. Remplacez bien le chemin d’exemple par le chemin réel de votre hébergement : les chemins copiés au hasard ont une fâcheuse tendance à ne pas mener là où l’on espère.

Vous pouvez également consulter le contenu de l’archive sans extraire ses fichiers :

tar -tzf archive.tar.gz

Cette commande affiche la liste des éléments présents. C’est une bonne habitude avant d’extraire une sauvegarde ou un paquet téléchargé. Si les chemins commencent tous par un dossier inattendu, vous pourrez adapter votre destination avant de remplir le serveur de sous-dossiers imbriqués.

Choisir le bon emplacement dans WordPress

Le dossier de destination dépend de ce que contient l’archive. Pour un thème, le chemin habituel est wp-content/themes/. Pour une extension, c’est wp-content/plugins/. Le résultat doit généralement être un dossier portant le nom du thème ou de l’extension, et non une série de fichiers déposés directement au niveau supérieur.

Par exemple, si l’archive contient mon-theme/style.css, son extraction dans wp-content/themes/ doit produire le chemin wp-content/themes/mon-theme/style.css. Si l’extraction crée plutôt wp-content/themes/mon-theme/mon-theme/style.css, il y a un niveau de dossier en trop. WordPress risque alors de ne pas reconnaître le thème.

Pour une sauvegarde complète, ne décompressez pas tous les fichiers au milieu du site en production sans connaître précisément la procédure de restauration. Une sauvegarde peut contenir des fichiers WordPress, des réglages propres à l’hébergement et des données qui doivent être restaurées dans un ordre particulier. Décompresser n’équivaut pas à restaurer.

Peut-on tout faire depuis l’administration WordPress ?

Pas toujours. La bibliothèque de médias de WordPress accepte des formats d’image, de son et de vidéo, mais elle n’est pas conçue comme un outil général de décompression d’archives. Téléverser un fichier .tar.gz dans la médiathèque peut être refusé, et l’autoriser sans raison précise n’est pas une bonne idée.

Certaines extensions permettent de gérer des fichiers ou des sauvegardes depuis le tableau de bord. Elles peuvent être utiles, mais elles ajoutent une couche d’accès aux fichiers du serveur. Choisissez une extension maintenue, provenant d’une source fiable, et désactivez-la ou supprimez-la lorsque vous n’en avez plus besoin. Un gestionnaire de fichiers accessible depuis le Web ne devrait pas rester ouvert comme une porte de service.

Pour installer un thème ou une extension, la méthode habituelle reste souvent l’envoi d’une archive .zip depuis l’écran d’administration prévu à cet effet. Si vous disposez seulement d’un fichier .tar.gz, vous pouvez l’extraire sur votre ordinateur, puis créer une archive .zip du dossier du thème ou de l’extension, à condition de respecter la bonne structure.

Les erreurs courantes et leurs solutions

• Le format n’est pas reconnu : le gestionnaire de fichiers ne prend peut-être pas en charge les archives gzip. Essayez l’extraction par SSH ou utilisez un outil de décompression adapté sur votre ordinateur.

• L’extraction s’interrompt : vérifiez l’espace disque, les limites de l’hébergement et les droits d’accès au dossier. Pour une archive volumineuse, la ligne de commande évite parfois les limites de durée imposées par une interface Web.

• Les fichiers apparaissent au mauvais endroit : contrôlez le dossier choisi et la structure interne de l’archive. Déplacer le bon dossier au bon niveau suffit souvent à régler le problème.

• WordPress ne détecte pas le thème ou l’extension : vérifiez qu’il ne reste pas un dossier supplémentaire entre le répertoire principal et les fichiers attendus. Pour un thème, la présence de style.css dans son dossier est notamment importante.

• Les fichiers ne sont pas accessibles : examinez leurs permissions avec prudence. Des réglages trop restrictifs empêchent leur lecture ; des permissions trop ouvertes exposent inutilement le site. En cas de doute, demandez à l’hébergeur quelles valeurs sont recommandées.

Évitez de lancer une extraction en tant qu’administrateur système si un compte moins privilégié suffit. Une archive créée par une source externe peut contenir des chemins inhabituels. Un outil récent et une destination isolée réduisent les risques de remplacer des fichiers ou d’écrire en dehors du répertoire prévu.

Une petite routine pour travailler sereinement

Pour une opération sans mauvaise surprise, procédez dans cet ordre : vérifiez la provenance de l’archive, consultez son contenu, confirmez l’espace disponible, choisissez un dossier de destination, puis extrayez les fichiers. Comparez ensuite la structure obtenue avec celle attendue par WordPress et supprimez l’archive si vous n’avez plus besoin de la conserver sur le serveur.

Enfin, testez le site. Si vous venez d’ajouter un thème ou une extension, vérifiez son affichage et son fonctionnement avant de supprimer votre sauvegarde de précaution. Une extraction réussie signifie seulement que les fichiers ont été ouverts. Elle ne garantit ni leur compatibilité avec votre version de WordPress, ni leur innocuité, ni leur bon emplacement.

En résumé, tar -xzf fait le travail lorsque vous avez accès à SSH, tandis que le gestionnaire de fichiers convient très bien aux opérations ponctuelles. Le vrai savoir-faire consiste moins à ouvrir l’archive qu’à savoir ce qu’elle contient et où ses fichiers doivent aller. Sur un site WordPress, quelques secondes consacrées à vérifier l’arborescence peuvent vous épargner une longue chasse au dossier égaré.