W Zend Framework 3 hydratory to mechanizm umożliwiający konwersję danych w jednym formacie na dane w innym formacie, np. z danych otrzymanych z bazy danych na obiekty dziedzinowe, które są wykorzystywane w aplikacji.
Hydratory są wykorzystywane w Zend Framework 3 w różnych miejscach, w tym w mapowaniu wyników zapytań do obiektów dziedzinowych. Przykładowo, możemy wykorzystać hydrator do mapowania wyników zapytań do encji reprezentujących użytkowników.
Poniżej znajduje się prosty przykład użycia hydratora w Zend Framework 3:
<?php
use Zend\Hydrator\ClassMethods;
use MyApp\Entity\User;
// Pobieramy dane z bazy danych
$data = $dbAdapter->query('SELECT * FROM users WHERE id = ?', [$id])->execute()->current();
// Tworzymy instancję hydratora
$hydrator = new ClassMethods();
// Konwertujemy dane na obiekt User
$user = new User();
$hydrator->hydrate($data, $user);
// Pracujemy na obiekcie User
$user->setName('Jan Kowalski');
$user->setEmail('jan.kowalski@example.com');
// Konwertujemy obiekt User z powrotem na tablicę
$data = $hydrator->extract($user);
// Zapisujemy zmiany do bazy danych
$dbAdapter->query('UPDATE users SET name = ?, email = ? WHERE id = ?', [$data['name'], $data['email'], $id]);
W powyższym przykładzie tworzony jest hydrator z klasy ClassMethods, który mapuje właściwości obiektu na nazwy kolumn w tabeli, a następnie konwertuje dane z bazy danych na obiekt User. Po zmianie danych w obiekcie User, hydrator jest ponownie używany do konwersji obiektu na tablicę danych, która może być zapisana z powrotem do bazy danych.