{"id":230375,"date":"2022-12-04T17:19:00","date_gmt":"2022-12-04T14:19:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=230375"},"modified":"2022-12-04T17:19:31","modified_gmt":"2022-12-04T14:19:31","slug":"lectura-y-comprension-de-los-registros-de-errores-de-wordpress-parte-1","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/es\/lectura-y-comprension-de-los-registros-de-errores-de-wordpress-parte-1\/","title":{"rendered":"Lectura y comprensi\u00f3n de los registros de errores de WordPress, Parte 1"},"content":{"rendered":"\n

A medida que continuamos analizando lo que significa ser un desarrollador independiente de WordPress<\/a><\/strong>, las herramientas necesarias y las diversas estrategias que pueden mejorar nuestro conjunto de habilidades, he estado hablando sobre las diversas constantes, complementos y herramientas para ayudarnos.<\/p>\n

Si simplemente se est\u00e1 tropezando con esta publicaci\u00f3n, le recomiendo que consulte mi gu\u00eda de herramientas de depuraci\u00f3n nativas de WordPress<\/a><\/strong>, as\u00ed como el resto de las publicaciones de la serie hasta el momento.<\/a><\/strong><\/p>\n

Despu\u00e9s de todo, me parece importante que todos estemos trabajando sobre la misma base, o algo estrechamente relacionado, cuando analizamos esta informaci\u00f3n.<\/p>\n

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

En \u00faltima instancia, usar una herramienta como Xdebug<\/a><\/strong> es indispensable, pero tenemos que trabajar en eso (para aquellos que tienen curiosidad, escrib\u00ed una breve gu\u00eda<\/a><\/strong> sobre esto hace poco m\u00e1s de un a\u00f1o).<\/p>\n

Sin embargo, por ahora, comencemos con lo b\u00e1sico. En la publicaci\u00f3n anterior, me fui con la siguiente declaraci\u00f3n:<\/p>\n

\n

En la pr\u00f3xima publicaci\u00f3n, comenzaremos a analizar lo que es necesario para examinar el registro de errores que genera WordPress y c\u00f3mo comprender la informaci\u00f3n que vemos.<\/p>\n<\/blockquote>\n

Y eso es lo que quiero ver hoy porque, al menos, les dar\u00e1 algo pr\u00e1ctico sobre lo cual trabajar.<\/p>\n

Comprender los registros de errores de WordPress, parte 1<\/h2>\n

Antes de profundizar demasiado en esto, quiero abordar una pregunta que plante\u00f3 un miembro del sitio.<\/p>\n

Es decir, me preguntaron:<\/p>\n

\n

\u00bfCu\u00e1ndo vamos a ver los principios orientados a objetos?<\/p>\n<\/blockquote>\n

Aunque he cubierto un poco sobre esto en una serie anterior<\/a><\/strong>, es algo en lo que estoy trabajando para cubrir m\u00e1s a fondo m\u00e1s adelante en esta serie.<\/p>\n

Sin embargo, dicho esto, comencemos a ver los registros de errores.<\/p>\n

Configurando sus constantes<\/h3>\n

Si no ha configurado las constantes en su archivo wp-config.php<\/strong>, le recomiendo que lo haga ahora, ya que esto le brindar\u00e1 el mayor nivel de granularidad al examinar cualquier problema que pueda surgir.<\/p>\n

Si no se ha puesto al d\u00eda, aseg\u00farese de leer esta publicaci\u00f3n<\/a><\/strong> (y si lo ha hecho, aseg\u00farese de que las siguientes constantes<\/a><\/strong> est\u00e9n definidas en su archivo de configuraci\u00f3n):<\/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
Una vez que est\u00e9n en su lugar, tendr\u00e1 todo lo que necesita no solo para ver la informaci\u00f3n en la pantalla, sino tambi\u00e9n en el registro de depuraci\u00f3n que generar\u00e1 WordPress.<\/p>\n
\u00bfD\u00f3nde est\u00e1 el registro?<\/h3>\n
Dependiendo de la naturaleza de su entorno, esto puede variar; sin embargo, en la mayor\u00eda de los casos, encontrar\u00e1 debug.log<\/strong> en el directorio wp-content que se encuentra sobre los directorios de<\/strong> complementos<\/strong>, temas<\/strong> y cargas<\/strong>.<\/p>\n
\"Lectura<\/a><\/p>\n
Como puede ver en la vista previa de la captura de pantalla anterior, mi archivo de depuraci\u00f3n tiene mucho contenido. Echaremos un vistazo a eso m\u00e1s en profundidad en la siguiente secci\u00f3n, as\u00ed como tambi\u00e9n c\u00f3mo entenderlo. Mientras tanto, sin embargo, verifique si este archivo existe. Si es as\u00ed, si\u00e9ntase libre de seguir adelante y leer detenidamente el contenido del archivo. Puede o no entender gran parte de lo que est\u00e1 sucediendo, pero el contenido del archivo significa que algo en un tema o complemento est\u00e1 activando varias advertencias, avisos y errores de PHP<\/a><\/strong> que WordPress detecta y descarga en el archivo de registro.<\/p>\n
\u00bfQu\u00e9 significa el archivo de registro?<\/h3>\n
Esto no significa necesariamente que algo est\u00e9 roto, pero indica que algo no est\u00e1 funcionando como deber\u00eda, que no se est\u00e1 capturando y manejando adecuadamente a nivel program\u00e1tico, o simplemente est\u00e1 haciendo algo que no deber\u00eda estar haciendo.<\/p>\n
\"Lectura<\/a><\/p>\n
No tiene que verse as\u00ed (\u00a1pero puede!).<\/p>\n
Como desarrolladores, debemos esforzarnos por asegurarnos de que nuestro c\u00f3digo no genere nada que se escriba en el registro de errores.<\/p>\n
Una cosa es hacerlo en desarrollo, ya que podemos obtener informaci\u00f3n sobre qu\u00e9 es lo que estamos haciendo y c\u00f3mo funciona WordPress. Sin embargo, otra cosa es que algo que lanzamos a nivel de producci\u00f3n genere tales cosas.<\/p>\n
Lectura del registro de errores<\/h3>\n
Obviamente, hay m\u00e1s para leer el registro de errores en lugar de simplemente abrirlo. Para muchos, la impresi\u00f3n inicial es que puede ser un mont\u00f3n de jerga. Yo tambi\u00e9n entiendo eso. Pero cuando entiendes lo que te est\u00e1 mostrando, es mucho m\u00e1s f\u00e1cil de entender.<\/p>\n
As\u00ed que echemos un vistazo a un ejemplo realmente simple. Este tampoco es un ejemplo artificial. De hecho, este es uno que proviene de un complemento en el que estaba trabajando. El registro de errores contiene la siguiente informaci\u00f3n<\/a><\/strong> :<\/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
Observe que, en la esencia anterior, hay tres l\u00edneas. El mejor curso de acci\u00f3n al leer los registros de errores es comenzar desde abajo y avanzar hacia arriba. Esto se debe a que las cosas, cuando se ejecutan en ejecuci\u00f3n, operan en una pila.<\/p>\n
Una breve digresi\u00f3n sobre las pilas<\/h4>\n
No entrar\u00e9 en la definici\u00f3n inform\u00e1tica del t\u00e9rmino, pero el c\u00f3digo se ejecuta y funciona de tal manera que las funciones ocurren y, literalmente, en la memoria de una computadora, se apilan una encima de la otra.<\/p>\n
Por lo tanto, lo m\u00e1s reciente que se ejecute siempre estar\u00e1 en la parte superior, donde la ra\u00edz de donde comienza est\u00e1 en la parte inferior. Ya que estamos escribiendo c\u00f3digo en una aplicaci\u00f3n preexistente, eso es WordPress; entonces es probable que nuestro c\u00f3digo siempre est\u00e9 en la parte superior.<\/p>\n
\"Lectura<\/a><\/p>\n
Comprender los registros de errores de WordPress: no es este tipo de pila<\/p>\n
La idea es que el c\u00f3digo comience a ejecutarse en WordPress y avance hasta el trabajo que estamos haciendo. Cuando hay un aviso, una advertencia o un error, generalmente ser\u00e1 algo en nuestro c\u00f3digo (aunque WordPress no est\u00e1 exento, ese es generalmente el caso).<\/p>\n
Entonces, cuando lee el registro de errores, est\u00e1, en esencia, leyendo lo que se llama un seguimiento de la pila.<\/a><\/strong> Wikipedia, como est\u00e1 vinculado, tiene una definici\u00f3n bastante detallada sobre el tema, pero quiz\u00e1s la parte m\u00e1s relevante de esta publicaci\u00f3n es la siguiente:<\/p>\n
\n
Los programadores suelen utilizar el seguimiento de pila durante la [depuraci\u00f3n] interactiva y post-mortem (https:\/\/en.wikipedia.org\/wiki\/Debugging<\/a>). Los usuarios finales pueden ver un seguimiento de la pila que se muestra como parte de un mensaje de error<\/a>, que luego el usuario puede informar a un programador.<\/p>\n<\/blockquote>\n
Esto concuerda con lo que he esbozado anteriormente, \u00bfverdad? Pero basta de hablar sobre qu\u00e9 es un seguimiento de pila (se volver\u00e1 m\u00e1s claro a medida que profundicemos en la depuraci\u00f3n), volvamos a leer el archivo de registro tal como est\u00e1 actualmente.<\/p>\n
Volver a Leer el registro<\/h3>\n
Incluyendo archivos<\/h4>\n
Primero, veamos el resultado final en la esencia anterior. Contiene lo siguiente:<\/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
Esto me dice que en la l\u00ednea 25 de mi archivo, easy-email-export.php,<\/strong> no pudo abrir un archivo para su inclusi\u00f3n. Esto significa que tengo una instrucci\u00f3n include_once<\/strong> en el c\u00f3digo que hace referencia a .\/src\/Admin\/EmailExportSubmenu.php<\/strong> que no puede encontrar.<\/p>\n
Entonces, el mejor curso de acci\u00f3n ser\u00eda encontrar la l\u00ednea 25 y determinar por qu\u00e9 no est\u00e1 localizando el archivo. Tal vez eso es descargar el camino completo en cuanto a d\u00f3nde est\u00e1 mirando. Llegaremos a esto moment\u00e1neamente cuando hablemos de escribir en el registro de errores.<\/p>\n
Dar sentido a los errores<\/h4>\n
En la siguiente l\u00ednea (es decir, la l\u00ednea encima de la que acabamos de ver) contiene lo siguiente:<\/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
Esta l\u00ednea en particular difiere solo un poco, pero brinda informaci\u00f3n adicional y est\u00e1 contenida en la cl\u00e1usula que dice "No existe tal archivo o directorio". Esto es revelador porque literalmente nos dice que el archivo no existe.<\/p>\n
Al menos, no existe donde est\u00e1 mirando. Entonces las dos posibilidades son:<\/p>\n
    \n
  1. no hemos creado el archivo al que hacemos referencia,<\/li>\n
  2. estamos haciendo referencia a la ubicaci\u00f3n del archivo en el lugar equivocado<\/li>\n<\/ol>\n
    Por lo tanto, lo primero que tendr\u00edamos que verificar es si el archivo existe en la ubicaci\u00f3n que estamos tratando de incluir. Si no es as\u00ed, entonces debemos crear el archivo.<\/p>\n
    Si el archivo existe, entonces sabemos que el complemento est\u00e1 buscando cargarlo desde la ruta incorrecta. Por lo tanto, es posible que debamos mirar nuestro cargador autom\u00e1tico<\/a><\/strong>, nuestra ruta de inclusi\u00f3n o c\u00f3mo se recuperan los archivos. Porque, lo m\u00e1s probable es que si el archivo existe, entonces est\u00e1 tratando de cargarse desde un lugar en el que no reside.<\/p>\n
    Un error no detectado<\/h3>\n
    En la l\u00ednea final del c\u00f3digo, ver\u00e1 algo como esto:<\/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
    Este es un buen ejemplo, en primer lugar, porque declara expl\u00edcitamente que se trata de un error no detectado. Esto significa que cualquiera que sea la funcionalidad, algo arroja un error y no se detecta.<\/p>\n