K'áan Software on Internet Propósito
Este objeto establece la comunicación con la base de datos a fin de poder interactuar con ella. Es importante hacer notar que la configuración puede distar de acuerdo al usuario o panel de control donde se encuentre; siendo el usuario administrativo uno con todos los privilegios y uno restringido para usuarios o interface del sistema.
Se encuentra reservada la variable objeto $db para este propósito.
Valores
El sistema almacena internamente los siguientes valores
- $str_DBHOST
- Usualmente con el valor de localhost. Almacena la identidad de la máquina donde se localiza la base de datos.
- $str_DBUSER
- Usuario de la base de datos. Debe existir un usuario creado para dicho propósito. Nunca un root.
- $str_DBPWD
- Contraseña.
- $str_DBNAME
- Nombre de la base de datos.
- $str_TABLEPREFIX
- Prefijo de las tablas del sistema. Su valor es establecido durante la instalación.
Descripción
El objeto $db, perteneciente a la clase DbConnection es creado una única vez por llamado, ofreciendo los siguientes métodos:
- dbError()
- En caso de error con la base de datos, proporciona información sobre el tipo de error ocurrido.
- dbType()
- Informativo. Proporciona información sobre el tipo de conexión utilizada y versión asociada.
- dbLogin()
- Conecta a la base de datos
- dbQuery(qry)
- Recibe como parámetro un query (string) y lo ejecuta. En algún momento se consideró utilizar un sistema universal de parámetros, pero dada la complejidad que este involucraba y que la diferencia entre los distintos tipos de llamados SQL era mínima, se optó por seguir utilizando este modelo.
- dbClrQuotes(arr)
- Recibe como parámetro un arreglo de valores mismo que devuelve, remplazando los valores de \' y " por código seguro, a fin de prevenir inyección de código.
- dbFetch(str)
- Devuelve una linea de resultados. En caso de que el parámetro indicado (str) sea "hash" devuelve los resultados en dicho formato. Por defecto, los resultados son entregados como arreglo (array).
- dbResult(str)
- De acuerdo al parámetro indicado (str), puede devolver el número de renglones obtenidos (rows), liberar el contenido del resultado del query (free), todo el bloque de resultados (all) o un valor de -1 como error en caso de no ser alguna de las opciones anteriores.
- dbLogout()
- Desconecta de la base de datos.
- dbPrefix()
- Devuelve el prefijo utilizado para las tablas.
Uso
Requiere la carga previa de la libería debug.
