Registro de depuración WordPress: errores PHP

El registro de depuración WordPress es una novedad del plugin CSDN desde la versión 1.0.15. Registra los errores PHP del sitio en un archivo propio, sin tocar wp-config.php. Lo activas desde el backend y se apaga solo.

Dónde se encuentra

Ve a Ajustes > Cisilino Site Defense Network (punto 1 de la imagen) y abre la pestaña Registro de depuración (punto 2). Las secciones son tres:

• punto 3: «Registro de depuración del sitio», con estado y activación.
• punto 4: «Archivos recogidos».
• punto 5: «Últimas entradas».

Para qué sirve el registro de depuración WordPress

Te resulta útil cuando el sitio muestra una página blanca o un error crítico, cuando algo se rompe tras una actualización, o cuando tu hosting no te deja modificar wp-config.php ni leer los logs. Las constantes WP_DEBUG y WP_DEBUG_LOG se definen antes de cargar los plugins, así que un plugin no puede activarlas. Este registro usa un gestor de errores PHP conectado a la carga del plugin.

Este registro se añade, no sustituye nada. Los errores siguen llegando también donde llegaban antes, es decir en debug.log y en el log del servidor. No envía nada al panel.

Cómo se usa

1. Abre la pestaña Registro de depuración.
2. Elige Sigue encendido durante: 1 hora, 24 horas (predeterminado) o 7 días.
3. Elige Tamaño máximo por archivo.
4. Pulsa Encender el registro de depuración. Lee «Registro de depuración encendido. Se apaga solo al vencer el tiempo elegido; los archivos se quedan.».
5. Reproduce el problema en el sitio.
6. Vuelve a la pestaña. Lee «Últimas entradas» o descarga el archivo desde la sección «Archivos recogidos».
7. Cuando termines pulsa Apagar el registro de depuración, o espera al vencimiento. Verás «Registro de depuración apagado. Los archivos recogidos siguen aquí abajo.».

El «Estado:» te dice si el registro está «encendido, se apaga el dd/mm/aaaa hh:mm», «apagado (venció el …)» o «apagado». Con el registro encendido puedes cambiar el tamaño con Guardar tamaño.

Archivos recogidos

La tabla enumera nombre, tamaño y los botones Descargar y Eliminar. Debajo encuentras Eliminar todos los archivos. Antes de borrar el plugin pide confirmación: «¿Eliminar este archivo? La operación no se puede anular.». Para Eliminar todos los archivos el texto es «¿Eliminar todos los archivos del registro de depuración? La operación no se puede anular.». Si no hay nada lees «Ningún archivo: el registro nunca se ha encendido o todavía no ha registrado nada.».

Últimas entradas

El recuadro muestra las 200 entradas más recientes, de la más nueva a la más vieja. El menú Todos los niveles te permite filtrar por Fatal error, Parse error, Recoverable error, Warning, Notice o Deprecated. Luego pulsa Filtrar. Para todo lo demás descarga los archivos. Si el filtro no encuentra nada lees «Ninguna entrada con este filtro.».

Una entrada tiene esta forma:

[2026-10-29 10:15:03 UTC] Warning: mensaje en /ruta/archivo.php:12 | GET /pagina

• La hora está en UTC, distinta de la hora del sitio que ves en el Registro de actividad.
• Tras la barra vertical encuentras el método y la ruta de la petición, sin cadena de consulta. Desde la línea de comandos o el cron ves «cli/cron».
• Un mensaje de varias líneas, como una traza de pila, sigue siendo una sola entrada, con las líneas siguientes sangradas.
• Las líneas «Info: registro de depuración activado (usuario N)» e «Info: registro de depuración desactivado (usuario N)» no tienen nivel: con un filtro no aparecen.

Valores predeterminados y límites

• Duración del registro de depuración WordPress: 1 hora, 24 horas o 7 días. Otro valor se convierte en 24 horas.
• Tamaño por archivo: 1, 5, 10, 25 o 50 MB. El predeterminado es 5 MB. El tamaño elegido se guarda al pulsar Encender el registro de depuración o Guardar tamaño. Atención: Apagar el registro de depuración devuelve el tamaño a 5 MB, porque ese módulo no contiene el menú del tamaño.
• Tope total: 200 MB, sumando archivos .log y .zip.
• Cada mensaje se trunca a 4000 caracteres.
• Registra solo errores PHP: no consultas lentas, errores de JavaScript ni peticiones HTTP.

Ejemplos

• Error crítico tras la actualización de un plugin: enciéndelo durante 1 hora, recarga la página, filtra «Fatal error». La entrada indica el archivo y la línea, por ejemplo /…/plugins/xyz/archivo.php:210 | GET /tienda/.
• Avisos esporádicos: 24 horas, filtro Warning o Deprecated. Si el archivo se ha rotado, descarga el zip.
• Sitio lento sin una causa clara: 7 días con archivos de 25 MB, luego busca Notice y Warning que se repiten.

Mantén encendido lo mínimo necesario: a menudo basta 1 hora.

Atención: los archivos del registro de depuración contienen rutas del servidor y fragmentos de datos. No los compartas en público. Se quedan en el disco también después de apagarlo y después de desinstalar el plugin, que borra las opciones pero no los archivos. Elimínalos tú cuando termines. El tope total es de 200 MB.

Atención: en servidores nginx el encendido puede rechazarse mientras el servidor no bloquee la carpeta csdn-debug-*. El mensaje es «Registro de depuración no encendido: los archivos de su carpeta resultan accesibles desde internet (probable servidor sin soporte de .htaccess, como nginx). Los registros pueden contener rutas y datos: bloquea el acceso a la carpeta csdn-debug-* en la configuración del servidor y vuelve a intentarlo.». Si no gestionas el servidor, pregunta a quien lo gestione.

Atención: el registro no ve los errores silenciados con @ ni los generados antes de cargar el plugin. Por ejemplo no ve los errores de wp-config.php. El registro de depuración WordPress del plugin no sustituye los logs del servidor.

Qué pasa entre bastidores

El registro de depuración WordPress guarda los archivos en una carpeta wp-content/uploads/csdn-debug- seguida de 16 caracteres aleatorios. Dentro hay un index.php, un .htaccess que niega el acceso y el archivo en uso csdn-debug.log. Al encenderse, el plugin escribe un archivo de prueba e intenta leerlo por HTTP. Si responde, se niega a encender el registro.

Cuando el archivo en uso supera el tamaño elegido se cierra, se comprime en .zip y arranca uno nuevo. No se pierde ninguna entrada. El .log original se borra solo después de comprobar el zip. Si la compresión falla, el .log se queda. Las entradas de «Últimas entradas» se leen solo del archivo en uso, así que tras una rotación las antiguas están en los zips.

Antes de rotar, el plugin comprueba el tope de 200 MB. Si se alcanza, el registro se detiene para no sobrescribir nada. Aparece el aviso amarillo: «El registro se ha detenido porque los archivos han alcanzado el tope de espacio (200 MB): para no sobrescribir los datos, deja de escribir. Descarga o elimina los archivos, luego vuelve a encenderlo.». Para reanudar, elimina los archivos y vuelve a encenderlo.

Al vencer, el registro se apaga solo, pero los archivos se quedan. El plugin no los trunca ni los borra nunca: lo haces solo tú con Eliminar o Eliminar todos los archivos. Para los errores fatales, la entrada se escribe al final de la petición.

Si el registro de depuración WordPress no funciona

• «Registro de depuración no encendido: la carpeta de las subidas no se puede escribir.»: revisa los permisos de la carpeta wp-content/uploads.
• El registro no escribe: si la escritura falla, el plugin lo señala con una entrada «Registro de depuración del sitio: …» en los «Últimos intentos» de la pestaña Registro de actividad.
• El registro está detenido por el tope: descarga lo que necesites, elimina los archivos y vuelve a encenderlo.

La guía general del manual explica dónde se ubica esta pestaña. Para entender mejor las constantes de WordPress mira la guía oficial de depuración de WordPress: explica WP_DEBUG y WP_DEBUG_LOG, que este plugin no puede sustituir.

Capítulo anterior: Registro de actividad. Capítulo siguiente: Resolución de problemas y preguntas frecuentes.