Что такое учение гидратации?

Question

Я читал о гидратации в документации доктрины, но до сих пор не могу понять, что это такое.

Может кто-нибудь объяснить, пожалуйста?

Answer 1

Гидратация - это метод, используемый для возврата результатов запроса. Например:

1. HYDRATE_ARRAY - Это вернет вам массив записей, представленных другим массивом:

   $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 - Это вернет вам коллекцию ( Doctrine_Collection) объектов:

   $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 - Вернет значение первого столбца результата запроса:

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

Существует еще несколько методов, о каждом из которых вы можете прочитать в документации.

Answer 2

Ссылка на документацию Doctrine2, объясняющую HYDRATION: http://www.doctrine-project.org/docs/orm/2.0/en/reference/dql-doctrine-query-language.html

Answer 3

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

It will return just a simple array instead of a doctrine collection object.