Cómo activar los registros de errores en WordPress

Aunque WordPress es relativamente fácil de administrar, los errores de solución de problemas son un problema bastante común para sus usuarios. Tratar con ellos no suele ser difícil; todo lo que se necesita es un poco de práctica. El primer paso de cada solución de problemas de errores de WordPress es recuperar el registro de errores.

El registro de errores contiene todos los errores, advertencias y avisos sobre el código detrás de su sitio. A veces, puede ayudarlo a identificar el archivo exacto y la línea de código que están causando el problema. El registro de errores también puede proporcionar pistas para resolver los errores aparentemente insolubles, como "la pantalla blanca de la muerte".

Sin embargo, entender el registro de errores puede resultar bastante complicado si no eres un experto en tecnología. Para convertirse en un experto en tecnología, debe comenzar por alguna parte, así que comencemos mostrándole cómo activar y adquirir el registro de errores en WordPress.

Cómo configurar registros de error de WordPress en su archivo WP-Config

El archivo wp-config.php es un archivo de configuración importante de WordPress. Al editarlo ligeramente, habilitará la depuración predeterminada de WordPress y mostrará errores. Puede hacerlo a través de un cliente FTP o mediante cPanel.

Usando un cliente FTP

Un requisito previo para realizar ediciones en los archivos de su servidor es configurar los permisos de archivo correctamente. Los permisos sugeridos en el archivo wp-config.php son 440 o 400. Esto significa que solo se le permite leer los archivos. Para poder adquirir un registro de errores, debe cambiar los permisos de archivo temporalmente a 644 o 666. Para aclarar, 644 otorga permisos de lectura y escritura / edición a los usuarios administradores, mientras que el resto de los usuarios solo obtienen permisos de lectura. El valor 666 otorga los dos tipos de permisos mencionados anteriormente a todos los usuarios.

Para continuar, necesita un cliente FTP y el conocimiento de cómo editar el archivo wp-config.php. Empiece por conectarse al servidor con sus credenciales de FTP. Navega a tu directorio raíz de WordPress. Busque el archivo wp-config.php, haga clic derecho sobre él y seleccione el Opción "Permisos de archivo".

Inserte manualmente uno de los valores numéricos sugeridos (644 o 666) y haga clic en "Okay”.

Después de cambiar los permisos, vuelva a la directorio raíz, haga clic derecho en el archivo wp-config.php y seleccione "Ver edición”.

Abra el archivo con un editor de texto e inserte esta línea de código:

define('WP_DEBUG', true); 
above the /* That's all, stop editing! Happy blogging. */.

Si el define('WP_DEBUG', false);  la línea ya está presente, solo cambiar falso en verdadero.

Guarde los cambios y cargue el archivo editado en su directorio raíz de WordPress. Esto anulará el archivo que se encuentra actualmente en su servidor.

A través de cPanel

También puede usar cPanel para editar el archivo wp-config.php. Inicie sesión en cPanel usando sus credenciales y haga clic en "Administrador de archivos”.

Navega al directorio raíz de su instalación de WordPress a la izquierda, busque el archivo wp-config.php, haz clic con el botón derecho y selecciona "Cambiar permisos”.

Asegurate que habilitar permisos de lectura y escritura para el usuario (administrador) marcando la casilla correspondiente. Luego, haga clic en "Cambiar permisos”.

Luego, haga clic derecho en el archivo wp-config.php una vez más y seleccione "Editar”.

El archivo se abrirá en el editor de cPanel predeterminado, por lo que solo necesitas agregar el define('WP_DEBUG', true); sobre el /* That's all, stop editing! Happy blogging. */ línea de código dentro del archivo wp-config.

Si el archivo ya contiene la siguiente línea define('WP_DEBUG', false); simplemente cambie el falso a verdadero y haga clic en "Guardar cambios" en la esquina superior derecha de su pantalla.

Cómo gestionar los errores de visualización

Una vez que muestre correctamente los errores, se mostrarán en sus páginas, tanto en el backend como en el frontend. A menos que su sitio esté en desarrollo, exponer los errores en vivo claramente no es una buena idea. En su lugar, debe guardarlos como un solo archivo y ocultarlos de su sitio. Esto le permitirá ver el archivo más tarde y solucionar errores en cualquier momento.

Para hacer esto, agregue este código a su archivo wp-config.php.

define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

Agregue el código debajo de la siguiente línea define('WP_DEBUG', true);  y por encima del /* That's all, stop editing! Happy blogging. */ línea de código.

Puede editar el archivo utilizando un cliente FTP o mediante cPanel, siguiendo los mismos pasos que expusimos en la sección anterior. Después de la edición, su archivo wp-config.php debería verse así.

Añadiendo define ('WP_DEBUG_LOG', verdadero); Obligamos a WordPress a almacenar todos los mensajes de error en un archivo. De forma predeterminada, ese archivo se llama debug.log y se encuentra en el directorio raíz de WordPress / wp-content /. También puede almacenar mensajes de error en algún otro archivo que haya creado. En ese caso, cambie el verdadero de "define ('WP_DEBUG_LOG', verdadero);" a la ruta del archivo. Por ejemplo:

define( 'WP_DEBUG_LOG', path-to-your-site/wp-content/error.log );

Además, WP_DEBUG_DISPLAY determina si los mensajes de error se muestran u ocultan en la pantalla. Añadiendo define ('WP_DEBUG_DISPLAY', false); le dice a WordPress que oculte los mensajes de su pantalla, pero aún se imprimen en el archivo designado. Si tu tambien agregar @ini_set ('display_errors', 0); esto deshabilitará la impresión de errores para su PHP, asegurándose de que los usuarios no puedan verlos en la interfaz.

Adquirir el registro de errores

Con los errores mostrados y escritos correctamente en el archivo de registro de errores correspondiente, lo único que queda es revisar los mensajes de error y seguir los pasos.

Descarga manual del archivo debug.log

Para descargar el archivo de registro conéctese a su servidor, navegue a su carpeta raíz de WordPress y haga clic en contenido de wp. Encuentra el registro de depuración archivo dentro, botón derecho del ratón sobre él y presione "Descargar”.

Guarde el archivo en su escritorio. Luego, asegúrese de revertir las ediciones anteriores. Esto incluye eliminar el código que insertó y cambiar los permisos en el archivo wp-config.php a 440 o 400. Si lo desea, puede hacerlo después de resolver los errores.

Finalmente, abra el archivo debug.log guardado con un editor de texto y verifique los mensajes de error escritos. Dependiendo de su nivel de experiencia, puede resolver los errores usted mismo o contratar a un desarrollador.

Funciones de depuración más avanzadas

También veremos algunas posibilidades de depuración más avanzadas. El siguiente código debe agregarse en wp-config.php, arriba del /* That's all, stop editing! Happy blogging. */ línea.

Este código obliga a WordPress a utilizar versiones no minimizadas de archivos CSS y JS, que es útil para depurar cambios y / o errores que se encuentran específicamente en sus archivos CSS y JS.

Al establecer la constante CONCATENATE_SCRIPTS en falso, fuerza WordPress para cargar todos los scripts por separado. Esto puede resultar útil para identificar scripts defectuosos / incompatibles.

Si tiene problemas con la base de datos, analizar las consultas que se ejecutan es una buena forma de comenzar a depurar. Al insertar el código de arriba, poner el contenido de la consulta, qué función la llamó y durante cuánto tiempo se ejecutó en la matriz $ wpdb-> queries. Esto le permitirá profundizar en la parte del backend del código del tema y lo que está haciendo exactamente.

Entonces puedes agregue el siguiente código para mostrar todas las consultas en un formato legible y analizarlos.

global $wpdb;
print("<pre>".print_r($wpdb->queries,true)."</pre>");

Sin embargo, tenga en cuenta que este código afectará el rendimiento de su sitio, por lo que le recomendamos que lo utilice solo con fines de depuración.

Pensamientos finales

Siguiendo esta guía, puede mostrar y almacenar de forma segura los registros de errores en un archivo, cambiar los permisos del archivo y ejecutar algunas funciones de depuración destinadas a usuarios más avanzados de WordPress. Este tutorial también lo ayudará a obtener más información sobre el funcionamiento de su sitio web, así que manténgalo cerca porque podría necesitar estas instrucciones en el futuro.