Maîtriser la commande Search-Replace en utilisant la CLI de WP
Vous devez mettre à jour les URL de votre site WordPress ? C'est un casse-tête de le faire manuellement. La commande de recherche-remplacement de l'interface de programmation de WordPress rend cela beaucoup plus facile. Une simple commande et vous pouvez changer le texte n'importe où dans votre base de données - pas besoin de cliquer sur les pages ou de risquer des erreurs de base de données.
Dans cet article, nous allons discuter de la fonction Rechercher et Remplacer de l'interface de programmation de WordPress et de la façon dont vous pouvez l'utiliser.
Qu'est-ce que le WP CLI ?
WP CLI vous permet de gérer WordPress à partir de votre ligne de commande au lieu de cliquer sur le tableau de bord d'administration. Avec de simples commandes, vous pouvez mettre à jour votre site, sauvegarder votre base de données ou publier des articles. Il est particulièrement utile pour les tâches répétitives et la gestion de plusieurs sites. Ce qui prend plusieurs clics dans le tableau de bord peut être fait avec une seule commande.
Qu'est-ce que la fonction de recherche et de remplacement ?
La commande WP search-replace est l'une des fonctionnalités les plus utiles de WP CLI. Elle recherche une chaîne de caractères dans toutes les lignes d'une table de base de données sélectionnée, et la remplace en bloc par une autre chaîne de caractères. Une caractéristique notable de la commande WP search-replace est sa capacité à décompresser les charges utiles JSON et à gérer les données sérialisées PHP.
Quand faut-il utiliser la fonction de recherche-remplacement ?
Dans de nombreuses situations, la commande rechercher-remplacer peut s'avérer salvatrice :
- Correction des erreurs d'encodage : Correction des caractères corrompus dus à des problèmes d'encodage afin de rétablir une mise en forme correcte du texte.
- Migrations de sites : Lorsque vous déplacez votre site ou celui de votre client vers un nouvel hébergeur.
- Lancement d'un site d'essai : Lors de la mise en ligne d'un site de développement ou d'un site d'essai.
- Mises à jour d'URL en masse : Mise à jour des liens sur l'ensemble de votre site lorsque la structure des URL est modifiée à la suite d'un changement de marque ou d'une mise à jour du système.
Comment utiliser la fonction Search-Replace de WP-CLI
Voici quelques étapes simples pour vous aider à commencer à utiliser la fonction de recherche-remplacement.
Prérequis :
- Une application SSH.
- Vos coordonnées FTP, comme votre hôte FTP, votre nom d'utilisateur et votre mot de passe
- Utilisez votre nom de domaine ou votre adresse IP pour l'hôte FTP.
- Votre nom d'utilisateur et votre mot de passe FTP se trouvent dans votre compte d'hébergement.
- Installez WP-CLI si vous utilisez un VPS ou un serveur dédié.
Remarque : sauvegardez toujours votre site web avant d'apporter des modifications à la base de données. De cette manière, vous pourrez toujours restaurer votre site en cas d'erreur.
Étape 1 : Utiliser SSH pour connecter votre compte d'hébergement
Utilisez un terminal pour vous connecter à votre serveur.
ssh username@your-server-ipÉtape 2 : Localiser le répertoire dans vos fichiers WordPress
En utilisant la commande bash lspour obtenir la liste des fichiers et des dossiers. Utiliser la commande cd et ../ pour naviguer jusqu'à ce que vous soyez dans le répertoire de vos fichiers WordPress.
Étape 3 : Exécuter la commande Rechercher et remplacer
Utilisez la commande pour rechercher et remplacer du texte dans votre base de données. En voici un exemple
wp search-replace ‘old-string’ ‘new-string’.Voici un exemple de recherche et de remplacement d'une URL :
wp search-replace 'https://domainname.com' 'https://newdomainname.com'(Facultatif) Pour prévisualiser les remplacements, utilisez la commande suivante :
wp search-replace 'https://domainname.com' 'https://newdomainname.com' --dry-runUne fois cette opération effectuée, un message de réussite s'affiche pour confirmer le remplacement des données.
Étape 4 : Vérifier les modifications
Vérifiez votre site web pour confirmer que les changements ont été appliqués correctement.
Voici quelques paramètres que vous pouvez utiliser avec la fonction rechercher-remplacer :
| Commandement | Description |
| <old> | Chaîne de caractères à rechercher dans la base de données. |
| <new> | Remplacer les instances de la première chaîne par cette nouvelle chaîne. |
| <table>… | Liste des tables de la base de données auxquelles restreindre le remplacement. Les caractères génériques sont pris en charge, par exemple wp_*options ou wp_post*. |
| -dry-run | Chaîne contenant l'URL du site web de l'utilisateur. |
| -Réseau | Rechercher/remplacer toutes les tables enregistrées dans $wpdb dans une installation multisite. |
| -all-tables-with-prefix | Active le remplacement sur toutes les tables qui correspondent au préfixe de la table, même si elles ne sont pas enregistrées dans $wpdb. |
| -toutes les tables | Active le remplacement sur TOUTES les tables de la base de données, quel que soit le préfixe, et même si elles ne sont pas enregistrées sur $wpdb. Remplace -network et -all-tables-with-prefix. |
Pour la liste complète, cliquez ici.
Bonus : Utilisez les expressions régulières (RegEx) dans WP search-replace pour trouver et mettre à jour rapidement du texte avec précision. Des symboles comme ^ (début de ligne) et $ (fin de ligne) facilitent les recherches complexes. Les caractères génériques tels que . correspondent à n'importe quel caractère, tandis que * permet zéro ou plusieurs répétitions. Les modificateurs tels que i rendent les recherches insensibles à la casse.
wp search-replace "(?<!@)olddomain\.com" "test.com" --regex --precise --skip-plugins --skip-themes --allow-rootRéflexions finales
La gestion des bases de données WordPress ne doit pas être compliquée. Avec la commande search-replace de WP CLI, vous pouvez faire des changements en masse rapidement et en toute sécurité.
Si vous gérez plusieurs sites web et avez besoin d'un outil de surveillance de site web, essayez WP Umbrella. Il offre des actions en masse (mises à jour sûres, optimisation de la base de données), des sauvegardes automatisées, une surveillance du temps de fonctionnement, des contrôles de sécurité et des rapports détaillés, le tout en un seul endroit. Commencez votre essai gratuit de 14 jours dès aujourd'hui; aucune carte de crédit n'est requise.
Questions fréquemment posées
Vous aurez besoin de compétences de base en ligne de commande et d'un accès SSH à votre serveur. Bien que les commandes soient simples, vous devez être à l'aise avec le terminal, connaître SQL, et comprendre les bases des bases de données WordPress. Assurez-vous que WP CLI est installé et que vous disposez d'un éditeur de texte.
Étant donné que les commandes de recherche-remplacement modifient directement la base de données, il convient d'être prudent lors de leur utilisation. Commencez toujours par l'option -dry-run pour voir ce qui changerait sans apporter de modifications. Cela vous permet de vérifier les résultats avant de toucher à votre base de données. Ajoutez l'option -report-changed-only pour que la sortie soit propre et lisible. Vous pouvez utiliser les deux options ensemble pour obtenir une image claire de ce qui va changer.
Vous ne pouvez annuler les modifications qu'en les restaurant à partir d'une sauvegarde. C'est pourquoi il est essentiel de sauvegarder votre base de données avant d'exécuter des commandes de recherche-remplacement.
WP CLI a trois attributs principaux : les commandes, les paramètres et les drapeaux. Les commandes comme 'wp core update' ou 'wp plugin install' indiquent à WP CLI ce qu'il doit faire. Les paramètres sont des paires nom-valeur qui peuvent être intégrés dans le CLI ou définis comme des variables. Les drapeaux sont des options supplémentaires que vous pouvez ajouter pour personnaliser l'exécution d'une commande. Comprendre ces éléments vous aidera à tirer le meilleur parti des fonctionnalités de WP CLI.