¿Qué es la hidratación Doctrine? [cerrado]

He leído sobre la hidratación en la documentación de la doctrina, pero todavía no puedo entender qué es.

¿Podría alguien explicarme?

La hidratación es un método que se utiliza para devolver resultados de consultas. Por ejemplo:

1. HYDRATE_ARRAY - Esto le devolverá una matriz de registros que están representados por otra matriz:

   $q = Doctrine_Query::create()
      ->from('Post p')
      ->setHydrationMode(Doctrine::HYDRATE_ARRAY);
   
   $resultSet = $q->execute(); // $resultSet is an array
   
   foreach ($resultSet as $post) {
       // $post is an array
       echo $post['title'];
   }
   

2. HYDRATE_RECORD- Esto le devolverá una colección ( Doctrine_Collection ) de objetos:

   $q = Doctrine_Query::create()
      ->from('Post p')
      ->setHydrationMode(Doctrine::HYDRATE_RECORD); // Unnecessary, HYDATE_RECORD is default method
   
   $resultSet = $q->execute(); // $resultSet is an Doctrine_Collection object
   
   foreach ($resultSet as $post) {
       // $post is an Post object
       echo $post->getTitle();
       echo $post['title']; // Each Doctrine's Model object implements ArrayAccess interface so this is possible
       echo $post->myCustomMethod();
   }
   

3. HYDRATE_SINGULAR_SCALAR - Devolverá el valor de la primera columna del resultado de la consulta:

    $q = Doctrine_Query::create()
      ->select('p.created_at')
      ->from('Post p')
      ->where('p.id = ?', 321)
      ->setHydrationMode(Doctrine::HYDRATE_SINGULAR_SCALAR); 
   
   $createdAt = $q->execute(); // $createdAt has value of first column from first record from result set (eg.: 2008-04-06 21:22:35)
   

Hay algunos métodos más, puede leer sobre cada uno en la documentación.

$q->fetchOne(array(), Doctrine_Core::HYDRATE_ARRAY);

Devolverá solo una matriz simple en lugar de un objeto de colección de doctrina.