Класс A_DB

Класс реализует основные функции для работы с БД MySQL. Подробнее...

Открытые члены

__Delete ($table, $where="")
Удаление записей из таблицы БД.
__execute ($sql)
Выполнение SQL запроса.
__Insert ($table, $data)
Добавление новой записи в таблицу БД.
__Replace ($table, $data, $where="", $params=array())
Обновление записей в таблице БД, если обновлять нечего - добавляется новая запись.
__Update ($table, $data, $where="")
Обновление записей в таблице БД.
_Delete ($table, $where="")
Удаление записей из таблицы БД.
_execute ($sql, $table='')
Выполнение SQL запроса.
_existsRow ($sql)
Проверка на существование записи.
_getAll ($sql)
Возвращает массив всех записей по результату SQL запроса.
_getAssoc ($sql)
Возвращает асоциированный массив, ключом в котором является значение первого поля в записях по результату SQL запроса.
_getCol ($sql)
Возвращает массив, элементами в которого являются значения первого поля в записях по результату SQL запроса.
_getCount ($table, $where='')
Возвращает количество найденных записей по результату SQL запроса.
_getOne ($sql)
Возвращает значение первого поля в первой записи по результату SQL запроса.
_getRow ($sql)
Возвращает первую запись по результату SQL запроса.
_getRowById ($id, $table)
Извлекает запись из таблицы БД по значению id.
_Insert ($table, $data)
Добавление новой записи в таблицу БД.
_query ($sql)
Выполняет SQL запрос и сохраняет результат в стеке для последующего извлечения с помощью fetchRow().
_queryLimit ($sql, $b, $c)
Выполняет SQL запрос с заданным лимитом выборки и сохраняет результат в стеке для последующего извлечения с помощью fetchRow().
_Replace ($table, $data, $where="", $params=array())
Обновление записей в таблице БД, если обновлять нечего - добавляется новая запись.
_Update ($table, $data, $where="")
Обновление записей в таблице БД.
affectedRows ()
Возвращает количество записей, к которым был применен последний запрос.
connect ($domain='')
Подключение к БД.
Delete ($table, $where="", $params=array())
Удаление записей из таблицы БД.
execSQL ($sql, $domain='')
Выполняет последовательность SQL запросов.
execSQLFile ($file, $domain='')
Выполняет последовательность SQL запросов из файла.
execute ($sql, $params=array(), $table='')
Выполнение SQL запроса.
existsRow ($sql, $params=array())
Проверка на существование записи.
fetchRow ()
Извлечение очередной записи из последнего результата в стеке.
free ()
Удаление последнего результата из стека.
getAll ($sql, $params=array())
Возвращает массив всех записей по результату SQL запроса.
getAssoc ($sql, $params=array())
Возвращает асоциированный массив, ключом в котором является значение первого поля в записях по результату SQL запроса.
getCol ($sql, $params=array())
Возвращает массив, элементами в которого являются значения первого поля в записях по результату SQL запроса.
getCount ($table, $where='', $params=array())
Возвращает количество найденных записей по результату SQL запроса.
getFields ($table)
Возвращает список полей в таблице БД.
getIndex ($table)
Возвращает список индексов в таблице БД.
getInstance ()
Возвращает объект для работы с БД.
getOne ($sql, $params=array())
Возвращает значение первого поля в первой записи по результату SQL запроса.
getRow ($sql, $params=array())
Возвращает первую запись по результату SQL запроса.
getRowById ($id, $table)
Извлекает запись из таблицы БД по значению id.
getTables ($domain='')
Возвращает список таблиц БД принадлежащих сайту.
getUseTables ($sql)
Определение всех таблиц БД участвующих в запросе.
Insert ($table, $data)
Добавление новой записи в таблицу БД.
makeSQL ($pattern, $params)
Формирование SQL запроса.
numRows ()
Количество записей у последнего результата в стеке.
query ($sql, $params=array())
Выполняет SQL запрос и сохраняет результат в стеке для последующего извлечения с помощью fetchRow().
queryLimit ($sql, $b, $c, $params=array())
Выполняет SQL запрос с заданным лимитом выборки и сохраняет результат в стеке для последующего извлечения с помощью fetchRow().
Replace ($table, $data, $where="", $params=array())
Обновление записей в таблице БД, если обновлять нечего - добавляется новая запись.
Update ($table, $data, $where="", $params=array())
Обновление записей в таблице БД.

Открытые атрибуты

$cache
Объект кэширования БД.
$caching
Флаг состояния кэширования (true/false).
$ccounter
Количество подключений к БД.
$qcounter
Количество запросов к БД.
$results
Стек всех результатов запросов.

Подробное описание

Класс реализует основные функции для работы с БД MySQL.

Содержит встроенную интеграцию с системой кэширования. Автоматически поддерживает работу с дополнительными базами данных. Поддерживаются параметризированные запросы.

Методы

__Delete	(	$	table,
		$	where = `""`
	)

Удаление записей из таблицы БД.

Не поддерживает параметры и работает в обход систем кэширования и дополнительных БД.

Аргументы:

	string	$table Таблица БД.
	array	$where Условие в SQL запросе.
	array	$params=array() Параметры запроса.

Возвращает:: integer Количество удаленных записей.

__execute ( $ sql )

Выполнение SQL запроса.

Не поддерживает параметры, а так же работает в обход системы кэширования и дополнительных БД.

Аргументы:

string

$sql Строка запроса.

Возвращает:: mixed true/false или MySQLi_RESULT

__Insert	(	$	table,
		$	data
	)

Добавление новой записи в таблицу БД.

Работает в обход системы кэширования и системы дополнительных БД.

Аргументы:

	string	$table Таблица БД.
	array	$data Асоциированный массив со значениями полей.

Возвращает:: integer Уникальный идентификатор новой записи или false в случае неудачи.

__Replace	(	$	table,
		$	data,
		$	where = `""`,
		$	params = `array()`
	)

Обновление записей в таблице БД, если обновлять нечего - добавляется новая запись.

Не поддерживает параметры и работает в обход систем кэширования и дополнительных БД.

Аргументы:

	string	$table Таблица БД.
	array	$data Асоциированный массив со значениями полей.
	array	$where Условие в SQL запросе.
	array	$params=array() Параметры запроса.

Возвращает:: integer Уникальный идентификатор новой записи или 0 в случае обновления.

__Update	(	$	table,
		$	data,
		$	where = `""`
	)

Обновление записей в таблице БД.

Не поддерживает параметры и работает в обход систем кэширования и дополнительных БД.

Аргументы:

	string	$table Таблица БД.
	array	$data Асоциированный массив со значениями полей.
	array	$where Условие в SQL запросе.
	array	$params=array() Параметры запроса.

Возвращает:: integer Количество измененных записей.

_Delete	(	$	table,
		$	where = `""`
	)

Удаление записей из таблицы БД.

Не поддерживает параметры и работает в обход системы кэширования.

Аргументы:

	string	$table Таблица БД.
	array	$where Условие в SQL запросе.
	array	$params=array() Параметры запроса.

Возвращает:: integer Количество удаленных записей.

_execute	(	$	sql,
		$	table = `''`
	)

Выполнение SQL запроса.

Не поддерживает параметры и работает в обход системы кэширования.

Аргументы:

	string	$sql Строка запроса.
	string	table='' Таблица БД (для запросов на изменение).

Возвращает:: true/false или MySQLi_RESULT

_existsRow ( $ sql )

Проверка на существование записи.

Не поддерживает параметры и работает в обход системы кэширования.

Аргументы:

string

$sql Строка SQL запроса

Возвращает:: boolean true если хоть одна запись существует.

_getAll ( $ sql )

Возвращает массив всех записей по результату SQL запроса.

Не поддерживает параметры и работает в обход системы кэширования.

Аргументы:

	string	$sql Строка SQL запроса
	array	$params=array() Параметры запроса.

Возвращает:: array Массив записей, каждая из которых - асоциированный массив значений полей.

_getAssoc ( $ sql )

Возвращает асоциированный массив, ключом в котором является значение первого поля в записях по результату SQL запроса.

Если в записях только два поля, то второе является значением элемента массива, если больше, то значением элемента становится массив из оставшихся полей. Не поддерживает параметры и работает в обход системы кэширования.

Аргументы:

string

$sql Строка SQL запроса

Возвращает:: array Ассоциированный массив.

_getCol ( $ sql )

Возвращает массив, элементами в которого являются значения первого поля в записях по результату SQL запроса.

Не поддерживает параметры и работает в обход системы кэширования.

Аргументы:

	string	$sql Строка SQL запроса
	array	$params=array() Параметры запроса.

Возвращает:: array Ассоциированный массив.

_getCount	(	$	table,
		$	where = `''`
	)

Возвращает количество найденных записей по результату SQL запроса.

Не поддерживает параметры и работает в обход системы кэширования.

Аргументы:

	string	$table Таблица БД.
	string	$where Условие выборки.
	array	$params=array() Параметры запроса.

Возвращает:: integer Количество найденных записей.

_getOne ( $ sql )

Возвращает значение первого поля в первой записи по результату SQL запроса.

Работает в обход системы кэширования.

Аргументы:

string

$sql Строка SQL запроса*

Возвращает:: mixed Значение.

_getRow ( $ sql )

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

Не поддерживает параметры и работает в обход системы кэширования.

Аргументы:

string

$sql Строка SQL запроса

Возвращает:: array() Ассоцированный массив с данными записи.

_getRowById	(	$	id,
		$	table
	)

Извлекает запись из таблицы БД по значению id.

Работает в обход системы кэширования.

Аргументы:

	integer	$id Уникальный идентификатор записи в таблице.
	string	$table Таблица БД.

Возвращает:: array() Ассоцированный массив с данными записи.

_Insert	(	$	table,
		$	data
	)

Добавление новой записи в таблицу БД.

Работает в обход системы кэширования.

Аргументы:

	string	$table Таблица БД.
	array	$data Асоциированный массив со значениями полей.

Возвращает:: integer Уникальный идентификатор новой записи или false в случае неудачи.

_query ( $ sql )

Выполняет SQL запрос и сохраняет результат в стеке для последующего извлечения с помощью fetchRow().

Не поддерживает параметры и работает в обход системы кэширования.

Аргументы:

	string	$sql Строка SQL запроса
	array	$params=array() Параметры запроса.

Возвращает:: integer Количество записей в результате.

_queryLimit	(	$	sql,
		$	b,
		$	c
	)

Выполняет SQL запрос с заданным лимитом выборки и сохраняет результат в стеке для последующего извлечения с помощью fetchRow().

Не поддерживает параметры и работает в обход системы кэширования.

Аргументы:

	string	$sql Строка SQL запроса
	integer	$b Номер первой записи в выборке.
	integer	$c Количество записей.
	array	$params=array() Параметры запроса.

Возвращает:: integer Общее количество найденных записей.

_Replace	(	$	table,
		$	data,
		$	where = `""`,
		$	params = `array()`
	)

Обновление записей в таблице БД, если обновлять нечего - добавляется новая запись.

Не поддерживает параметры и работает в обход системы кэширования.

Аргументы:

	string	$table Таблица БД.
	array	$data Асоциированный массив со значениями полей.
	array	$where Условие в SQL запросе.
	array	$params=array() Параметры запроса.

Возвращает:: integer Уникальный идентификатор новой записи или 0 в случае обновления.

_Update	(	$	table,
		$	data,
		$	where = `""`
	)

Обновление записей в таблице БД.

Не поддерживает параметры и работает в обход системы кэширования.

Аргументы:

	string	$table Таблица БД.
	array	$data Асоциированный массив со значениями полей.
	array	$where Условие в SQL запросе.
	array	$params=array() Параметры запроса.

Возвращает:: integer Количество измененных записей.

affectedRows ( )

Возвращает количество записей, к которым был применен последний запрос.

Возвращает:: integer Количество записей, к которым был применен последний запрос.

connect ( $ domain = '' )

Подключение к БД.

Аргументы:

string

Идентификатор сайта.

Delete	(	$	table,
		$	where = `""`,
		$	params = `array()`
	)

Удаление записей из таблицы БД.

Аргументы:

	string	$table Таблица БД.
	array	$where Условие в SQL запросе.
	array	$params=array() Параметры запроса.

Возвращает:: integer Количество удаленных записей.

execSQL	(	$	sql,
		$	domain = `''`
	)

Выполняет последовательность SQL запросов.

Работает в обход системы кэширования.

Аргументы:

	string	$sql Текст SQL скрипта.
	string	$domain Идентификатор сайта, если не указано то текущий.

execSQLFile	(	$	file,
		$	domain = `''`
	)

Выполняет последовательность SQL запросов из файла.

Работает в обход системы кэширования.

Аргументы:

	string	$file Файл содержащий SQL скрипт.
	string	$domain Идентификатор сайта, если не указано то текущий.

execute	(	$	sql,
		$	params = `array()`,
		$	table = `''`
	)

Выполнение SQL запроса.

Аргументы:

	string	$sql Строка запроса.
	array	$params=array() Параметры запроса.
	string	table='' Таблица БД (для запросов на изменение).

Возвращает:: true/false или MySQLi_RESULT

existsRow	(	$	sql,
		$	params = `array()`
	)

Проверка на существование записи.

Аргументы:

	string	$sql Строка SQL запроса
	array	$params=array() Параметры запроса.

Возвращает:: boolean true если хоть одна запись существует.

fetchRow ( )

Извлечение очередной записи из последнего результата в стеке.

Возвращает:: array Ассоциированный массив или false.

free ( )

Удаление последнего результата из стека.

getAll	(	$	sql,
		$	params = `array()`
	)

Возвращает массив всех записей по результату SQL запроса.

Аргументы:

	string	$sql Строка SQL запроса
	array	$params=array() Параметры запроса.

Возвращает:: array Массив записей, каждая из которых - асоциированный массив значений полей.

getAssoc	(	$	sql,
		$	params = `array()`
	)

Возвращает асоциированный массив, ключом в котором является значение первого поля в записях по результату SQL запроса.

Если в записях только два поля, то второе является значением элемента массива, если больше, то значением элемента становится массив из оставшихся полей.

Аргументы:

	string	$sql Строка SQL запроса
	array	$params=array() Параметры запроса.

Возвращает:: array Ассоциированный массив.

getCol	(	$	sql,
		$	params = `array()`
	)

Возвращает массив, элементами в которого являются значения первого поля в записях по результату SQL запроса.

Аргументы:

	string	$sql Строка SQL запроса
	array	$params=array() Параметры запроса.

Возвращает:: array Ассоциированный массив.

getCount	(	$	table,
		$	where = `''`,
		$	params = `array()`
	)

Возвращает количество найденных записей по результату SQL запроса.

Аргументы:

	string	$table Таблица БД.
	string	$where Условие выборки.
	array	$params=array() Параметры запроса.

Возвращает:: integer Количество найденных записей.

getFields ( $ table )

Возвращает список полей в таблице БД.

Аргументы:

string

$table Таблица БД.

Возвращает:: array Список список полей в заданной таблице.

getIndex ( $ table )

Возвращает список индексов в таблице БД.

Аргументы:

string

$table Таблица БД.

Возвращает:: array Список индексов в заданной таблице.

getInstance ( )

Возвращает объект для работы с БД.

Возвращает:: object Объект для работы с БД.

getOne	(	$	sql,
		$	params = `array()`
	)

Возвращает значение первого поля в первой записи по результату SQL запроса.

Аргументы:

	string	$sql Строка SQL запроса
	array	$params=array() Параметры запроса.

Возвращает:: mixed Значение.

getRow	(	$	sql,
		$	params = `array()`
	)

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

Аргументы:

	string	$sql Строка SQL запроса
	array	$params=array() Параметры запроса.

Возвращает:: array() Ассоцированный массив с данными записи.

getRowById	(	$	id,
		$	table
	)

Извлекает запись из таблицы БД по значению id.

Аргументы:

	integer	$id Уникальный идентификатор записи в таблице.
	string	$table Таблица БД.

Возвращает:: array() Ассоцированный массив с данными записи.

getTables ( $ domain = '' )

Возвращает список таблиц БД принадлежащих сайту.

Аргументы:

string

$domain='' Идентификатор сайта, если не указано то текущий.

Возвращает:: array Список таблиц БД принадлежащих сайту.

getUseTables ( $ sql )

Определение всех таблиц БД участвующих в запросе.

Аргументы:

string

$sql Строка SQL запроса

Возвращает:: array Список таблиц.

Insert	(	$	table,
		$	data
	)

Добавление новой записи в таблицу БД.

Аргументы:

	string	$table Таблица БД.
	array	$data Асоциированный массив со значениями полей.

Возвращает:: integer Уникальный идентификатор новой записи или false в случае неудачи.

makeSQL	(	$	pattern,
		$	params
	)

Формирование SQL запроса.

Аргументы:

	string	$pattern Шаблон запроса.
	array	$params Параметры запроса.

Возвращает:: string строка SQL запроса.

numRows ( )

Количество записей у последнего результата в стеке.

Возвращает:: array Ассоциированный массив.

query	(	$	sql,
		$	params = `array()`
	)

Выполняет SQL запрос и сохраняет результат в стеке для последующего извлечения с помощью fetchRow().

Аргументы:

	string	$sql Строка SQL запроса
	array	$params=array() Параметры запроса.

Возвращает:: integer Количество записей в результате.

queryLimit	(	$	sql,
		$	b,
		$	c,
		$	params = `array()`
	)

Выполняет SQL запрос с заданным лимитом выборки и сохраняет результат в стеке для последующего извлечения с помощью fetchRow().

Аргументы:

	string	$sql Строка SQL запроса
	integer	$b Номер первой записи в выборке.
	integer	$c Количество записей.
	array	$params=array() Параметры запроса.

Возвращает:: integer Общее количество найденных записей.

Replace	(	$	table,
		$	data,
		$	where = `""`,
		$	params = `array()`
	)

Обновление записей в таблице БД, если обновлять нечего - добавляется новая запись.

Аргументы:

	string	$table Таблица БД.
	array	$data Асоциированный массив со значениями полей.
	array	$where Условие в SQL запросе.
	array	$params=array() Параметры запроса.

Возвращает:: integer Уникальный идентификатор новой записи или 0 в случае обновления.

Update	(	$	table,
		$	data,
		$	where = `""`,
		$	params = `array()`
	)

Обновление записей в таблице БД.

Аргументы:

	string	$table Таблица БД.
	array	$data Асоциированный массив со значениями полей.
	array	$where Условие в SQL запросе.
	array	$params=array() Параметры запроса.

Возвращает:: integer Количество измененных записей.

Данные класса

$cache

Объект кэширования БД.

$caching

Флаг состояния кэширования (true/false).

$ccounter

Количество подключений к БД.

$qcounter

Количество запросов к БД.

$results

Стек всех результатов запросов.

Объявления и описания членов класса находятся в файле:

system/framework/db.php