PHPackages                             ufee/sqlite3 - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database & ORM](/categories/database)
4. /
5. ufee/sqlite3

ActiveLibrary[Database & ORM](/categories/database)

ufee/sqlite3
============

Sqlite3 PHP Class (https://www.sqlite.org/)

1.0.2(2y ago)102.9k↓50%4[1 issues](https://github.com/ufee/Sqlite3/issues)1MITPHPPHP >=5.6

Since Jul 12Pushed 2y ago1 watchersCompare

[ Source](https://github.com/ufee/Sqlite3)[ Packagist](https://packagist.org/packages/ufee/sqlite3)[ Docs](https://github.com/ufee)[ RSS](/packages/ufee-sqlite3/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (3)Dependencies (1)Versions (4)Used By (1)

Sqlite3 PHP Class
-----------------

[](#sqlite3-php-class)

Для полноценной работы требуется Sqlite3, собранный с поддержкой SQLITE\_ENABLE\_UPDATE\_DELETE\_LIMIT
Протестировано на версии 3.11.0

Установка
---------

[](#установка)

```
composer require ufee/sqlite3

```

Структура
---------

[](#структура)

Объект БД

```
\Ufee\Sqlite3\Database;
$db = \Ufee\Sqlite3\Sqlite::database(string $path, array $options = [
	'flags' => SQLITE3_OPEN_READWRITE | SQLITE3_OPEN_CREATE,
	'encryption_key' => null,
	'busy_timeout' => 15,
	'journal_mode' => 'WAL',
	'synchronous' => 'NORMAL',
	'exceptions' => true
]);
```

Объект Таблица

```
\Ufee\Sqlite3\Table;
$table = $db->table(string $name);
```

Объект Запрос

```
\Ufee\Sqlite3\Query\Insert;
$insert = $table->insert(array $columns);

\Ufee\Sqlite3\Query\Select;
$select = $table->select(array $columns);

\Ufee\Sqlite3\Query\Update;
$update = $table->update(array $columns);

\Ufee\Sqlite3\Query\Delete;
$delete = $table->delete();
```

Объект Коллекция Запросов

```
\Ufee\Sqlite3\Queries;
$queries = $db->queries();
$queries = $table->queries();
```

Отладка запросов

```
$db->queries()->listen(function($data) {
	echo 'Table: '.$data['table']."\n";
	echo '  Sql: '.$data['sql']."\n";
	echo ' Time: '.$data['time']."\n";
});
```

Работа с классом
----------------

[](#работа-с-классом)

Получение объекта БД

```
$db = Sqlite::database('path/to/file.db');

$temp_db_path = tempnam(sys_get_temp_dir(), 'Sqlite3');
$db = Sqlite::database($temp_db_path);

$db = Sqlite::database(':memory:');
```

Проверка на существование базы и создание

```
if (!$db->exists()) {
	$db->create();
}
```

Или проверка на существование файла (быстрее)

```
if (!$db->fileExists()) {
	$db->create();
}
```

Открытие соединения с БД
На практике не требуется, выполняется автоматически

```
$db->open();
```

Выполнение произвольных запросов и команд

```
$result = $db->query($query); // return Query\Result
$rows = $result->getRows($mode = SQLITE3_ASSOC);

$result = $db->single($query, $entire = true); // return array
$result = $db->exec($command); // return bool
$result = $db->pragma($key, $val); // return bool
```

Закрытие соединения с БД

```
$db->close();
```

Получение объекта Таблицы

```
$tables = $db->tables();
$table = $db->table('test_table');
```

Проверка на существование и создание

```
if (!$table->exists()) {
	// с указанием типов данных
	$table->create([
		'id' => 'INTEGER PRIMARY KEY',
		'amount' => 'REAL',
		'data1' => 'TEXT',
		'data2' => 'BLOB',
		'other' => 'INTEGER DEFAULT 5'
	]);
	// или без привязки к типу данных
	$table->create([
		'id,
		'data',
		'other'
	]);
}
```

Получение информации о таблице

```
$info = $table->info($key = null);
// [type, name, tbl_name, rootpage, sql]
```

Получение информации о столбцах

```
$culumns = $table->columns($name = null);
// [name => [cid, name, type, notnull, dflt_value, pk]]
```

Задать свой тип данных столбца для последующих запросов

```
$table->setColumnType(string $name, string $type); // integer, real, text, blob, null
$table->setColumnType('category', 'integer');
$table->setColumnType('title', 'text');
```

Удаление таблицы

```
$table->drop();
```

Примеры запросов
----------------

[](#примеры-запросов)

Запросы выполняются с использованием подготовленных выражений (автоматически).
Операторы условий: \[=|>|<|<=|>=|!=|BETWEEN|NOT BETWEEN|IN|NOT IN|LIKE|NOT LIKE|GLOB|NOT GLOB\]
Для нижеописанных примеров создаем БД и таблицы:

```
$db = \Ufee\Sqlite3\Sqlite::database(
	tempnam(sys_get_temp_dir(), 'Sqlite3')
);
$goods = $db->table('goods');
$meta = $db->table('goods_meta');

if (!$goods->exists()) {
	$goods->create([
		'id' => 'INTEGER PRIMARY KEY',
		'category' => 'INTEGER DEFAULT 1',
		'price' => 'REAL DEFAULT 0.00',
		'title' => 'TEXT',
		'hot' => 'INTEGER DEFAULT NULL',
		'created_at' => 'INTEGER DEFAULT (DATETIME(\'now\'))'
	]);
	$meta->create([
		'good_id' => 'INTEGER UNIQUE',
		'sale' => 'REAL DEFAULT 0.00',
		'descr' => 'TEXT',
		'star' => 'INTEGER DEFAULT 0',
	]);
}
```

Запрос Insert
-------------

[](#запрос-insert)

```
$insert = $table->insert('id, category, data')
	->orRollback()
	->orAbort() // is default
	->orFail()
	->orIgnore()
	->orRreplace();
$insert->rows(array $rows); // return bool
// or
$insert->row(array $row); // return bool|integer
```

Вставка одной строки

```
$insert = $goods->insert('category, price, title');

$increment_id = $insert->orFail()->row([2, 7299.50, 'Notebook Pro']);
// INSERT OR FAIL INTO goods (category, price, title) VALUES (..., ..., ...)

$meta->insert([
	'good_id' => $increment_id,
	'descr' => 'Professional device',
	'star' => 4
]);
// INSERT INTO goods_meta (good_id, descr, star) VALUES (..., ..., ...)

$increment_id =$insert->orAbort()->row([2, 6999.70, 'Notebook Adv']);
// INSERT OR ABORT INTO goods (category, price, title) VALUES (..., ..., ...)

$meta->insert([
	'good_id' => $increment_id,
	'descr' => 'Advanced device',
	'star' => 5
]);
// INSERT INTO goods_meta (good_id, descr, star) VALUES (..., ..., ...)

$increment_id = $goods->insert([
	'category' => 3,
	'title' => 'Mobile Pro',
	'price' => 3799.90
]);
// INSERT INTO goods (category, price, title) VALUES (..., ..., ...)

$meta->insert([
	'good_id' => $increment_id,
	'sale' => 499.90,
	'descr' => 'Professional device',
	'star' => 3
]);
// INSERT INTO goods_meta (good_id, descr, star) VALUES (..., ..., ..., ....)
```

Вставка нескольких строк

```
$insert = $goods->insert('category, title');
$result = $insert->rows([
	[4, 'TV 1000'],
	[4, 'TV 2000'],
	[4, 'TV 3000']
]);
// INSERT INTO goods (category, title) VALUES (..., ...), (..., ...), (..., ...)
```

Запрос Select
-------------

[](#запрос-select)

```
$select = $table->select()
	->distinct() // for unique rows
	->where($column, $value = false, $operator = '=')
	->orWhere($column, $value = false, $operator = '=')
	->short($short_table_name)
	->join($join_table_name, $on, $type = '')
	->leftJoin($join_table_name, $on)
	->innerJoin($join_table_name, $on)
	->groupBy($columns)
	->having($column, $value = false, $operator = '=')
	->orHaving($column, $value = false, $operator = '=')
	->orderBy($column, $by = 'DESC');
$count = $select->count(); // return integer
$row = $select->row($column = null); // return array row or string|integer column value
// or
$rows = $select->rows($limit = null, $offset = null); // return array
```

Произвольное условие (без подготовленных выражений)

```
$select->where('id != another OR ...')
$select->having('other > another AND ...')
```

Получение количества строк

```
$count = $goods->select()->count();
// SELECT COUNT(*) as rows_count FROM goods LIMIT 1
```

Получение строк и их количества с учетом условий

```
$select = $goods->select()
	->where('id', 1, '>')
	->orderBy('hot');
$count = $select->count();
// SELECT COUNT(*) as rows_count FROM goods WHERE id > ... ORDER BY hot DESC LIMIT 1
$rows = $select->rows(3);
// SELECT * FROM goods WHERE id > ... ORDER BY hot DESC LIMIT 3

$select = $goods->select('id, category, title')
	->where('hot', null, 'IS NOT')
	->orderBy('hot');
$rows = $select->rows(2,2);
// SELECT id,category,title FROM goods WHERE hot IS NOT NULL ORDER BY hot DESC LIMIT 2 OFFSET 2
```

Получение значений одной строки

```
$select = $goods->select()->where('id', 1);
$row = $select->row();
// SELECT * FROM goods WHERE id = ... LIMIT 1
```

Получение одного значения из одной строки

```
$select = $goods->select('title')->where('id', 1);
$title = $select->row('title');
// SELECT * FROM goods WHERE id = ... LIMIT 1
```

Получение с использованием JOIN

```
$select = $goods->select('g.id, g.category, g.title, m.descr, m.sale, g.hot, m.star, g.created_at')
	->short('g')->innerJoin('goods_meta AS m', 'm.good_id=g.id')
	->where('g.category', [1,2,3,4,5], 'IN')
	->where('m.star', 1, '>')
	->orderBy('m.star');
$count = $select->count();
// SELECT COUNT(*) as rows_count FROM goods AS g INNER JOIN goods_meta AS m ON m.good_id=g.id WHERE g.category IN (...,...,...,...,...) AND m.star > ... ORDER BY m.star DESC LIMIT 1
$rows = $select->rows();
// SELECT g.id,g.category,g.title,m.descr,m.sale,g.hot,m.star,g.created_at FROM goods AS g INNER JOIN goods_meta AS m ON m.good_id=g.id WHERE g.category IN (...,...,...,...,...) AND m.star > ... ORDER BY m.star DESC
```

Запрос Update
-------------

[](#запрос-update)

```
$update = $table->update('category, data')
	->where($column, $value = false, $operator = '=')
	->orWhere($column, $value = false, $operator = '=')
	->orderBy($column, $by = 'DESC')
	->set([$category, $data]);
$update->rows($limit = null, $offset = null); return integer changed rows
// or
$update->row(); return bool
```

Обновление одной строки

```
$update = $goods->update('price, title, hot')
	->where('id', 1)
	->set([6950.10, 'Notebook Pro (hot)', 1]);
$update->row();
// UPDATE goods SET price=..., title = ..., hot = ... WHERE id = ... LIMIT 1
```

Обновление нескольких строк

```
$update = $goods->update('hot')
	->where('category', 3)
	->orWhere('price', 5000, '