DocsWP — WordPress Help

Guide de dépannage

Avant de commencer à signaler un nouveau problème dans le dépôt GitHubGitHub GitHub est un site web qui propose une implémentation en ligne de dépôts git pouvant facilement être partagés, copiés et modifiés par d’autres développeurs. Les dépôts publics sont hébergés gratuitement, tandis que les dépôts privés nécessitent un abonnement payant. GitHub a introduit le concept de « pull request », grâce auquel les modifications de code effectuées dans des branches par des contributeurs peuvent être examinées et discutées avant d’être fusionnées par le propriétaire du dépôt. https://github.com/, assurez-vous de vérifier votre installation locale, car certains paramètres peuvent généralement entraîner un résultat inattendu de vos commandes WP-CLIWP-CLI WP-CLI est l’interface en ligne de commande de WordPress, utilisée pour effectuer des tâches d’administration et de développement de manière programmatique. La page du projet est http://wp-cli.org/ https://make.wordpress.org/cli/.

Comment obtenir des informations plus détaillées sur mon installation de WP-CLI ?

WP-CLI propose la commande wp --info, qui fournit de nombreuses informations sur l’environnement de votre installation de WP-CLI. La sortie vous indiquera,
* sur quel système d’exploitation et avec quel shell vous travaillez
* quel binaire PHPPHP PHP (acronyme récursif de PHP: Hypertext Preprocessor) est un langage de script open source généraliste très répandu, particulièrement adapté au développement web et pouvant être intégré au HTML. https://www.php.net/manual/en/index.php est utilisé pour exécuter WP-CLI
* quelle version de PHP est utilisée
* où se trouve le répertoire racine de WP-CLI
* où se trouve le répertoire vendor de WP-CLI
* avec quel binaire WP-CLI vous travaillez actuellement (chemin du phar)
* où sont stockés les paquets WP-CLI
* où trouver les fichiers de configuration globaux et de projet pour WP-CLI et
* quelle version de WP-CLI vous utilisez.

Que dois-je faire avant de commencer à déboguer des problèmes ?

Avant de commencer à déboguer des problèmes, assurez-vous d’utiliser la dernière version de WP-CLI. La dernière version a peut-être déjà résolu le problème que vous rencontrez. La commande wp cli update mettra à jour votre version de WP-CLI ou confirmera que vous utilisez déjà la dernière version. Si l’installation se bloque, veuillez vous assurer que vous êtes autorisé à vous connecter à GitHub via SSLSSL Secure Socket Layer – chiffrement entre le serveur et le navigateur, dans les deux sens. Empêche les regards indiscrets de voir ce que vous envoyez entre votre navigateur et le serveur. (port 443) et git (port 9418) pour les connexions sortantes.

Que dois-je faire si la sortie de WP-CLI est différente de celle attendue ?

Avant de commencer à examiner un bogue, vous devez connaître les facteurs susceptibles de modifier le comportement par défaut de WP-CLI et savoir comment vérifier s’ils peuvent être à l’origine du problème. Il existe cinq principaux sous-systèmes permettant de modifier ce comportement par défaut : les variables d’environnement, les fichiers de configuration, les paquets WP-CLI, le fichier wp-config.php et les extensions WordPress (extensions, thèmes, extensions obligatoires, drop-ins).

Variables d’environnement

La configuration de votre environnement de travail est un prérequis pour exécuter WP-CLI. Vous pouvez vérifier les paramètres actuels de votre environnement avec la commande shell env.

Si vous souhaitez exécuter WP-CLI à distance via SSHSSH Secure SHell – protocole permettant de se connecter de manière sécurisée à un système distant, en complément ou à la place d’un mot de passe., il est nécessaire que la commande wp soit accessible dans le chemin du serveur distant. Le comportement de WP-CLI peut également être modifié à l’exécution grâce aux variables d’environnement :

  • WP_CLI_CACHE_DIR – Répertoire destiné à stocker le cache de fichiers de WP-CLI. La valeur par défaut est ~/.wp-cli/cache/.
  • WP_CLI_CONFIG_PATH – Chemin vers le fichier global config.yml. La valeur par défaut est ~/.wp-cli/config.yml.
  • WP_CLI_CUSTOM_SHELL – Permet à l’utilisateur de remplacer le shell /bin/bash utilisé par défaut.
  • WP_CLI_DISABLE_AUTO_CHECK_UPDATE – Désactive la vérification automatique des mises à jour de WP-CLI.
  • WP_CLI_DOCKER_NO_TTY – Ignore l’état tty détecté et supprime l’option --tty de docker exec lors de l’exécution de WP-CLI sur un conteneur Docker via SSH.
  • WP_CLI_DOCKER_NO_INTERACTIVE – Ignore l’état tty détecté et supprime l’option --interactive de docker exec lors de l’exécution de WP-CLI sur un conteneur Docker via SSH.
  • WP_CLI_PACKAGES_DIR – Répertoire destiné à stocker les paquets installés via la gestion des paquets de WP-CLI. La valeur par défaut est ~/.wp-cli/packages/.
  • WP_CLI_PHP – Chemin vers le binaire PHP à utiliser lors du remplacement de la valeur système par défaut (fonctionne uniquement pour une installation non-Phar).
  • WP_CLI_PHP_ARGS – Arguments à transmettre au binaire PHP lors de l’appel de WP-CLI (fonctionne uniquement pour une installation non-Phar).
  • WP_CLI_SSH_PRE_CMD – Lors de l’utilisation de --ssh=<ssh>, exécute une commande avant que WP-CLI n’appelle WP-CLI sur le serveur distant.
  • WP_CLI_SSH_BINARY – Lors de l’utilisation de --ssh=<ssh>, il s’agit de la commande qui sera appelée sur la machine distante à la place de wp.
  • WP_CLI_STRICT_ARGS_MODE – Évite toute ambiguïté en indiquant à WP-CLI de traiter comme global tout argument situé avant la commande, et comme local tout argument situé après la commande.
  • WP_CLI_SUPPRESS_GLOBAL_PARAMS – Définissez cette variable sur true pour ne pas afficher les paramètres globaux à la fin de l’écran d’aide. Cela permet de gagner de la place à l’écran pour les utilisateurs avancés.
  • WP_CLI_FORCE_USER_LOGIN – Définissez cette variable sur 1 pour forcer l’interprétation de la valeur fournie à l’option --user comme identifiant de connexion plutôt que comme ID, afin de contourner les types ambigus.
  • WP_CLI_EARLY_REQUIRE – Charge un ou plusieurs fichiers PHP personnalisés (séparés par des virgules) au début du processus d’initialisation.
  • WP_CLI_REQUIRE – Charge un ou plusieurs fichiers PHP personnalisés (séparés par des virgules) après le processus d’initialisation. Cela produit le même effet que --require sur la ligne de commande ou qu’une correspondance require dans un fichier de configuration wp-cli.yml.
  • WP_CLI_USER_AGENT – Définit la valeur de $_SERVER['HTTP_USER_AGENT'] dont dépendent certaines extensions et certains outils.

Pour définir une variable d’environnement à la demande, vous pouvez placer la définition de la variable d’environnement avant la commande WP-CLI que vous souhaitez exécuter (par exemple EDITOR=vim wp post edit 1) ; pour remplacer des variables d’environnement, utilisez export VARIABLE=value dans votre fichier ~/.bashrc ou ~.zhsrc.

Fichiers de configuration de WP-CLI

Les fichiers de configuration vous permettent de personnaliser le comportement de WP-CLI afin de l’adapter à vos besoins personnels ou à ceux de votre projet. Si le fichier de configuration est incorrect ou contient des modifications indésirables du comportement par défaut, la sortie de WP-CLI reflétera très probablement l’erreur.

Notez qu’un fichier de configuration de projet peut remplacer les paramètres d’un fichier de configuration global.

Renommez ou supprimez vos fichiers de configuration et comparez le résultat afin de déterminer si un paramètre de configuration a pu provoquer le problème.

Paquets WP-CLI

Les paquets WP-CLI sont des projets maintenus par la communauté et construits sur WP-CLI. Ils peuvent contenir des commandes WP-CLI, mais aussi simplement étendre WP-CLI d’une manière ou d’une autre. Même si WP-CLI fonctionne parfaitement, un paquet contenant des erreurs peut également provoquer des résultats inattendus. Pour ignorer le chargement de tous les paquets installés, utilisez wp --skip-packages.

Fichier de configuration WordPress (wp-config.php)

Des erreurs peuvent résulter du déplacement ou de la modification de wp-config.php au-delà de ce que WP-CLI prend en charge. Si vous obtenez une erreur d’analyse, vérifiez l’encodage du fichier wp-config.php (UTF-8 sans BOM).

Assurez-vous que la ligne require_once(ABSPATH . 'wp-settings.php'); reste présente dans le fichier wp-config.php et ne modifiez pas wp-config.php au-delà des définitions de constantes. Si vous appelez des fonctions WordPress dans wp-config.php, PHP échouera avec une erreur fatale.

Si vous souhaitez utiliser $_SERVER['HTTP_HOST'] dans votre wp-config.php, vous devrez définir une valeur par défaut dans le contexte WP-CLI :

if ( defined( 'WP_CLI' ) && WP_CLI && ! isset( $_SERVER['HTTP_HOST'] ) ) {
    $_SERVER['HTTP_HOST'] = `example.com';
}

Au lieu de $_SERVER['document_root'], utilisez dirname( __FILE__ ) ou une fonction similaire.

Extensions WordPress

Les thèmes et extensions WordPress peuvent entrer en conflit avec le processus de chargement de WP-CLI ou interférer avec celui-ci, par exemple en redirigeant les utilisateurs. Ils partent souvent du principe que certaines conditions sont réunies alors qu’elles ne le sont pas dans le contexte WP-CLI, comme l’utilisation du nom d’hôte de la requête actuelle (concept qui n’existe pas dans le contexte de la ligne de commande).

Vous pouvez ignorer certaines extensions et certains thèmes (par exemple --skip-plugins=akismet) ou les ignorer entièrement (wp --skip-plugins --skip-themes).

Que dois-je faire si WP-CLI signale une erreur ?

Les problèmes courants résultent de modifications apportées à votre wp-config.php ou à la configuration du serveur web. La section « Problèmes courants » du manuel répertorie les messages d’erreur les plus fréquents et explique comment les gérer.

Essayez de reproduire le problème dans une nouvelle installation de WordPress avec un thème par défaut (Twenty …) et aucune extension installée. Si le problème ne se reproduit que dans un environnement personnalisé, il s’agit d’un bogue de votre environnement, et non de WP-CLI. Veillez également à activer le mode de débogage de WordPress en définissant la constante define( 'WP_DEBUG', true ); dans votre wp-config.php. Cela peut révéler des problèmes liés à votre installation WordPress existante, qui ne sont pas causés par WP-CLI.

Vous pouvez également utiliser le paramètre global WP-CLI --debug pour afficher toutes les erreurs PHP et augmenter la verbosité de l’initialisation de WP-CLI.

J’ai vérifié tous les éléments ci-dessus, mais je rencontre toujours un problème. Où puis-je signaler les problèmes ?

Si vous pensez avoir trouvé un bogue, nous serions ravis que vous nous en informiez afin de pouvoir le corriger.

Le signalement des bogues de WP-CLI est géré sur GitHub. Avant de créer un nouveau problème, veuillez rechercher parmi les problèmes existants afin de vérifier s’il existe déjà une solution. S’il n’existe aucun problème ouvert ou corrigé correspondant à votre bogue, veuillez suivre nos recommandations pour soumettre un rapport de bogue afin de garantir sa prise en charge dans les meilleurs délais. Fournir le résumé, les étapes de reproduction, les détails de l’environnement et les autres informations précisées ci-dessous contribuera à garantir que votre rapport de bogue est complet.

Veuillez nous fournir :
* un résumé du problème sous forme narrative,
* une liste détaillée et précise des étapes permettant de reproduire le problème,
* des informations sur l’environnement dans lequel vous travaillez,
* une description de la manière dont le bogue affecte votre utilisation (c’est-à-dire la comparaison entre les résultats attendus et les résultats réels), y compris le niveau de gravité *,
* les solutions de contournement possibles et
* les informations de diagnostic pertinentes, telles que les rapports de plantage, les traces de la pile ou la sortie de débogage.

Vous trouverez une description détaillée de ces informations relatives à un rapport de problème dans les recommandations pour soumettre un rapport de bogue.