20-5-Metodos de Clase DB

Version 6, last updated by phillipo at August 31, 2007 12:03 UTC

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