db

Обзор

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

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

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

Синтаксис

db [driver] [options]

Справочник

Выбор драйвера

Выбор хранится только в текущей PHP-сессии. db mariadb выбирает mysql, потому что один драйвер намеренно обслуживает и MySQL, и MariaDB. db не устанавливает отсутствующий драйвер незаметно: используйте @mysql или install mysql.

Единый принцип

Где модель БД позволяет, драйверы используют одинаковые операции: -c подключает, -use выбирает базу или файл, -l показывает базы/пространства, -t — таблицы/коллекции/ключи, -s — структуру, -n — данные, -f — поиск, -o — выгрузку, dump/load — резервные копии, -e — отключение. После : всегда идёт нативный язык выбранной БД.

Безопасность

Пароли вводятся через скрытое поле и не попадают в историю команд. Запись выполняется с правами подключённого пользователя БД; для повседневной работы предпочтительны ограниченные учётные записи.

Общее зеркало также передаёт -a, -w и -d для точечного добавления, изменения и удаления данных; точные аргументы остаются специфичными для выбранного драйвера.

Сохранённые подключения

Без -m данные подключения остаются только в текущей PHP-сессии. -m [name] явно сохраняет профиль в защищённом файле .lil.key (0600), -K <name> подключается через него повторно, -k показывает список или сведения о профиле без вывода сохранённого пароля, а -M <name> удаляет профиль. kill удаляет .lil.key вместе с остальным состоянием ядра. Относитесь к файлу как к чувствительному: добровольно сохранённый профиль может содержать доступы к базе данных.

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

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

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

Примеры

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

Driver      sqlite
Status      selected

Status      connected
File        sandbox/db/shop.sqlite

products
orders

id	sku	name	category	price	active
1	SHOE-1	City shoe	shoes	79.9	1
2	SHOE-2	Trail shoe	shoes	109	1
3	BAG-1	Canvas bag	bags	44.5	1

Driver      sqlite
SQLite      installed · selected
MySQL       installed
PostgreSQL  not installed
Redis       not installed
MongoDB     not installed

Driver  mysql
Status  selected
Engine  MySQL / MariaDB

Driver  mysql
Status  selected
Engine  MySQL / MariaDB

Field     Type       Null  Key
id        INTEGER    no    PRIMARY
sku       TEXT       no    UNIQUE
name      TEXT       no
category  TEXT       no
price     REAL       no
active    INTEGER    no

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

Saved  products.json

Inserted  1
ID        5

Updated  1

Deleted  1

products
4

Saved  backup.sql

+

Неизвестный драйвер базы данных: oracle

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);

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