KO3: модуль database и модели

Предлагаю рассмотреть немногочисленные (пока) возможности по работе с БД, предоставленные «бетой» Kohana v3. Люди, «подсевшие» на комфортные ORM и Query Builder, приготовьте сердечные капли

Итак, для начала напомню, что все классы для работы с БД выделены в отдельный (и единственный на данный момент) модуль Database. Разработчикам показалось мало такого ущемления баз данных, они еще и исключили все драйверы, кроме MySQL (объяснив это тем, что они не используют другие СУБД, но будут рады драйверам со стороны). Однако и это еще не самое страшное. Абстрактный класс Database_Core, являющийся «сердцем» модуля, содержит в пять раз меньше методов, чем его аналог из 2.3.4.

По сути «дельными» являются только метод query($type, $sql), а также информационные list_tables() и list_columns($table). Как обычно, методы connect() и disconnect() в явном виде не требуются, т.к. в query() производится проверка на наличие линка с БД. Никаких намеков на будущее наличие методов а-ля Query Builder мы не видим, но отчаиваться не стоит — скорее всего все это будет выделено в отдельную библиотеку.

Вы заметили, что метод Database::query() принимает новый параметр $type? Возможные значения перечислены в виде констант с говорящими названиями, например Database::SELECT. Кажется, что не очень удобно, т.к. обычно из plain-запроса и так видно, какой тип. Однако давайте заглянем в библиотеку DB_Core из файла classes/db.php:

class DB_Core {
 
	public static function query($type, $sql)
	{
		return new Database_Query($type, $sql);
	}
 
	public static function select($sql)
	{
		return new Database_Query(Database::SELECT, $sql);
	}
...
}

Статические методы этой библиотеки позволят нам использовать их из любого места в приложении, например так: DB::select($sql). Теперь становится понятно, что сама по себе библиотека Database напрямую навряд ли будет использоваться, если есть такие удобные обертки.

В бете класс DB содержит 8 методов, но работать «из коробки» будут только первые два (select() и query()), остальные «ругнутся» на отсутствующие классы. По аналогии с select() можно привести в порядок методы insert(), update() и delete().

Эти методы возвращают экземпляр класса Database_Query, цель которого — сформировать и передать библиотеке Database SQL-запрос. Для заполнения запроса есть разнообразные методы, связанные с установкой внутреннего свойства $_values, оно будет использовано как хранилище плейсхолдеров. Сама подстановка значений, экранирование данных и собственно передача запроса выполняется в методе execute(). В результате, получить всех активных пользователей из таблицы users можно так:

$users = DB::select('select * from users where active=:active')
             ->values(array(':active'=>TRUE))
             ->execute();

Что с этим делать дальше? Как вы наверное догадались, метод execute() возвращает результат работы метода Database::query(), т.е. объект класса Database_Result, а еще точнее — его потомка, например Database_Mysql_Result. В целом работа с ним не изменилась (можно обрабатывать как массив, есть методы as_array() и count(), и т.д.), но есть нюанс — если в 2.3.x есть возможность указать, в каком виде возвращать записи (объекты или массивы), то в нынешнем драйвере Mysql почему-то доступны только массивы, в коде явно прописано использование mysql_fetch_assoc(). Возможно это следствие явно прослеживаемой тенденции к уменьшению количества конфигурационных файлов, увидим. В общем, забудем о $result->id, используем $result["id"].

Как я говорил в начале статьи, ORM и Query Builder отсутствуют как класс (точнее как два класса ), но класс Model есть. Он ничем не отличается от моделей ветки 2.3, только вместо $this->db объект Database доступен через $this->_db. Таким образом, получить все тех же многострадальных активных пользователей с использованием моделей мы сможем так:

// classes/model/user.php
class Model_User extends Model {
 
	public function get_active() {
		return DB::select('select * from users where active=:active')
             		->values(array(':active'=>TRUE))
             		->execute($this->_db);
	}
}
// classes/controller/test.php
class Controller_Test extends Controller {
	public function action_users() {
		$model = new Model_User();
		$users = $model->get_active();
		foreach($users as $user)
			$this->request->response .= "<p>".$user['username']."</p>";
	}
}

Если вспомнить о кэшировании, то на данный момент никаких встроенных методов нет. Единственное реализованное решение — метод Kohana::cache(), например он используется в Kohana::auto_load() и route::_construct() для быстрого доступа к часто повторяющейся служебной информации (в данном случае имена классов и скомпилированные REGEX‘ы маршрутов).

В общем-то это все, чем на данный момент располагает KO3. С одной стороны, тоскливо и неудобно, но с другой — какой простор для развития. Работайте с базами данных, используйте Kohana!