rusadrako/driver_db

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

2.0.0 2023-12-21 09:33 UTC

This package is not auto-updated.

Last update: 2024-10-02 13:15:12 UTC


README

Version Total Downloads License

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

Установка (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

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

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

/**
 * 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) { ... }