Doctrine ORM: Inicio Rápido

Estas operaciones hacen uso frecuente de los objetos Doctrine_Table los cuales pueden ser obtenidos llamando el método Doctrine::getTable() y como parámetro el nombre de la clase modelo, con los ejemplos se entenderá mejor.

Método find()
El método find() hace una búsqueda a partir de la clave primaria de la tabla.

$user_id = 1;
$u = Doctrine::getTable('User')->find($user_id);
echo $u->username;

Método findOneBy*()
Este es un método mágico al cual simplemente se le tiene que apendizar el nombre de la columna y buscara en la tabla a partir de esa columna. Este método solo obtiene un registro. Al usar estos métodos se debe capitalizar la primer letra de el nombre de la columna aunque este escrito con minúsculas…

$username = 'myuser';
$u = Doctrine::getTable('User')->findOneByUsername($username);
echo $u->username;

Método findBy*()
Otro método mágico el cual funciona similar al anterior pero obteniendo múltiples registros.

$users = Doctrine::getTable('User')->findByRole('admin');
echo $users[0]->username;
echo $users[1]->username;

DQL
Doctrine Query Language es una de las características mas fuertes de Doctrine, en este ejemplo crearemos un objeto query y a partir de ahí se irá generando la consulta, este ejemplo es muy básico pero se entenderá fácilmente, después de ejecutar la consulta nos regresara un objeto Doctrine_Collection.

$role = 'admin';
$q = Doctrine_Query::create()
->select('username')
->from('User')
->where('role = ?', $role)
->limit(20);
$users = $q->execute();
echo $users[0]->username;
echo $users[1]->username;

Método toArray()
El objetos Doctrine_Record tiene un método toArray() el cual nos permitirá obtener un arreglo asociativo a partir de un Doctrine_Record…

$user_id = 1;
$u = Doctrine::getTable('User')->find($user_id);
$u_arr = $u->toArray();
print_r($u_arr);

Objeto Record
Puedes hacer cualquier cantidad de cambios a un objeto, al llamar el método save() se actualizara en la base de datos…

$user_id = 1;
$u = Doctrine::getTable('User')->find($user_id);
$u->password = 'newpass';
$u->save();

DQL
Cuando quieres actualizar muchos registros a la vez esta es una opción muy recomendada, en este ejemplo el método execute() regresa el numero de registros afectados…

$status = 'active';
$q = Doctrine_Query::create()
->update('User')
->set('status', '?', $status)
->where('id < 5');
$numrows = $q->execute();
echo "$numrows records updated";

Objeto Record

$user_id = 1;
$u = Doctrine::getTable('User')->find($user_id);
$u->delete();

DQL
Al igual que en la actualización esta es una opción para la eliminación, en este ejemplo el método execute() regresa el numero de registros eliminados…

$q = Doctrine_Query::create()
->delete('User')
->where('id < 5');
$numrows = $q->execute();
echo "$numrows records deleted";

Pues esto es todo por hoy, espero sea de ayuda y les permita comenzar a usar Doctrine aquí nos falto tocar el tema de la configuración de Doctrine pero la verdad es que no es muy complicado, como sea si alguien tiene algún problema no dude en consultar, ojala y pueda ayudarlos… saludos