Класс работы с базой данных.
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",
);
public function e(string $sql)
return String
Экранирует строку $sql функцией real_escape_string()
Возвращает заэкранированную строку.
public function clean_param()
return null
Очищает все параметры, оставшиеся от предыдущего запроса.
public function set_charset(string $charset = "utf8")
return null
Устанавливает кодировку $charset
для соединения с БД.
public function query(string $sql, boolean $clean = true)
return boolean
Выполняет запрос $sql к базе данных.
Аргумент $clean указывает, очищать (true по умолчанию) или нет (false) параметры запроса.
Возвращает true в случае успешного выполнения и false в случае ошибки или отсутствия результата.
public function getData()
return mixed
Возвращает результат предыдущего запроса.
public function count(string $table, string $pref = "")
return integer
Получение количества записей в таблице $table при текущих параметрах выборки.
Необязательный агрумент $pref служит для добавления синонима в запрос к таблице $table.
Пример:
SELECT COUNT(*) FROM `{$table}` {$pref} WHERE 1
Возвращает количество записей в таблице, удовлетворяющих запрос.
public function dump()
return string
Создаёт и возвращает sql dump базы данных
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(таблица => параметры).
public function insert_id()
return integer
Возвращает id последней добавленной в базу записи.
public function where(mixed $where, string $type = "AND")
return object
Устанавливает условия WHERE для sql-запроса.
$where - может быть строкой зароса ("`id` = 1") либо массивом (array("id" => 1))
$type - указывает условие для объединения условий, переданных в $where, если передан массив, либо объединение текущей строки условий с предыдущими условиями
Возвращает объект текущего класса.
public function select(string $select)
return object
Устанавливает выбираемые поля из SQL-запроса.
Возвращает объект текущего класса.
public function limit(integer $start, integer $rows = null)
return object
Устанавливает лимит выбираемых строк из базы.
$start - сколько отсупить строк
$rows - сколько нужно выбрать строк
Возвращает объект текущего класса.
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 - псевдоним таблицы
Возвращает объект текущего класса.
public function order_by(string $param, boolean $DESC = false)
return object
Устанавливает параметр ORDER BY для sql-запроса.
$param - поле для сортировки
$DESC - сортировать в обратном порядке
Возвращает объект текущего класса.
public function get(string $table, string $pref = "", boolean $one = false, boolean $clean = true)
return mixed
Метод для выборки данных из таблицы.
$table - таблица для выборки
$pref - псевдоним таблицы
$one - выбрать только первую запись из результата
$clean - очистить параметры запроса после выполнения
Возвращает результат запроса в виде ассоциативного массива, либо false в случае ошибки.
public function delete(string $table, mixed $where = array())
return boolean
Удаляет данные из таблицы.
$table - таблица, из которой удалять данные
$where - условия для удаления
Возвращает результат запроса.
public function update(string $table, array $items, mixed $where=array())
return boolean
Обновляет данные в таблице.
$table - таблица, данные которой будут обновлены
$items - массив обновляемых параметров вида "параметр" => "значение"
$where - условия для обновления
Возвращает рузельтат выполнения запроса.
public function insert(string $table, array $insert)
return boolean
Добавляет данные в таблицу.
$table - таблица, в которую будут добавлены данные
$insert - массив добавляемых значений вида "поле" => "значение"
Возвращает результат выполнения запроса.
public function exists(string $table)
return boolean
Метод проверяет существование таблицы $table.
public function exists_field(string $table, string $field)
return boolean
Метод проверяет существование поля $field в таблице $table.
public function exists_val(string $table, string $field, string $val)
return boolean
Метод проверяет существование значения $val у поля $field в таблице $table.
public function free_result()
Освобождает память от результата запроса.