Создание плагина 2 часть

В этой части разберем содержимое файла includes\functions\database.php участвующее при создании собственного плагина.

Этот файл реализует базовые и расширенные функции для взаимодействия с базой данных в системе Spruton Studio . Вот основные моменты:

Функция	Описание
`db_connect()`	Устанавливает соединение с БД, настраивает кодировку и параметры подключения
`db_close()`	Закрывает соединение
`db_query()`	Выполняет SQL-запрос, логирует ошибки и время выполнения
`db_fetch_array()`	Возвращает результат запроса в виде ассоциативного массива
`db_fetch()`	Возвращает результат в виде объекта
`db_perform()`	Универсальная функция для INSERT и UPDATE
`db_insert_id()`	Возвращает ID последней вставленной записи
`db_input()`/`db_prepare_input()`	Экранируют данные от SQL-инъекций и очищают входящие значения
`db_count()`,`db_find()`,`db_delete_row()`	Удобные методы для частых операций

Используется utf8mb4 , что поддерживает полноценную работу с Unicode (включая эмодзи).
Все SQL-запросы оборачиваются в try/catch для обработки исключений.
Есть логирование медленных/тяжёлых запросов.
Есть защита от SQL-инъекций через mysqli_real_escape_string.
Используется HTML Purifier при обработке HTML-контента (db_prepare_html_input()).

Пример использования функций

db_connect();

$result = db_query(«SELECT * FROM app_entity_1 WHERE id=’123′»);
$row = db_fetch_array($result);
echo $row[‘name’];

$data = array(
‘name’ => db_input(‘Новое имя’),
‘created_at’ => ‘now()’
);
db_perform(‘app_entity_1’, $data, ‘insert’);

$data = array(
‘name’ => db_input(‘Обновлённое имя’)
);
db_perform(‘app_entity_1’, $data, ‘update’, «id=’123′»);

$user_info = db_find(‘app_entity_1’, 123);
echo $user_info[‘name’];