A pesar de lo estable que es la plataforma de WordPress, se encontrará con un error en algún momento. Además, puede haber momentos en los que no tenga idea de cómo llegó allí o qué puede hacer para solucionarlo. En tal situación, el modo de depuración de WordPress es un salvavidas.
La depuración es una forma de averiguar por qué un «error» está causando estragos, aunque también debe descubrir cómo solucionarlo. Algunos mensajes de depuración proporcionan sugerencias. Aunque, si bien el modo de depuración le ayuda, el proceso de reparación suele ser sencillo.
En esta publicación, le mostraremos todo lo que necesita saber sobre el modo de depuración de WordPress. Primero, ofrezcamos más información sobre lo que hace el modo.
¿Qué es el modo de depuración de WordPress?
En muchos casos, verá que la versión de depuración ya funciona. Cuando se encuentra con un error en su sitio de WordPress, es una pequeña parte del proceso de depuración en acción: el punto final. En circunstancias normales, verá notificaciones sobre errores críticos graves en su sitio. Piense en problemas como una falla en la conexión de la base de datos o un error interno del servidor 500.

Sin embargo, hay muchos más errores «silenciosos». En otras palabras, no sabrá que hay un error hasta que lo busque. El modo de depuración de WordPress es perfecto para estas situaciones.
Mostrará notificaciones en la parte posterior o frontal del sitio, y no es solo por errores. Habilitar el modo de depuración (también conocido como WP_DEBUG
) también proporcionará advertencias y notificaciones de código base. Por ejemplo, es común ver errores relacionados con aspectos de su sitio web que no se muestran o funcionan dañados. Esto es por diseño.
En consecuencia, puede utilizar WP_DEBUG
para detectar problemas con el código PHP de su sitio web, que, cuando se solucione, proporcionará una base más resistente y eficiente.
¿Por qué quieres usar el modo de depuración de WordPress?
Es seguro decir que en la superficie usando WP_DEBUG
no aporta muchos beneficios al usuario medio del sitio. Este Energía ser así, aunque no es universal. De hecho, para la mayoría de los sitios, no necesita usar el modo de depuración ya que WordPress es excelente tanto para manejar como para mostrar errores.
Sin embargo, podemos pensar en algunas situaciones en las que el modo de depuración de WordPress resulta útil:
- Incluso para el propietario típico del sitio, la activación
WP_DEBUG
puede ayudar a diagnosticar problemas complejos que no ocurren en circunstancias normales. Un ejemplo es la pantalla blanca de la muerte de WordPress (WSoD). Muchas veces descubrirá el error si usa el modo de depuración de WordPress, lo que le dará una ventaja sobre la búsqueda de una solución. - Si eres un desarrollador,
WP_DEBUG
será una herramienta invaluable en su trabajo. Esto se debe a que desea conocer los errores que pueden dañar su sitio y los problemas molestos que pueden causar problemas más adelante. El modo de depuración de WordPress muestra todo esto y más. Por ejemplo, también verá notificaciones sobre funciones y argumentos obsoletos en su código. No dañarán su sitio ahora, pero serán un problema cuando las características desaparezcan en una fecha posterior.
En general, WP_DEBUG no debe estar activo en un sitio activo. Como tal, es más una herramienta de desarrollo cuando se utiliza un entorno local o de ensayo. Aún así, el modo de depuración es aplicable a sitios en vivo, pero con frecuencias bajas y disciplinadas.
Si está utilizando el modo de depuración en un sitio en vivo, hay algunas reglas a seguir: no lo use por mucho tiempo, actívelo cuando su sitio tenga menos tráfico y desactívelo WP_DEBUG
después. Esto minimizará los riesgos asociados y mantendrá el mantenimiento del sitio fuera de la vista de los usuarios finales.
¿Cómo habilitar el modo de depuración de WordPress para su sitio web de 2 maneras?
Si desea habilitar el modo de depuración de WordPress, puede hacerlo de dos formas comunes:
También hay varios modos relacionados y complementarios para ayudarlo a depurar su sitio. Los cubriremos más adelante, pero por ahora analicemos el enfoque manual.
1. Habilite el modo de depuración wp-config.php Expediente
Si conoce los archivos principales de WordPress, lo sabrá wp-config.php. Para los no iniciados, este archivo almacena los ajustes de configuración del sitio y del servidor. Este es un archivo que puede causar errores al conectarse a la base de datos, entre otras cosas.
Como tal, es un archivo con el que hay que tener cuidado. Por esta razón, asegúrese de tener los siguientes elementos antes de comenzar:
- Conocimiento de SFTP (Protocolo seguro de transferencia de archivos) y la capacidad de usarlo.
- Derecha cliente SFTPComo ArchivoZilla, pato cibernéticoo Pasar.
- Tus credenciales de SFTP, que puedes encontrar en el panel de hosting o en el correo electrónico de tu proveedor.
- Una copia de seguridad limpia y actualizada de su sitio en caso de que necesite revertir.
- Es posible que necesite un editor de texto dedicado, pero no es necesario.
Una vez hecho esto, inicie sesión en su sitio web a través de SFTP. Si solo ejecuta un sitio, el directorio raíz (también conocido como www o public_html) será el lugar para ir.

Sin embargo, si ejecuta varios sitios en su servidor, esto también podría estar en un directorio con el nombre de su sitio. Cuando estés en el lugar correcto, búscalo wp-config.php expediente. Tenga en cuenta que también hay wp-config-muestra.php archivo, pero no es lo que necesita.
Una vez que haya encontrado el archivo, haga clic derecho y elija editar. Esto variará según su solución SFTP, pero a menudo es difícil pasarlo por alto:

Después de abrir el archivo, desea agregar una sola línea para habilitar el modo de depuración:
define( 'WP_DEBUG', true);
Escribe esto encima de la línea que dice /* That's all, stop editing! Happy blogging. */
. Después de guardar los cambios, el modo de depuración de WordPress está activo. También puede agregar más líneas a su archivo. Por ejemplo, puede crear un archivo debug.log escrito dedicado con lo siguiente:
define( 'WP_DEBUG_LOG', true );
Sin embargo, recuerda apagarlo. WP_DEBUG
usando false
valor en su lugar true
. Alternativamente, puede eliminar las líneas correspondientes de la suya wp-config.php archivo y guarde los cambios nuevamente.
2. Use un complemento dedicado para habilitar el modo de depuración de WordPress
También puede usar un complemento para habilitar el modo de depuración. Esto hace que el proceso sea más accesible si no se siente cómodo con los archivos subyacentes. La mejor solución para esto es Depuración de WP:

Una vez que el complemento está instalado y activado, está en funcionamiento. Habilita las siguientes «constantes» en el tuyo wp-config.php:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'SCRIPT_DEBUG', true );
define( 'SAVEQUERIES', true );
Ya has usado las dos primeras constantes. SCRIPT_DEBUG
cambia WordPress para usar versiones de desarrollo de archivos CSS y JavaScript principales. En circunstancias normales, WordPress usará archivos minimizados, lo que puede causar problemas en casos excepcionales. No te afectará si buscas errores, pero puede hacerlo si eres un desarrollador.
SAVEQUERIES
también es una constante centrada en el desarrollador que almacena consultas de base de datos en una matriz global ($wpdb->queries
). Almacena la consulta en sí, el tiempo que tardó en ejecutarse y la función que la llamó. Esto también tiene un impacto en el rendimiento, por lo que debe tener esto en cuenta si está utilizando un complemento. Si lo anterior no significa mucho para usted, sepa que no importará mucho para su experiencia.
Después de instalar el complemento, notará que es posible que también deba instalar complementos adicionales:

En realidad, no son necesarios, a menos que sea un desarrollador con una tarea específica que realizar.
Las opciones de complemento son mínimas, lo que ayuda a la usabilidad. Puede encontrar la configuración en Herramientas> Depuración de WP en WordPress y hay tres opciones:
- Encender
WP_DEBUG
. - Configurar
WP_DEBUG_DISPLAY
falso. Esto mostrará u ocultará las notificaciones en su sitio, independientemente de los errores de registro. - Cambiar
WP_DISABLE_FATAL_ERROR_HANDLER
a la verdad Si no sabe lo que esto significa, debe dejarlo en paz, ya que puede hacer que WSoD sea más frecuente.
Si desea consultar la revista, puede hacerlo con Vista previa rápida de depuración menú:

Un complemento es una forma conveniente de depurar su sitio sin profundizar en los archivos principales, por lo que vale la pena instalarlo. Por supuesto, cuando haya terminado, querrá desinstalar el complemento o desactivar las opciones tal como lo hizo con el método manual.
Envase
Un bloqueo del sitio de WordPress es una ocurrencia rara, o al menos cuando lo hace, puede solucionarlo. La mayoría de los errores importantes aparecen como una notificación en el sitio o en la página mientras se carga el sitio. Sin embargo, hay muchos otros errores o preocupaciones «silenciosos» de los que quizás deba estar al tanto, especialmente si es un desarrollador.
En esta publicación, le dimos dos formas de activar el modo de depuración de WordPress. Aquí está otra vez:
- Abre los tuyos wp-config.php archivo usando SFTP y agregue algunas líneas de código.
- Instale un enchufe como Depuración de WP y registre sus errores sin complicaciones.
¿Necesita usar el modo de depuración de WordPress y esta publicación lo ayudará? ¡Háganos saber en la sección de comentarios!