/includes/functions/database.php

Модуль содержит в себе ряд функций, обеспечивающих корректную работу с базой данных на основе MySQL.

function tep_db_connect($server = DB_SERVER, $username = DB_SERVER_USERNAME, $password = DB_SERVER_PASSWORD, $database =DB_DATABASE, $link = 'db_link', $use_pconnect = USE_PCONNECT, $new_link = false);
Функция предназначена для осуществления подключения к базе данных, заданной $database располагающейся на сервере $server с использованием имени пользователя $username и пароля $password. По умолчанию эти параметры определены в файле конфигурации магазина. Кроме того в йункцию передаются еще несколько параметров: $link - имя для глобальной переменной соединения и $new_link -создавать ли новое соединение, или использовать уже имеющееся. С помощью этих переменных можно создавать несколько независимых соединений к одной и той же базе данных. Так же существует еще один параметр:$use_pconnect  - если он равен true - то создается соединение с базой данной не сиссионное - а постоянное. Такое соединение полезно при большом количестве производимых запросов - но в этом случае обязательно необходимо производить отключение сессии вручную.
function tep_db_close($link = 'db_link');
Функция закрывает соединение с базой данных для определенного линка. По-умолчанию это db_link.
function tep_db_error($query, $errno, $error);
Функция возвращает сформатированное сообщение об ошибке, произошедшей прни работе с базой данных.
function tep_db_query($query, $link = 'db_link');
Функция возвращает ресурс - как результат выполнения запроса $query. При этом изменяет счетчики количества запросов и времени выполнения SQL запросов. Возвращенный результат можно использовать в дальнейшем для получения результата в виде массива или ассоциативного массива.
function tep_db_perform($table, $data, $action = 'insert', $parameters = '', $link = 'db_link');
Функция на основе переданных данных формирует SQL запрос типа insert или update на основе $action  и его выполнение. Возвращает ресурс базы данных для дальнейшей обработки. Для формирования запроса передается имя таблицы $table, а так же ассоциативный массив типа "колонка=> значение". Для запроса типа update через  $parameters передается условие обновления данных. Например: tep_db_perform('user',Array('name'=>'1','pass'=>'password','update','id=10')); сформирует запрос вида: update user set name='1',pass='password' where id=10.
function tep_db_fetch_array($db_query);
Функция возвращает результат запроса в виде ассоциативного массива.$db_query - результат, возвращенный функцией tep_db_query.
function tep_db_num_rows($db_query);
Функция возвращает количество строк в полученном результате запроса.$db_query - результат, возвращенный функцией tep_db_query.
function tep_db_data_seek($db_query, $row_number);
Функция позволяет переместиться на указанную в $row_number строку результата.$db_query - результат, возвращенный функцией tep_db_query.
function tep_db_insert_id($link = 'db_link');
Фунция возвращает идентификатор для последней записи вставки.
function tep_db_free_result($db_query);
Функция очищает память, занятую результатом выполнения запроса
function tep_db_fetch_fields($db_query);
Функция возвращает информацию о поле из запроса. При этом сначала выбирается информация о первом поле, а при дальнейшем вызове функции выводится информация о последующих полях. Подробнее о функции можно посмотреть в справочнике по PHP, описывающем функцию mysql_fetch_field
function tep_db_output($string);
Функция возвращает "безопасное" с точки зрения HTML представление строки $string.
function tep_db_input($string, $link = 'db_link');
Функция подготавливает запрос $string к выполнению: очищает от ненужного или опасного контента, добавляет спец-символы.
function tep_db_prepare_input($string);
Аналогично предыдущей функции, но в отличие от нее может принимать в качестве параметра несколько запросов. При этом в исходном массиве $string корректировке подлежат значения ключей.