K'áan Software on Internet Propósito
Esta herramienta resulta útil para la identificación de errores en código, así como conocer valores en las distintas
variables a lo largo del funcionamiento.
Aún cuando ya existen funciones dentro del mismo lenguaje que cumplen dicho
propósito, esta se enfoca en desplegar la información en pantalla, apoyada de características visuales que permiten una
identificación más eficiente de los datos.
Descripción
La librería consta de cuatro funciones:
- beginDebug()
- No requiere parámetros. Inicializa la página web y despliega la información actual, como son las variables de ambiente, los parámetros recibidos y las cookies almacenadas. Solo es utilizada una primera vez.
- endDebug()
- No requiere parámetros. Función inversa de la anterior, cierra la página web y crea un enlace para su segunda ejecución.
- shout(char,data)
- Utiliza dos parámetros, el primero (char) es un caracter que indica el tipo de mensaje (notificación) o valor (variable) a desplegar y
el segundo (data) el mensaje o variable a desplegar:
- f Función (notificación)
- p Sección (notificación)
- i Informativo (notificación)
- e Error (notificación)
- q Query (notificación)
- r Resultado (notificación)
- s Sistema (notificación)
- @ Arreglo (variable array)
- % Hash (variable hash)
- ? Estructura (variable de tipo complejo o desconocido)
- obscure(str)
- Recibe un string, pero oculta varios de los datos. Utilizado para desplegar contraseñas o datos de seguridad.
Uso
El uso de esta librería va de la mano con la declaración de una variable llamada $bool_DEBUG que puede tener el valor de 1 o 0; la cual activa a lo largo del código diversas funciones que permiten desplegar la información en pantalla.
