web-dev-qa-db-fra.com

Qu'est-ce que l'hydratation Doctrine?

J'ai lu sur l'hydratation dans la documentation de la doctrine mais je ne comprends toujours pas ce que c'est.

Quelqu'un pourrait-il expliquer?

88
never_had_a_name

L'hydratation est une méthode utilisée pour renvoyer les résultats d'une requête. Par exemple:

  1. HYDRATE_ARRAY - Cela vous renverra un tableau d'enregistrements qui sont représentés par un autre tableau:

    $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 - Cela vous renverra une collection ( Doctrine_Collection ) d'objets:

    $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 - Renvoie la valeur de la première colonne du résultat de la requête:

     $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)
    

Il existe quelques méthodes supplémentaires, vous pouvez en lire plus dans la documentation.

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

Il renverra juste un tableau simple au lieu d'un objet de collection doctrine.

3
Jubayer Arefin