rusadrako/driver_db

Библиотека подключения к различным БД

2.0.1 2025-02-17 11:37 UTC

Requires

• php: >=7.0.0

MIT

• Petukhov Leonid

README

Адаптер для работы с подключениями к различным БД.

Установка (composer)

composer require 'rusadrako/driver_db'

Установка (manual)

• Скачать и распоковать библиотеку.
• Добавить в код инструкцию:

require_once('/driver_db/src/autoload.php')

Пример выполнения запроса

use RusaDrako\driver_db\DB;
$db = new DB();
// Настройки подключения к БД
$db_set = [
	'DRIVER' => DB::DRV_MYSQLI,
	'HOST' => 'localhost',
	'USER' => 'root',
	'PASS' => '',
	'DBNAME' => 'test',
];
// Установка настроек подключения
$db->setDB('db_name', $db_set);
// Активация подключения
/** @var RusaDrako\driver_db\drivers\_abs_driver $db_connect */
$db_connect = $db->getDBConnect('db_name');
// Выполнение запроса
/** @var array $result */
$result = $db_connect->select('SELECT @@version');
var_dump($result);

Поддерживаемые библиотеки

use RusaDrako\driver_db\DB;

DB::DRV_MYSQL;       // mysql
DB::DRV_MYSQLI;      // mysqli
DB::DRV_MYSQL_PDO;   // PDO:mysql
DB::DRV_SQLITE3;     // SQLite3
DB::DRV_SQLITE3_PDO; // PDO:sqlite
DB::DRV_SQLSRV;      // sqlsrv
DB::DRV_SQLSRV_PDO;  // PDO:sqlsrv
DB::DRV_PG_PDO;      // PDO:pgsql

Матрица настроек подключений

Поле	Описание	По умолчанию	mysql	mysqli	PDO:mysql	SQLite3	PDO:sqlite	sqlsrv	PDO:sqlsrv	PDO:pgsql
DRIVER	Драйвер	DB::DRV_MYSQLI	DB::DRV_MYSQL	DB::DRV_MYSQLI	DB::DRV_MYSQL_PDO	DB::DRV_SQLITE3	DB::DRV_SQLITE3_PDO	DB::DRV_SQLSRV	DB::DRV_SQLSRV_PDO	DB::DRV_PG_PDO
HOST	Сервер	localhost	+	+	+	+	+	+	+	+
PORT	Порт	NULL	+	+	+			+	+	+
USER	Пользователь	root	+	+	+			+	+	+
PASS	Пароль	NULL	+	+	+			+	+	+
DBNAME	Имя БД	NULL	+	+	+			+	+	+
ENCODING	Кодировка	utf8	+	+	+
ENCODING_SYS	Кодировка Системы	UTF-8						+	+
ENCODING_DB	Кодировка БД	CP1251						+

Методы запросов

/**
 * Cоздаёт строку в таблице с заданными переменными.
 * @param string $table_name Имя таблицы.
 * @param array $arr_insert Массив с переменными для добавления.
 * @param array $arr_where Условие добавления строки.
 * @return array Ответ БД: ID номер новой строки или false.
 */
public function insert($table_name, $arr_insert, $arr_where = []) { ... }

/**
 * Возвращает ID последней вставленной строки или значение последовательности
 */
public function insert_id() { ... }

/**
 * Функция возвращает возвращает результат запроса в БД.
 * @param string $query Строка запроса.
 * @param bool $return_error Маркер возврата сообщения об ошибке.
 * @return array Ответ БД.
 */
public function query($query) { ... }

/**
 * Возвращает массив результата запроса select (массив полей ID) или false.
 * @param string $query Строка запроса.
 * @param bool $assoc Возвращать ассоциотивный массив полей
 * @return array Ответ БД (массив данных).
 */
public function select($query, $assoc = true) { ... }

/**
 * Обновляет строку в таблице масивом переменных по условию.
 * @param string $table_name Имя таблицы.
 * @param array $arr_update Массив с переменными для обновления.
 * @param array $arr_where Условие обработки строк.
 * @return bool Ответ БД: true или false.
 */
public function update($table_name, $arr_update, $arr_where) { ... }

/**
 * Удаляет строку из таблицы по условию.
 * @param string $table_name Имя таблицы.
 * @param array $arr_where Условие обработки строк.
 * @return bool Ответ БД: true - выполнено; false - не выполнено.
 */
public function delete($table_name, $arr_where) { ... }