Posts Tagged ‘ADOdb’

febrero 26, 2010 0

Tutorial de ADOdb: Parte II

By in Librerías, PHP

En el anterior tutorial vimos como conectarnos a una base de datos. Hoy veremos como realizar consultas a la base de datos. Para ello vamos a ver un ejemplo donde nos conectaremos a una base de datos, MySQL en nuestro caso, y mediante el método Execute realizaremos una consulta a la base de datos (el ejemplo es muy parecido al de la anterior parte).

<?php

include('adodb.inc.php');

$conexion = NewADOConnection('mysqli');
$conexion->Connect('localhost', 'user', 'password', 'db');

$recordSet = $conexion->Execute('SELECT user_id, user_name FROM users');

if($recordSet != false)
{
 while(!$recordSet->EOF)
 {
  echo $recordSet->fields[0].':'.$recordSet->fields[1].'<br>';
  $recordSet->MoveNext();
 }
}

?>

Lo que hacemos es conectarnos a la base de datos, como vimos en la primera parte, y después ejecutamos una consulta con el método Execute. Este método nos devuelve una instancia de la clase ADORecordSet o false si ha ocurrido algún error. Esta clase nos provee de una serie de métodos y propiedades para manejar los datos devueltos por la consulta.

Una vez hecha la consulta comprobamos si se ha ejecutado correctamente la consulta. Acto seguido realizamos un bucle while siempre que no se haya llegado al final del recordset. Para ello comprobamos la propiedad EOF que nos indica si hemos llegado o no al final.

Luego imprimimos los datos. Para acceder a los datos de cada registro hacemos uso de la propiedad fields. Esta propiedad es un array que contiene cada uno de los campos de nuestro registro. Una vez que ya hemos hecho lo que queríamos, en este caso simplemente mostrar los datos, nos desplazamos al siguiente registro con el método MoveNext de la clase ADORecordSet.

Pero también podemos realizar otro tipo de consultas, por ejemplo de inserción o de modificación de registros. Para ello hacemos uso también del método Execute de la clase ADOConnection. Veamos un ejemplo:

<?php

include('adodb.inc.php');

$conexion = NewADOConnection('mysqli');
$conexion->Connect('localhost', 'user', 'password', 'db');

if($conexion->Execute('UPDATE user_name FROM users WHERE user_id = 1'))
{
 echo "Actualización realizada.";
}
else
{
 echo "Error al actualizar";
}

?>

En este caso el método devuelve true si la consulta se realiza satisfactoriamente y false si ocurre algún error.

Paso de parámetros a las consultas

Una de las cosas que podemos hacer con el método Execute es añadirle parámetros a las consultas. Para ello tenemos que construir la consulta de una forma especial, para indicar donde están los parámetros, y pasarle al método Execute un array con el valor de dichos parámetros. Veamos como hacerlo:

$rs = $conexion->Execute('SELECT user_name FROM users WHERE user_id=?', array($user_id));

Se puede apreciar que en la consulta se ha usado el símbolo ? para indicar donde va el parámetro. Como segundo parámetro del método execute se le pasa un array con los valores, en este caso es uno solo, de los parámetros.

Se puede usar este método con más de un parámetro:

$rs = $conexion->Execute('SELECT user_name FROM users WHERE user_id=? AND user_login =?', array($user_id, $user_login));

Podemos ver también que las cadenas no deben ir entre comillas en los parámetros, pues las comillas se le añaden a posteriori.

Otros métodos de la clase ADORecordSet

Métodos que devuelven una sola fila
Método: Descripción:
FetchRow() Devuelve una fila como un array y se desplaza al siguiente registro implícitamente.  No es necesario llamar después al método MoveNext.
FetchObject($toupper=true) Devuelve una fila como un objeto, siendo cada miembro un campo del registro. Si $toupper es igual a true los nombres de los campos irán en mayúsucula. Se recomienda usar el método FetchNextObject.
FetchNextObject($toupper=true) Igual que FetchObject pero mueve el puntero de posición al siguiente registro.
FetchObj() Igual que FetchObject(false)
FetchNextObject() Igual que FetchNectObject(false)
Métodos que devuelven todas las filas
Método: Descripción:
GetArray([$numRows]) Devuelve un array bidimensional con las filas desde la posición 0 a la $numRows -1. Si no se define $numRows devuelve toda la fila.

La clase RecordSet tiene muchos más métodos que nos pueden ser útiles, pero de momento con esto es suficiente. Si se quiere ver el resto de métodos se puede ver la documentación de la clase.

Comparte esta entrada:
Delicious Digg Google Technorati Menéame Fresqui Reddit Facebook Twitter Yahoo! Buzz MySpace Email BarraPunto

Tags: , , , ,

febrero 2, 2010 0

Tutorial de ADOdb: parte I

By in Librerías, PHP

Hola de nuevo. Después de más de un mes de vacaciones blogueras, al trabajo si que he tenido que ir, volvemos a la carga con un nuevo tutorial, en este caso de ADOdb.

ADOdb es una librería para PHP para acceder a bases de datos. La ventaja de usar esta librería está en que si se cambia de base de datos, por ejemplo de MySQL a PostgreSQL, no es necesario reescribir todo el código.

Lo primero que vamos a hacer es descargar la librería de la sección de descargas. Una vez tengamos la librería vamos a ver como conectarnos a una base de datos.

Para ello vamos a ver un pequeño ejemplo:

<?php

include('adodb/adodb.inc.php'); //Incluimos la librería

$conexion = ADONewConnection('mysqli'); // Creamos una conexión con el Driver MySQLi
$conexion->connect('host', 'user', 'password', 'database_name'); //Nos conectamos a la base dedatos

$recordSet = $conexion->Execute('SELECT * FROM tabla'); //Realizamos una consulta

if(!$recordSet) //Si ha habido algun error
{
  echo $conexion->ErrorMsg(); //Mostramos el mensaje de error
}
else
{
  while(!$recordSet->EOF) //Mientras no estemos al final de RecordSet
  {
    echo $recordSet->fields[0].' - '.$recordSet->fields[1].'<br>'; //Imprimimos los datos
    $recordSet->MoveNext(); //Nos movemos al siguiente registro
  }
  $recordSet->Close(); //Cerramos el RecordSet, esto es opcional
}

$conexion->Close(); //Cerramos la conexión. Opcional.
?>

Como podemos ver lo primero que hacemos es crear una conexión. Para eso llamamos a la función ADONewConnection indicándole el driver de base de datos que queremos usar. Esta función nos devuelve un objeto ADOConnection, mediante el cual realizaremos las consultas y otras operaciones a la base de datos. Aquí podemos ver el listado de bases de datos soportadas por ADOdb.

Una vez que hemos creado nuestra conexión lo siguiente es realizar la conexión en si. El método que hemos usado es el Connect. En este caso le pasamos el host de la base de datos, el usuario, el password y el nombre de la base de datos. Además de este método de conexión hay otros dos:

  • PConnect: Crea una conexión persistente.
  • NConnect: Fuerza a realizar una nueva conexión.

Una vez que nos hemos conectado ejecutamos una consulta con el método Execute, que nos devuelve un objeto ADORecordSet, y mostramos los datos devueltos.

Con esto queda concluida esta primera parte del tutorial. En las siguientes partes hablaremos más detenidamente de la clase RecordSet y de como realizar distintas consultas a la base de datos.

Comparte esta entrada:
Delicious Digg Google Technorati Menéame Fresqui Reddit Facebook Twitter Yahoo! Buzz MySpace Email BarraPunto

Tags: , , , ,