DokuWiki

It's better when it's simple

Herramientas de usuario

Herramientas del sitio


es:devel:debugging

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() en data/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 a dbg($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.
  • 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

es/devel/debugging.txt · Última modificación: 2024-03-04 10:43 por 186.167.204.234

Excepto donde se indique lo contrario, el contenido de este wiki esta bajo la siguiente licencia: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki