20.5 Métodos de la Clase DB
20.5.1 Connect
Descripción: Permite crear ó reestablecer una conexión con el motor de base de datos.
Sintaxis
$db->connect([string $host], [string $user], [string $password], [string $database_name])
20.5.2 Query
Descripción: Permite enviar sentencias SQL al motor de base de datos. El parámetro debug
permite ver un mensaje del SQL que es enviado al motor de base de datos.
Sintaxis
$db->query(string $sql, [bool $debug=false])
Ejemplo
- $db = db::raw_connect();
- $db->query(“update clientes set estado = ‘A’”);
- $db->close();
20.5.3. Close
Descripción: Cierra la conexión encapsulada en el objeto
Sintaxis
$db->close()
20.5.4 Fetch Array
Descripción: Recorre el cursor ejecutado en la última operación select.
Sintaxis
$db->fetch_array([cursor $cursor], [int $tipo_resultado=DB_BOTH])
Ejemplo
- $db = db::raw_connect();
- $db->query(“select codigo, nombre from productos”);
- while($producto = $db->fetch_array()){
- print$producto[‘nombre’];
- }//fin while
- $db->close();
Los tipos de resultado pueden ser:
- db::DB_ASSOC: Array con índices asociativos de los nombres de los campos
- db::DB_NUM: Array con índices numéricos que indican la posición del campo en el select.
- db::DB_BOTH: Array con índices tanto numéricos como asociativos
20.5.5 Num Rows
Descripción: Devuelve el número de filas de la última instrucción select enviada al motor de
base de datos.
Sintaxis:
$db->num_rows([cursor $cursor]);
Ejemplo
- ?php
- $db = db::raw_connect;
- $db->query(“select codigo, nombre from productos”);
- print “Hay ”.$db->num_rows().“ productos “;
- $db->close();
- ?>
20.5.6 Field Name
Devuelve el nombre del campo en la posición $number de último select enviado
al motor de base de datos.
Sintaxis:
$db->field_name(int $number, [cursor $cursor]);
20.5.7 Data Seek
Descripción: Se mueve a la posición $number del cursor de la ultima instrucción select
enviada al motor de base de datos.
Sintaxis:
$db->data_seek(int $number, [cursor $cursor]);
20.5.8 Affected Rows
Descripción: Devuelve el número de filas afectadas en la última instrucción insert, update ó delete.
Sintaxis:
$db->affected_rows();
20.5.9 Error
Descripción: Devuelve la cadena descriptiva del último error generado por base de datos
producido por la última instrucción SQL.
Sintaxis
$db->error();
20.5.10 No Error
Descripción: Devuelve el número interno del último error generado por base de datos
producido por la última instrucción SQL.
Sintaxis
$db->no_error();
20.5.11. Find
Descripción: Ejecuta un Select en el motor con los parámetros enviados y devuelve un Array
con los resultados.
Sintaxis
$db->find(string $table, [string $where=”1=1”], [string $fields=”*”], [string $orderBy=”1”]);
Ejemplo
- ?php
- $db = db::raw_connect;
- foreach($db->find(“productos”) as $producto){
- print $producto[‘nombre’];
- }//fin del foreach
- $db->close();
20.5.12 In Query
Descripción: Devuelve el resultado de una instrucción SQL en un array listo para ser
recorrido.
Sintaxis
$db->in_query(string $sql, [bool $debug=false], [int $tipo_resultado = db::DB_BOTH]);
Ejemplo
- ?php
- $db = db::raw_connect;
- foreach($db->in_query(“select * from productos”) as $producto){
- print $producto[‘nombre’];
- }//fin del foreach
- $db->close();
20.5.13 In Query Assoc
Descripción: Devuelve el resultado de una instrucción SQL en un array con indexado
Libro de Kumbia: Porque Programar debería ser más fácil 50
asociativo listo para ser recorrido.
Sintaxis
$db->in_query_assoc(string $sql, [bool $debug=false]);
20.5.14 In Query Num
Descripción: Devuelve el resultado de una instrucción SQL en un array con indexado
numérico listo para ser recorrido.
Sintaxis
$db->in_query_num(string $sql, [bool $debug=false]);
20.5.15 Fetch One
Descripción: Devuelve la primera fila de un select . Es útil cuando el select devuelve una sola
fila
Sintaxis
$db->fetch_one(string $sql, [bool $debug=false]);
Ejemplo
- ?php
- $db = db::raw_connect;
- $producto = $db->fetch_one(“select * from producto where codigo = 1”)
- print $producto[‘nombre’];
- $db->close();
20.5.16 Table Exists
Descripción: Devuelve verdadero si la tabla $table existe en la base de datos, falso de lo
contrario.
Sintaxis
$db->table_exists(string $table);
Regresar al indice