База данных (db.class)

Класс работы с базой данных.

Вызов

 SYS()->library("db");

Обращение

 db(); // Или SYS()->db;

Переменные

 public $sql = array(); // Вызов db()->sql;

Содержит в себе историю запросов к базе данных. 

Пример:

 $sql = array(
	0 => "Select * FROM `table1` WHERE 1",
	1 => "INSERT INTO `table2` SET (name, val) VALUES (name, test)",
	2 => "Select * FROM `table2` WHERE 1",
);

Методы

e

 public function e(string $sql) 
return String

Экранирует строку $sql функцией real_escape_string()

Возвращает заэкранированную строку.

clean_param

 public function clean_param() 
return null

Очищает все параметры, оставшиеся от предыдущего запроса.

set_charset

 public function set_charset(string $charset = "utf8") 
return null

Устанавливает кодировку $charset для соединения с БД.

query

 public function query(string $sql, boolean $clean = true) 
return boolean

Выполняет запрос $sql к базе данных.

Аргумент $clean указывает, очищать (true по умолчанию) или нет (false) параметры запроса.

Возвращает true в случае успешного выполнения и false в случае ошибки или отсутствия результата.

getData

 public function getData()
return mixed

Возвращает результат предыдущего запроса.

count

 public function count(string $table, string $pref = "") 
return integer

Получение количества записей в таблице $table при текущих параметрах выборки.

Необязательный агрумент $pref служит для добавления синонима в запрос к таблице $table.

Пример:

 SELECT COUNT(*) FROM `{$table}` {$pref} WHERE 1

Возвращает количество записей в таблице, удовлетворяющих запрос.

dump

 public function dump() 
return string

Создаёт и возвращает sql dump базы данных

install

public function install(mixed $table, array $param = null)
return boolean

Функция проверяет целостность таблицы $table по заданным параметрам $param.

Параметры полей:
`type` - int, bool, text, по умолчанию: varchar
`null` - по умолчанию: false (not null)
`ai` - auto_increment
 `default` - значение по умолчанию

Пример:

SYS()->db->install("table", array(
	"id" => array(
		"type" => "int",
		"ai" => true,
	),
	"name" => array(),
	"text" => array(
		"type" => "text",
	),
	"active" => array(
		"type" => "int",
		"default" => 0,
	),
));

Возвращает false, если обновление таблиц не требуется, либо результат выполнения запроса на добавление/удаление полей.

Для проверки нескольких таблиц одновременно в параметр $table можно передать массив вида array(таблица => параметры).

insert_id

public function insert_id()
return integer

Возвращает id последней добавленной в базу записи.

where

public function where(mixed $where, string $type = "AND")
return object

Устанавливает условия WHERE для sql-запроса.

$where - может быть строкой зароса ("`id` = 1") либо массивом (array("id" => 1))

$type - указывает условие для объединения условий, переданных в $where, если передан массив, либо объединение текущей строки условий с предыдущими условиями

Возвращает объект текущего класса.

select

public function select(string $select)
return object

Устанавливает выбираемые поля из SQL-запроса.

Возвращает объект текущего класса.

limit

public function limit(integer $start, integer $rows = null)
return object

Устанавливает лимит выбираемых строк из базы.

$start - сколько отсупить строк

$rows - сколько нужно выбрать строк

Возвращает объект текущего класса.

join

public function join(string $type, string $table, string $on = "", string $pref = "")
return object

Устанавливает параметр join для sql-запроса.

$type - тип запроса join (LEFT JOIN, RIGHT JOIN, INNER JOIN)

$table - присоединяемая таблица

$on - условие для присоединения

$pref - псевдоним таблицы

Возвращает объект текущего класса.

order_by

public function order_by(string $param, boolean $DESC = false)
return object

Устанавливает параметр ORDER BY для sql-запроса.

$param - поле для сортировки

$DESC - сортировать в обратном порядке

Возвращает объект текущего класса.

get

public function get(string $table, string $pref = "", boolean $one = false, boolean $clean = true)
return mixed

Метод для выборки данных из таблицы.

$table - таблица для выборки

$pref - псевдоним таблицы

$one - выбрать только первую запись из результата

$clean - очистить параметры запроса после выполнения

Возвращает результат запроса в виде ассоциативного массива, либо false в случае ошибки.

delete

public function delete(string $table, mixed $where = array())
return boolean

Удаляет данные из таблицы. 

$table - таблица, из которой удалять данные

$where - условия для удаления

Возвращает результат запроса.

update

public function update(string $table, array $items, mixed $where=array())
return boolean

Обновляет данные в таблице.

$table - таблица, данные которой будут обновлены

$items - массив обновляемых параметров вида "параметр" => "значение"

$where - условия для обновления

Возвращает рузельтат выполнения запроса.

insert

public function insert(string $table, array $insert)
return boolean

Добавляет данные в таблицу.

$table - таблица, в которую будут добавлены данные

$insert - массив добавляемых значений вида "поле" => "значение"

Возвращает результат выполнения запроса.

exists

public function exists(string $table)
return boolean

Метод проверяет существование таблицы $table.

exists_field

public function exists_field(string $table, string $field)
return boolean

Метод проверяет существование поля $field в таблице $table.

exists_val

public function exists_val(string $table, string $field, string $val)
return boolean

Метод проверяет существование значения $val у поля $field в таблице $table.

free_result

public function free_result()

Освобождает память от результата запроса.

Политика конфиденциальности