Doctrine

http://www.doctrine-project.org/
jueves, 26 de septiembre de 13

¿Qué es Doctrine?

¿Qué es Doctrine?
•DBAL (Database abstraction layer)
•ORM (Object Relational Mapper)

¿Qué signiﬁca DBAL?

Database Abstraction
Layer

DBAL
“Powerful database abstraction layer with many features for
database schema introspection, schema management and
PDO abstraction”

DBAL
<?php
use DoctrineDBALConfiguration;
use DoctrineDBALDriverManager;
$config = new Configuration();
//..
$connectionParams = array(
    'dbname' => 'mydb',
    'user' => 'user',
    'password' => 'secret',
    'host' => 'localhost',
    'driver' => 'pdo_mysql',
);
$conn = DriverManager::getConnection($connectionParams, $config);
Crear conexión

DBAL
<?php
// ...
$stmt = $conn->query('SELECT * FROM users');
while ($row = $stmt->fetch()) {
echo $row['name'], PHP_EOL;
}
Ejecutar consulta

DBAL
<?php
// ...
$stmt = $conn->prepare('SELECT * FROM users WHERE name = ? AND age = ?');
$stmt->bindValue(1, $name);
$stmt->bindValue(2, $age);
$stmt->execute();
Ejecutar consulta con parámetros

DBAL
<?php
// ...
$stmt = $conn->prepare('SELECT * FROM users WHERE id = :id');
$stmt->bindValue(':id', $id);
$stmt->execute();
Ejecutar consulta con parámetros con nombre

DBAL
<?php
// ...
$stmt = $conn->prepare('SELECT * FROM users WHERE created > :created');
$stmt->bindValue(':created', $created, 'datetime');
$stmt->execute();
Ejecutar consulta con parámetros indicando typo de dato

¿Qué es un ORM?

Object-Relational
Mapping

"Es una técnica de programación para convertir datos
entre el sistema de tipos utilizado en un lenguaje de
programación orientado a objetos y la utilización de
una base de datos relacional, utilizando un motor de
persistencia. En la práctica esto crea una base de
datos orientada a objetos virtual, sobre la base de
datos relacional."
http://es.wikipedia.org/wiki/Mapeo_objeto-relacional

ORM
• Transforma datos de la DB a objetos PHP

ORM
• Y de PHP a la DB

ORM
• Transforma las relaciones entre dos tablas

ORM
• Simpliﬁca la transformación entre tipos de
datos

ORM
• Simpliﬁca la transformación entre tipos de
datos
• Data Mapper

ORM
¿Qué nos soluciona?

ORM
• Podemos utilizar orientación a objetos

ORM
• Evita tener SQL en todos lados

ORM
• Simpliﬁca el entendimiento del código

ORM
• Facilita el proceso de migración

ORM
• Facilita el proceso de migración
• SQL Injection

ORM
¿Problemas?

ORM
¿Problemas?
• Agrega overhead
• Puede ejecutar SQL no óptimo(si no se
utiliza adecuadamente)
• No siempre es la mejor solución

ORM
EntityManager

ORM
EntityManager
• Responsable de gestionar la persistencia y
obtención de entidades

ORM
EntityManager
• Uno por conexión

ORM
EntityManager
• Uno por conexión
• Utiliza el patrón UnitOfWork para optimizar
la gestión de muchas entidades

ORM
EntityManager
<?php
use DoctrineORMEntityManager;
use DoctrineORMToolsSetup;
$paths = array("/path/to/entity-files");
$isDevMode = false;
// Configuracion para entidades que utilizan annotations
$config = Setup::createAnnotationMetadataConfiguration($paths, $isD
evMode);
// Obtengo el EntityManager
$entityManager = EntityManager::create($connection, $config);

ORM
EntityManager
<?php
// ...
// Parametros de conexión
$connectionParams = array(
    'dbname' => 'mydb',
    'user' => 'user',
    'password' => 'secret',
    'host' => 'localhost',
    'driver' => 'pdo_mysql',
);
// Obtengo el EntityManager
$entityManager = EntityManager::create($connectionParams, $config);

ORM
Entity Manager
// Indica al EntityManager que se
// debe persistir la entidad en la db
$entityManager->persist($entity);
persist()

ORM
Entity Manager
// Escribe los cambios en la base de datos
$entityManager->flush();
ﬂush()

ORM
Entidades

ORM
Entidades
• Objetos PHP

ORM
Entidades
• Objetos PHP
• Representan a una tabla en la BD

ORM
Entidades
• Objetos PHP
• Una instancia representa a una ﬁla en la tabla

ORM
Entidades
• Objetos PHP
• Una instancia representa a una ﬁla en la tabla
• Se pueden heredar

ORM
Entidades
<?php
class User
{
private $id;
private $name;
public function getId()
{
return $this->id;
}
public function getName()
{
return $this->name;
}
public function setName($name)
{
$this->name = $name;
}
}
$a = new User();
$a->setName("Ismael");

ORM
Entidades
<?php
/** @Entity */
class User
{
    /**
     * @Id
     * @Column(type="integer")
     * @GeneratedValue(strategy="AUTO")
     */
    private $id;
    /**
     * @Column(type="string")
     */
    private $name;
}

ORM
Entidades
$user = new User();
$user->setName("Ismael");
$entityManager->persist($user);
echo $user->getId();
1.Instanciación
2.Hidratación
3.Persistencia
4.Escritura

ORM
Relaciones entre entidades

ORM
•OneToOne
•OneToMany
•ManyToOne
•ManyToMany

ORM
<?php
/** @Entity */
class User
{
    /**
     * @Id
     */
    private $id;
    /**
     */
    private $name;
    /**
     * @OneToMany(
* targetEntity="PhoneNumber",
* mappedBy="user",
* cascade={“persist”, “remove”}
* )
     */
    private $phoneNumbers;
}
<?php
/** @Entity */
class PhoneNumber
{
    /**
     * @Id
     */
    private $id;
    /**
     */
    private $phone;
    /**
     * @ManyToOne(
* targetEntity="User",
* inversedBy="phoneNumbers"
* )
     */
    private $user;
}

ORM
// Crea una instancia de PhoneNumber
$phoneNumber = new PhoneNumber();
$phoneNumber->setPhone("555-1234");
$user = new User();
$user->setName("Ismael");
// Asocia el phone number al usuario
$user->addPhoneNumber($phoneNumber);
// Guarda ambas entidades
$entityManager->persist($user);
foreach ($user->getPhoneNumbers() as $phoneNumber) {
echo $phoneNumber->getPhone(), PHP_EOL;
}

ORM
Repositorios

ORM
Repositorios
• Nos da acceso a los datos

ORM
Repositorios
• Independiente de como se persisten los
datos

ORM
Repositorios
datos
• Existe uno por entidad

ORM
Repositorios
datos
• Existe uno por entidad
• Puedo crear mis propios repositorios

ORM
Repositorios
<?php
interface ObjectRepository
{
    public function find($id);
    public function findAll();
    public function findBy(array $criteria, array $orderBy = null,
$limit = null, $offset = null);
    public function findOneBy(array $criteria);
}

ORM
Repositorios
<?php
// Retorna el repositorio para la entidad NamespaceUser
$repository = $entityManager->getRepository('NamespaceUser');
// Obtengo el objeto con ID = 1
$user = $repository->find(1);
echo $user->getName();
ﬁnd()

ORM
Repositorios
<?php
// Retorna el repositorio para la entitdad NamespaceUser
// Obtengo un array de objetos User
$user = $repository->findAll();
foreach ($users as $user) {
}
ﬁndAll()

ORM
Repositorios
<?php
// Obtengo un array de objetos User donde status = enabled
$user = $repository->findBy(array('status' => 'enabled'));
foreach ($users as $user) {
}
ﬁndBy()

ORM
Repositorios
<?php
// Obtengo el primer objeto User donde status = enabled
$user = $repository->findOneBy(array('status' => 'enabled'));
ﬁndOneBy()

Resumen
DBAL
Capa de abstracción para la interacción con
nuestra bases de datos
ORM
Herramienta que nos permite traducir objetos
PHP en registros de la base de datos y viceversa

¿Preguntas?

¡Gracias!

Doctrine

Recomendados

Recomendados

Más contenido relacionado

Similar a Doctrine

Similar a Doctrine (20)

Más de Ismael Ambrosi

Más de Ismael Ambrosi (6)

Último

Último (20)

Doctrine