Закончен новый модуль базы данных для PHPixie

Сегодня я написал последний тест для версии 3.0 модуля доступа к БД для PHPixie ^[1]. Когда я начал казалось что это займет всего несколько недель, но на самом деле все растянулось на где-то 2 месяца из-за огромного количества рефакторинга и переписывания сначала. Зато теперь мы имеем расширяемую библиотеку, которую можно использовать даже вне самого фреймворка (то есть если вас заставят писать на каком-то другом фреймворке или CMS вы сможете захватить свою любимую библиотеку с собой).

Я сделаю релиз после того как закончу модуль ORM и поправлю существующие модули для работы с новым API. Но если вам интересно вы можете заглянуть в ветку 3.0 на гитхабе ^[2] (следует однако предупредить что документации там пока нет, она появится вместе с ORM). А теперь давайте посмотрим на новые возможности.

С точки зрения среднестатистического пользователя

Я уже писал о продвинутой поддержке запросов с логическими условиями для MongoDB здесь ^[3], но если вам лень кликнуть по этой ссылке, то вот краткое объяснение: MongoDB не использует индексы при использовании запросов типа “(A or B) OR ( C and (D or E))”, так что PHPixie сама приведет запросы в такие формы которые будут их использовать.

Стали доступны несколько подходов для построения запросов:

$query
    ->where('name', 'Trixie')
    ->or_where('name', 'Tinkerbell')
    ->where_not('id', '>', 7)
    ->having('count','<', 5)
    ->or_having('count', 7);
 
//Или попроще:
$query
    ->where('name', 'Trixie')
    ->_or('name', 'Tinkerbell')
    ->_and_not('id', '>', 7)
    ->having('count', '<', 5)
    ->_or('count', 7);
//Заметьте как метод _or запоминает контекст в котором используется
//(то есть работает как для  'where' так и для 'having')

Несколько подходов к вложенной логике:

$query
    ->where('name','Trixie')
    ->or(function($builder){
        $builder
            ->_and('id',7)
            ->_or('id',5)
    });
//WHERE name = 'Trixie' OR ( id = 7 OR id = 5 )
 
//Или если вам не нравятся коллбеки 
//(также удобно при динамическом формировании запроса, например с EXT JS гридом)
$query->where('name','Trixie');
$query
    ->start_where_group('or')
        ->_and('id',7)
        ->_or('id',5)
    ->end_where_group();

Специальные операторы для сравнения колонок:

$query->where('fairies.id','*=','pixies.id');

Возможность использования вставок SQL кода с отдельными параметрами:

$expr = $this->db->expr('concat(name, ?)', array('test'));
$query->where($expr, 'Trixietest');
//WHERE concat(name, ?) = 'Trixietest';

Поиск строк по NULL значению, не зная наперед что это NULL:

$category_id = null;
$query->where('category_id', $category_id);
//даст WHERE category_id IS NULL
//а не WHERE category_id = NULL

Сложные условия для JOIN....ON используя уже знакомый синтакс:

$query->join('pixies');
 
//По умолчанию сравниваться будут колонки
$query->on('fairies.id','pixies.id');
 
//Можем добавить  условий и посложнее
$query->on('fairies.count','*>','pixies.count');

C точки зрения продвинутого разработчика

• Невероятно легкий, всего 57 килобайт кода
• Строители запросов (query builders) не содержат никакой логики относящийся к их парсингу (например в SQL код). Вместо этого каждый драйвер использует свой Parser сервис, делая сами объекты запросов легкими и дешевыми с точки зрения памяти. Использование парсеров как сервисы делает дебаг и расширение их тривиальными задачами. К слову каждый парсер создастся в памяти только раз для всех запросов.
• Каждый парсер разделен на парсеры отдельных условий и групп условий (Condition Group Parser). Такое разделение позволяет легко добавить свои кастомные операторы.
• Связывание зависимостей вынесено в отдельные классы драйверов, то есть ни в одном случае (кроме как выбрасывания исключений) ни один класс не создает объекты сам используя команду new. Это позволяет легко заменить любой класс на свою имплементацию.
• Запросы к MongoDB парсаються в специальные Runner объекты, которые легко поддаются дебагу на случай ошибки.
• SQL базы данных которые работают через PDO имеют свои отдельные адаптеры и парсеры что позволяет легко добавить поддержку любой базы данных с которой работает PDO используя минимум кода.

Код полностью покрыт PHPUnit тестами, что дает 166 тестов и 1151 сравнение.

Я надеюсь что этот пост передаст мою радость с проделанной работы и что финальный релиз ORM модуля уже недалеко.

Автор: jigpuzzled

Источник ^[4]