goDB 1.1.3

После года разгильдяйничества, решил снова заняться своей библиотечкой для работы с MySQL.

Изменения в версии 1.1.3 незначительны, но, надеюсь, что вскоре будет что-нибудь поинтереснее.

Плейсхолдер ?e

?e — экранированная (escape) часть строки. В отличии от простого ? (целая строка) не заключается в кавычки.

Пример:

$search  = '"Пыха" рулит';
$pattern = 'SELECT * FROM `table` WHERE `text` LIKE "%?e%"';
$data    = array($search);
$db->query($pattern, $data, 'assoc'); // SELECT * FROM `table` WHERE `text` LIKE "%\"Пыха\" рулит%"

Плейсхолдер ?q

?q — часть запроса. Вставляется напрямую без каких-либо изменений. Если нужно составить запрос из нескольких строк, а конкатентацию использовать не хочется.

$where = '`col`=12';
 
$pattern = 'SELECT * FROM `table` WHERE ?q ORDER BY `id` DESC';
$data    = array($where);
$db->query($pattern, $data, 'assoc'); // SELECT * FROM `table` WHERE `col`=12 ORDER BY `id` DESC';

Можно сделать с конкатентацией:

$pattern = 'SELECT * FROM `table` WHERE '.$where.' ORDER BY `id` DESC';

Отличие в том, что при конкатентации $where станет частью шаблона и в нём могут присутствовать плейсхолдеры. При вставке через ?q никакой обработки значения не будет.

Метод countRows()

$db->countRows(string $table [, string $where [, array $data])Получение количества строк в таблице.

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

$db->countRows('table');                       // SELECT COUNT(*) FROM `table`
$db->countRows('table', '`id`>10');            // SELECT COUNT(*) FROM `table` WHERE `id`>10
$db->countRows('table', '`id`>?i', array(10)); // SELECT COUNT(*) FROM `table` WHERE `id`>10

@todo: длинные плейсхолдеры

По сравнению с изначальной версией плейсхолдеров расплодилось: ?, ?i, ?n, ?s, ?v … Чёрт ногу сломит. В следующей версии собираюсь сделать «длинные» эквиваленты существующих:

?s - ?set
?v - ?values
?t - ?table
...

Все предложения по этому и другим поводам можно оставлять здесь или на Пыхе.