¡Esta es una revisión vieja del documento!
Tabla de Contenidos
Herramientas de Depuración
DokuWiki has debugging tools. Some need to be configured.
Habilitar depuración
Cuando la opción de configuración allowdebug está activada puedes::
- Añadir
?do=debug
or&do=debug
al la URL para que DokuWiki muestre una enorme lista de cadenas de depuración. - (Hasta la versión Hogfather 2020: Buscar la salida de
dbglog()
endata/cache/debug.log
) - Recibir mensajes de error adicionales, por ejemplo, de algunos backends de autenticación
- Añadir
?httpdebug
o&httpdebug
a la URL para habilitar la salida de depuración en el HTTPClient de DokuWiki - Devolver algunos mensajes si faltan hojas de estilo
- Recibir comentarios adicionales en la salida del renderizador xhtml
- Obtener algunos try-catches en el archivo javascript compilado a través de
js.php
- Obtener depuración en algunas otras ubicaciones y en plugins o plantillas, ver el codesearch para el uso allowdebug
Activación del registro
Desde el lanzamiento de Igor 2022:
DokuWiki tiene una funcionalidad de registro. La información, que no se registra puede establecerse con la configuración dontlog config setting.
- Por defecto, sólo se registran los mensajes de error y obsoleto y el registro de depuración está deshabilitado.
- También puede activar el registro de depuración para obtener más información.
- A través de la interfaz de administración puede utilizar LogViewer. Si no puede acceder a LogViewer, puede encontrar los archivos de registro en su sistema de archivos, por ejemplo en
[wiki_folder]/data/log/error/<date>.log
.
Obtener información de la página y del usuario
Añadiendo ?do=check
o &do=check
a la URL se activa la action mode check que proporciona información sobre los permisos del usuario y la configuración de DokuWiki.
Depuración de TaskRunner
See the debug info en la página del ejecutor de tareas.
Funciones de depuración
dbg($msg)
Inserta un bloque de código en la wikipage rellenada por $msg como texto plano.
añadiendo un argumento extra adbg($msg, $hidden=true)
devolverá el $msg como comentario html.
dbglog($msg)
Escribe $msg en el registro de depuración mostrado en LogViewer, almacenado en[wiki_folder]/data/log/debug/<date>.log
cuando debug está desmarcado en la configuración de dontlog.\\(Hasta la versión Hogfather 2020: escribía en el registro del directorio de cachédata/cache/debug.log
cuando la configuración allowdebug este activada.) Tenga en cuenta que el registro no se vacía automáticamente.
Utilicedbglog($msg, 'Header above log message')
para incluir una cabecera sobre $msg.
dbg_deprecated($alternative = '')
Función para marcar funciones obsoletas. Cada llamada se registra en el log deprecated mostrado en LogViewer, cuando deprecated está desmarcado en la configuración dontlog. El mensaje de registro menciona: el nombre de la función obsoleta, la función que la usa, su archivo y línea y la $alternativa cuando se proporciona.
dbg_backtrace()
Imprime un backtrace invertido y prettyprinted.
debug_guard($data)
Cuando escriba su propia funcionalidad de depuración. Utilice esta función para eliminar todos los datos de un Array cuya clave parezca apuntar a datos sensibles.
Plugin Sentry
The Complemento Sentry le permite registrar información exhaustiva, en el servicio Sentry. Esto es especialmente útil cuando se ejecutan pruebas beta en un entorno real.
Ver también
- Opción de configuración allowdebug
- Obtengo una página en blanco o Error 500 (Internal Server Error)
- Spanish version by CX