db

Обзор

Используйте db как короткое сессионное зеркало установленного драйвера: один раз выберите MySQL/MariaDB, PostgreSQL, Redis, SQLite или MongoDB, а затем работайте через единый компактный префикс — просмотр, выгрузка, резервные копии и нативные команды движка.

Один префикс, разные движки

db — общая точка входа для установленных драйверов баз данных, а не отдельный движок. Команда запоминает выбранный драйвер и предоставляет его общие операции, а текст после : оставляет на родном языке базы данных. Так повседневные действия остаются короткими, но SQL, структуры Redis и документы MongoDB не смешиваются в одну модель.

Синтаксис

db [driver] [options]

Справочник

Зачем нужна команда

db — не отдельная база данных, а удобный общий вход к установленным драйверам. Для базы в одном файле выбирайте db sqlite, а для сервера MySQL/MariaDB — db mysql. Сам db не преобразует SQL в команды Redis или MongoDB: он передаёт запрос выбранному модулю. Прямые команды sqlite и mysql продолжают работать независимо.

Как пользоваться

Сначала выберите драйвер, затем подключитесь: db sqlite -c \sandbox\db\shop.sqlite. Команда db -t покажет таблицы, db -n products 2 — две строки, db -f products "shoe" — результаты поиска. После db : пишется язык конкретной базы, например SQL для SQLite. db mariadb выбирает модуль mysql, но отсутствующие драйверы не устанавливает.

Ограничения и безопасность

Без -m выбор драйвера и подключение живут в текущей PHP-сессии. -m [name] по желанию сохраняет профиль в .lil.key, где могут находиться и пароли; -k просматривает профили, -K подключается повторно, -M удаляет запись. Перед -a/-w/-d, load и нативными запросами делайте резервную копию. Для работы нужны установленный модуль и соответствующее расширение PHP. Все примеры — учебные, не обращения к базе посетителя.

Установка и управление

Устанавливайте актуальную совместимую версию. Для полного набора возможностей выбирайте Base, для сокращённого — Minimum; уже установленный модуль обновляет команда upgrade.

Base и Minimum — два пакета одного текущего релиза модуля, а не разные версии команды.

Примеры

Примеры можно копировать, но сайт их не выполняет. Перед запуском на реальном проекте проверьте пути, права и разрушающие флаги.

No database driver selected
mysql       MySQL / MariaDB · installed
postgresql  PostgreSQL · installed
redis       Redis · installed
sqlite      SQLite · installed
mongodb     MongoDB · installed

Database driver selected: sqlite

Database driver selected: mysql

Unknown database driver: oracle

Status  connected
File    sandbox/db/shop.sqlite
SQLite  (version depends on the host)

Status  connected
File    sandbox/db/shop.sqlite
SQLite  (version depends on the host)

name	type
orders	table
products	table

cid	name	type	notnull	dflt_value	pk
0	id	INTEGER	0	NULL	1
1	sku	TEXT	1	NULL	0
2	name	TEXT	1	NULL	0
3	category	TEXT	1	NULL	0
4	price	REAL	1	NULL	0
5	active	INTEGER	1	1	0

id	sku	name	category	price	active
1	SHOE-1	City shoe	shoes	79.9	1
2	SHOE-2	Trail shoe	shoes	109.0	1

id	sku	name	category	price	active
1	SHOE-1	City shoe	shoes	79.9	1
2	SHOE-2	Trail shoe	shoes	109.0	1

seq	name	file
0	main	sandbox/db/shop.sqlite

total
4
Time  (varies) ms

[
  {
    "id": 1,
    "sku": "SHOE-1",
    "name": "City shoe",
    "category": "shoes",
    "price": 79.9,
    "active": 1
  },
  {
    "id": 2,
    "sku": "SHOE-2",
    "name": "Trail shoe",
    "category": "shoes",
    "price": 109.0,
    "active": 1
  },
  {
    "id": 3,
    "sku": "BAG-1",
    "name": "Canvas bag",
    "category": "bags",
    "price": 44.5,
    "active": 1
  },
  {
    "id": 4,
    "sku": "HAT-1",
    "name": "Summer hat",
    "category": "accessories",
    "price": 25.0,
    "active": 0
  }
]

Inserted  1
ID        5

Updated  1

Deleted  1

Saved  demo

No saved connections

Saved connection not found: absent

Saved connection not found: absent

+

Saved  sandbox/tmp/sample-db.sql

SQLite error: table products already exists

CREATE TABLE products (
  id INTEGER PRIMARY KEY,
  sku TEXT UNIQUE NOT NULL,
  name TEXT NOT NULL,
  category TEXT NOT NULL,
  price REAL NOT NULL,
  active INTEGER NOT NULL DEFAULT 1
);
INSERT INTO products (sku,name,category,price,active) VALUES
('SHOE-1','City shoe','shoes',79.90,1),
('SHOE-2','Trail shoe','shoes',109.00,1),
('BAG-1','Canvas bag','bags',44.50,1);

Связанная документация