SwatDB
Simple Wrapper at DB (based on PDO)
Изначально (много лет назад) это был форк библиотеки DbSimple, сейчас от нее остались только регулярки для кастомных плейсхолдеров.
Generals (notes)
Select
Метод select()
Это обертка над PDO::prepare и PDOStatement:execute
/** @var Enjoys\SwatDB\Wrapper $db */
$sth = $db->select("SELECT * FROM ..."); //return PDOStatement
//далее
$sth->fetchAll(); //и т.д.Декорирующие select-методы
Возвращают сразу результат, а не PDOStatement
/** @var Enjoys\SwatDB\Wrapper $db */
$db->selectAll("SELECT * FROM ..."); //return array
$db->selectArr("SELECT id, name FROM ..."); //return array keypair id => name
$db->selectCell("SELECT COUNT(*) FROM ..."); //return int|string value
$db->selectCol("SELECT colname FROM ..."); //return array<int, string>Кэширование результатов декорирующих select-методов
Таких как, selectAll(), selectArr(), selectCell(), selectCol(), selectRow()
use Enjoys\SimpleCache\Cacher;
$db = Enjoys\SwatDB\DB::connect([
'dsn' => 'sqlite:memory',
//Любой cacher реализующий интерфейс Psr\SimpleCache\CacheInterface
'cacher' => new Cacher\Memcached()
]);
//Альтернативная установка cacher
$db->setCacher(new Cacher\FileCache());
$db->selectAll(300, "SELECT * FROM ..."); //кэширование на 5 минут
//аналогично и на другие методыInsert
Вставка одной строки
/** @var Enjoys\SwatDB\Wrapper $db */
$db->insert('table_name', ['column' => 'value', ...]); //Returns the number of rows affectedMySQL: Вставка строки вместе с ON DUPLICATE KEY UPDATE (UPSERT) простой вариант
/** @var Enjoys\SwatDB\Wrapper $db */
//INSERT INTO table_name SET (`column`, ...) VALUE ('value', ...) ON DUPLICATE KEY UPDATE column = ?, ...
$db->upsert('table_name', ['column' => 'value', ...]); //Returns the number of rows affectedSQLite: ON CONFLICT(x) DO UPDATE SET (самый простой вариант) Единственное условие, в массиве с данными, первым должен быть ключ или PRIMARY или UNIQUE
/** @var Enjoys\SwatDB\Wrapper $db */
//INSERT INTO table_name SET (`column`, ...) VALUE ('value', ...) ON CONFLICT(`column`) DO UPDATE SET column = ?, ...
$db->upsert('table_name', ['column' => 'value', ...]); //Returns the number of rows affectedВставка нескольких строк INSERT INTO table (column, ...) VALUES (value1, ...), (value2, ...)
/** @var Enjoys\SwatDB\Wrapper $db */
$db->insertMulti('table_name', ['column1', ...], [['value1', ...], ['value2', ...]]); //Returns the number of rows affected
$columns = ['name', 'email'];
$values = [
['Вася', 'vasya@example.com'],
['Федя', 'fedya@example.com'],
];
//INSERT INTO table_name (name, email) VALUES ('Вася', 'vasya@example.com'), (Федя', 'fedya@example.com')
$cnt = $db->insertMulti('table_name', $columns, $values); //$cnt = 2
/** @var Enjoys\SwatDB\Wrapper $db */
//$db->replace(); in future versionsUpdate
Простые сценарии UPDATE можно вызывать через метод update()
UPDATE table SET ... WHERE ...
/** @var Enjoys\SwatDB\Wrapper $db */
//SQL: UPDATE table_name SET 'mycolumn' = `updated` WHERE `id` = 1
$db->update('table_name', ['mycolumn' => 'updated'], 'id = ?d', 1); //Returns the number of rows affected
Delete
Простые сценарии DELETE можно вызывать через метод delete()
/** @var Enjoys\SwatDB\Wrapper $db */
//DELETE FROM table WHERE ...
$db->delete('table_name', 'id = ?d', 10); //Returns the number of rows affectedTruncate
/** @var Enjoys\SwatDB\Wrapper $db */
//DELETE FROM table WHERE ...
$db->truncate('table_name'); //Work in MySQL, SQLiteCreate, Drop, ... и тд
Пока это не реализовано, все в планах, сейчас лучше использовать exec для этих целей
/** @var Enjoys\SwatDB\Wrapper $db */
//$db->create(); //TODO
//$db->drop(); //TODO
//$db->truncate(); //TODO