{"id":230624,"date":"2022-12-04T16:45:00","date_gmt":"2022-12-04T13:45:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=230624"},"modified":"2022-12-04T16:45:42","modified_gmt":"2022-12-04T13:45:42","slug":"lire-et-comprendre-les-journaux-derreurs-de-wordpress-partie-1","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/fr\/lire-et-comprendre-les-journaux-derreurs-de-wordpress-partie-1\/","title":{"rendered":"Lire et comprendre les journaux d’erreurs de WordPress, partie 1"},"content":{"rendered":"\n

Alors que nous continuons \u00e0 regarder ce que signifie \u00eatre un d\u00e9veloppeur WordPress ind\u00e9pendant<\/a><\/strong>, les outils n\u00e9cessaires et les diff\u00e9rentes strat\u00e9gies qui peuvent am\u00e9liorer nos comp\u00e9tences, j’ai parl\u00e9 des diff\u00e9rentes constantes, plugins et outils pour nous aider.<\/p>\n

Si vous venez de tomber sur cet article, je vous recommande de consulter mon guide des outils de d\u00e9bogage WordPress natifs<\/a><\/strong> ainsi que le reste des articles de la s\u00e9rie jusqu’\u00e0 pr\u00e9sent.<\/a><\/strong><\/p>\n

Apr\u00e8s tout, je trouve important que nous travaillions tous sur la m\u00eame base \u2013 ou quelque chose de \u00e9troitement li\u00e9 \u2013 lorsque nous parcourons ces informations.<\/p>\n

\"Lire<\/a><\/p>\n

En fin de compte, utiliser un outil comme Xdebug<\/a><\/strong> est indispensable, mais il faut travailler jusqu’\u00e0 cela (pour les curieux, j’ai \u00e9crit un petit guide<\/a><\/strong> \u00e0 ce sujet il y a un peu plus d’un an).<\/p>\n

Pour l’instant cependant, commen\u00e7ons par les bases. Dans le post pr\u00e9c\u00e9dent, je suis parti avec la d\u00e9claration suivante:<\/p>\n

\n

Dans le prochain article, nous commencerons \u00e0 examiner ce qui est n\u00e9cessaire pour examiner le journal des erreurs g\u00e9n\u00e9r\u00e9 par WordPress et comment comprendre les informations que nous voyons.<\/p>\n<\/blockquote>\n

Et c’est ce que je veux examiner aujourd’hui parce que, si rien d’autre, cela vous donnera quelque chose de pratique sur lequel travailler.<\/p>\n

Comprendre les journaux d’erreurs de WordPress, partie 1<\/h2>\n

Avant d’aller trop loin dans cela, je veux r\u00e9pondre \u00e0 une question qui a \u00e9t\u00e9 soulev\u00e9e par un membre du site.<\/p>\n

A savoir, on m’a demand\u00e9 :<\/p>\n

\n

Quand allons-nous nous pencher sur les principes orient\u00e9s objet\u00a0?<\/p>\n<\/blockquote>\n

Bien que j’en ai parl\u00e9 un peu dans une s\u00e9rie pr\u00e9c\u00e9dente<\/a><\/strong>, c’est quelque chose que je travaille \u00e0 couvrir plus en profondeur plus tard dans cette s\u00e9rie.<\/p>\n

Cela dit, cependant, commen\u00e7ons \u00e0 regarder les journaux d’erreurs.<\/p>\n

Configuration de vos constantes<\/h3>\n

Si vous n’avez pas configur\u00e9 les constantes dans votre fichier wp-config.php<\/strong>, je vous recommande de le faire maintenant car cela vous donnera le plus haut niveau de granualit\u00e9 lors de l’examen des probl\u00e8mes qui pourraient survenir.<\/p>\n

Si vous n’avez pas rattrap\u00e9 votre retard, assurez-vous de lire cet article<\/a><\/strong> (et si c’est le cas, assurez -vous que les constantes suivantes<\/a><\/strong> sont d\u00e9finies dans votre fichier de configuration)\u00a0:<\/p>\n

<?php\ndefine( 'WP_DEBUG', true );\ndefine( 'WP_DEBUG_LOG', true );\ndefine( 'WP_DEBUG_DISPLAY', true );\n@ini_set( 'display_errors', 1 );\ndefine( 'SCRIPT_DEBUG', true );\ndefine( 'SAVEQUERIES', true );<\/code><\/pre>\n
Une fois ceux-ci en place, vous avez tout ce dont vous avez besoin non seulement pour voir les informations \u00e0 l’\u00e9cran, mais \u00e9galement dans le journal de d\u00e9bogage que WordPress g\u00e9n\u00e9rera.<\/p>\n
O\u00f9 est le journal\u00a0?<\/h3>\n
Selon la nature de votre environnement, cela peut varier ; cependant, dans la plupart des cas, vous trouverez debug.log<\/strong> dans le r\u00e9pertoire wp-content<\/strong> situ\u00e9 au- dessus des r\u00e9pertoires plugins<\/strong>, themes<\/strong> et uploads<\/strong>.<\/p>\n
\"Lire<\/a><\/p>\n
Comme vous pouvez le voir dans l’aper\u00e7u de la capture d’\u00e9cran ci-dessus, mon fichier de d\u00e9bogage contient beaucoup de contenu. Nous examinerons cela plus en profondeur dans la section suivante, ainsi que la fa\u00e7on de le comprendre. En attendant, cependant, v\u00e9rifiez si ce fichier existe m\u00eame. Si c’est le cas, n’h\u00e9sitez pas \u00e0 aller de l’avant et \u00e0 parcourir le contenu du fichier. Vous ne comprenez peut-\u00eatre pas grand-chose \u00e0 ce qui se passe, mais le contenu du fichier signifie que quelque chose dans un th\u00e8me ou un plug-in d\u00e9clenche divers avertissements, avis et erreurs PHP<\/a><\/strong> que WordPress d\u00e9tecte et transf\u00e8re dans le fichier journal.<\/p>\n
Qu’est-ce que le fichier journal signifie m\u00eame\u00a0?<\/h3>\n
Cela ne signifie pas n\u00e9cessairement que quelque chose est cass\u00e9, mais cela indique que quelque chose ne fonctionne pas comme il se doit, n’est pas correctement d\u00e9tect\u00e9 et g\u00e9r\u00e9 au niveau programmatique, ou fait simplement quelque chose qu’il ne devrait pas faire.<\/p>\n
\"Lire<\/a><\/p>\n
Il n’a pas \u00e0 ressembler \u00e0 \u00e7a (mais c’est possible !).<\/p>\n
En tant que d\u00e9veloppeurs, nous devons nous efforcer de nous assurer que notre code ne g\u00e9n\u00e8re rien qui serait \u00e9crit dans le journal des erreurs.<\/p>\n
C’est une chose de le faire en d\u00e9veloppement car nous sommes en mesure d’avoir un aper\u00e7u de ce que nous faisons et de la performance de WordPress. C’est une autre chose, cependant, pour quelque chose que nous publions au niveau de la production pour g\u00e9n\u00e9rer de telles choses.<\/p>\n
Lecture du journal des erreurs<\/h3>\n
\u00c9videmment, il y a plus \u00e0 lire le journal des erreurs plut\u00f4t que de simplement l’ouvrir. Pour beaucoup, l’impression initiale est qu’il peut s’agir d’un tas de jargon. Je comprends \u00e7a aussi. Mais quand vous comprenez ce qu’il vous montre, c’est beaucoup plus facile \u00e0 comprendre.<\/p>\n
Prenons donc un exemple tr\u00e8s simple. Ce n’est pas non plus un exemple artificiel. En fait, celui-ci provient d’un plugin sur lequel je travaillais. Le journal des erreurs contient les informations suivantes<\/a><\/strong>\u00a0:<\/p>\n
[05-Jul-2018 19:43:53 UTC] PHP Fatal error:  Uncaught Error: Class 'EasyEmailExportAdminEmailExportSubmenu' not found in \/Users\/tommcfarlin\/Dropbox\/Projects\/trunk\/wp-content\/plugins\/easy-email-export\/easy-email-export.php:37\n#8 \/U in \/Users\/tommcfarlin\/Dropbox\/Projects\/trunk\/wp-content\/plugins\/easy-email-export\/easy-email-export.php on line 37\n[05-Jul-2018 19:44:03 UTC] PHP Warning:  include_once(.\/src\/Admin\/EmailExportSubmenu.php): failed to open stream: No such file or directory in \/Users\/tommcfarlin\/Dropbox\/Projects\/trunk\/wp-content\/plugins\/easy-email-export\/easy-email-export.php on line 25\n[05-Jul-2018 19:44:03 UTC] PHP Warning:  include_once(): Failed opening '.\/src\/Admin\/EmailExportSubmenu.php' for inclusion (include_path='.:\/usr\/local\/Cellar\/php\/7.2.5\/share\/php\/pear') in \/Users\/tommcfarlin\/Dropbox\/Projects\/trunk\/wp-content\/plugins\/easy-email-export\/easy-email-export.php on line 25<\/code><\/pre>\n
Notez que, dans l’essentiel ci-dessus, il y a trois lignes. Le meilleur plan d’action lors de la lecture des journaux d’erreurs est de commencer par le bas et de remonter. En effet, lors de l’ex\u00e9cution, les choses fonctionnent sur une pile.<\/p>\n
Une courte digression sur les piles<\/h4>\n
Je n’entrerai pas dans la d\u00e9finition informatique du terme, mais le code est ex\u00e9cut\u00e9 et fonctionne de telle mani\u00e8re que les fonctions se produisent et litt\u00e9ralement, dans la m\u00e9moire d’un ordinateur, s’empilent les unes sur les autres.<\/p>\n
Ainsi, la chose la plus r\u00e9cente \u00e0 ex\u00e9cuter sera toujours en haut l\u00e0 o\u00f9 la racine de l’endroit o\u00f9 elle commence est en bas. Puisque nous \u00e9crivons du code sur une application pr\u00e9existante, c’est-\u00e0-dire WordPress ; alors notre code est susceptible d’\u00eatre toujours au sommet.<\/p>\n
\"Lire<\/a><\/p>\n
Comprendre les journaux d’erreurs WordPress\u00a0: ce n’est pas ce genre de pile<\/p>\n
L’id\u00e9e est que le code commencera \u00e0 s’ex\u00e9cuter dans WordPress et progressera jusqu’au travail que nous faisons. Lorsqu’il y a un avis, un avertissement ou une erreur, cela se trouve g\u00e9n\u00e9ralement dans notre code (bien que WordPress ne soit pas exempt\u00e9, c’est g\u00e9n\u00e9ralement le cas).<\/p>\n
Ainsi, lorsque vous lisez le journal des erreurs, vous lisez essentiellement ce que l’on appelle une trace de pile.<\/a><\/strong> Wikip\u00e9dia, tel que li\u00e9, a une d\u00e9finition assez d\u00e9taill\u00e9e sur le sujet, mais peut-\u00eatre que la partie la plus pertinente de cet article est la suivante\u00a0:<\/p>\n
\n
Les programmeurs utilisent couramment le tra\u00e7age de pile pendant le [d\u00e9bogage] interactif et post-mortem (https:\/\/en.wikipedia.org\/wiki\/Debugging<\/a>). Les utilisateurs finaux peuvent voir une trace de pile affich\u00e9e dans le cadre d’un message d’erreur<\/a>, que l’utilisateur peut ensuite signaler \u00e0 un programmeur.<\/p>\n<\/blockquote>\n
Cela correspond \u00e0 ce que j’ai d\u00e9crit ci-dessus, n’est-ce pas\u00a0? Mais assez parl\u00e9 de ce qu’est une trace de pile (cela deviendra plus clair au fur et \u00e0 mesure que nous approfondirons le d\u00e9bogage), revenons \u00e0 la lecture du fichier journal tel qu’il se pr\u00e9sente actuellement.<\/p>\n
Retour \u00e0 la lecture du journal<\/h3>\n
Inclure des fichiers<\/h4>\n
Tout d’abord, regardons l’essentiel dans l’essentiel ci-dessus. Il contient les \u00e9l\u00e9ments suivants\u00a0:<\/p>\n
[05-Jul-2018 19:44:03 UTC] PHP Warning: include_once(): Failed opening '.\/src\/Admin\/EmailExportSubmenu.php' for inclusion (include_path='.:\/usr\/local\/Cellar\/php\/7.2.5\/share\/php\/pear') in \/Users\/tommcfarlin\/Dropbox\/Projects\/trunk\/wp-content\/plugins\/easy-email-export\/easy-email-export.php on line 25<\/code><\/pre>\n
Cela me dit qu’\u00e0 la ligne 25 de mon fichier, easy-email-export.php,<\/strong> il n’a pas r\u00e9ussi \u00e0 ouvrir un fichier \u00e0 inclure. Cela signifie que j’ai une instruction include_once<\/strong> dans le code qui fait r\u00e9f\u00e9rence \u00e0 .\/src\/Admin\/EmailExportSubmenu.php<\/strong> qu’il ne trouve pas.<\/p>\n
Donc, le meilleur plan d’action serait de trouver la ligne 25 et de d\u00e9terminer pourquoi il ne localise pas le fichier. Peut-\u00eatre que cela vide le chemin complet de l’endroit o\u00f9 il regarde. Nous y reviendrons momentan\u00e9ment lorsque nous parlerons de l’\u00e9criture dans le journal des erreurs.<\/p>\n
Donner un sens aux erreurs<\/h4>\n
Sur la ligne suivante (c’est-\u00e0-dire la ligne au-dessus de celle que nous venons de regarder) contient ce qui suit\u00a0:<\/p>\n
[05-Jul-2018 19:44:03 UTC] PHP Warning: include_once(.\/src\/Admin\/EmailExportSubmenu.php): failed to open stream: No such file or directory in \/Users\/tommcfarlin\/Dropbox\/Projects\/trunk\/wp-content\/plugins\/easy-email-export\/easy-email-export.php on line 25<\/code><\/pre>\n
Cette ligne particuli\u00e8re ne diff\u00e8re que l\u00e9g\u00e8rement, mais elle donne un aper\u00e7u suppl\u00e9mentaire et cela est contenu dans la clause qui lit "Aucun fichier ou r\u00e9pertoire de ce type". C’est perspicace car cela nous dit litt\u00e9ralement que le fichier n’existe pas.<\/p>\n
Au moins, il n’existe pas l\u00e0 o\u00f9 il regarde. Donc les deux possibilit\u00e9s sont :<\/p>\n
    \n
  1. nous n’avons pas cr\u00e9\u00e9 le fichier auquel nous nous r\u00e9f\u00e9rons,<\/li>\n
  2. nous r\u00e9f\u00e9ren\u00e7ons l’emplacement du fichier au mauvais endroit<\/li>\n<\/ol>\n
    Ainsi, la premi\u00e8re chose que nous devons v\u00e9rifier est si le fichier existe \u00e0 l’emplacement que nous essayons d’inclure. Si ce n’est pas le cas, nous devrions cr\u00e9er le fichier.<\/p>\n
    Si le fichier existe, nous savons que le plugin cherche \u00e0 le charger \u00e0 partir du mauvais chemin. Nous devrons donc peut-\u00eatre regarder notre autoloader<\/a><\/strong>, notre chemin d’inclusion ou la mani\u00e8re dont les fichiers sont r\u00e9cup\u00e9r\u00e9s. Parce que, si le fichier existe, il y a de fortes chances qu’il essaie d’\u00eatre charg\u00e9 \u00e0 partir d’un endroit o\u00f9 il ne r\u00e9side pas.<\/p>\n
    Une erreur non d\u00e9tect\u00e9e<\/h3>\n
    Dans la derni\u00e8re ligne du code, vous verrez quelque chose comme ceci\u00a0:<\/p>\n
    [05-Jul-2018 19:43:53 UTC] PHP Fatal error: Uncaught Error: Class 'EasyEmailExportAdminEmailExportSubmenu' not found in \/Users\/tommcfarlin\/Dropbox\/Projects\/trunk\/wp-content\/plugins\/easy-email-export\/easy-email-export.php:37\n#8 \/U in \/Users\/tommcfarlin\/Dropbox\/Projects\/trunk\/wp-content\/plugins\/easy-email-export\/easy-email-export.php on line 37<\/code><\/pre>\n
    C’est un bon exemple, d’abord, parce qu’il d\u00e9clare explicitement qu’il s’agit d’une erreur non intercept\u00e9e. Cela signifie que quelle que soit la fonctionnalit\u00e9, quelque chose g\u00e9n\u00e8re une erreur et elle n’est pas d\u00e9tect\u00e9e.<\/p>\n