Вставка, обновление и удаление данных с помощью JDatabase.

From Joomla! Documentation

This page is a translated version of the page Inserting, Updating and Removing data using JDatabase and the translation is 100% complete.

Other languages:
English • ‎español • ‎français • ‎Nederlands • ‎русский • ‎中文(台灣)‎
Joomla! 
3.x
Joomla! 
2.5
Примечание о версии

Обратите внимание, что во многих примерах онлайн используется $db->query() вместо $db->execute(). Это был старый метод в Joomla 1.5 и 2.5 и в Joomla 3.0+ он устарел.

Это руководство разделено на две независимые части:

  • Вставка, обновление и удаление данных из базы данных.
  • Выборка данных из одной или нескольких таблиц и извлечение их в различных формах

В этом разделе документации рассматривается вставка, обновление и удаление данных из таблицы базы данных. Чтобы увидеть другую частьнажмите здесь

Введение

Joomla предоставляет сложный уровень абстракции базы данных, чтобы упростить использование для сторонних разработчиков. Новые версии API платформы Joomla предоставляют дополнительные функциональные возможности, которые дополнительно расширяют уровень базы данных, и включают в себя такие функции, как коннекторы для большего разнообразия серверов баз данных и цепочку запросов, чтобы улучшить читаемость кода соединения и упростить кодирование SQL.

Joomla может использовать различные типы систем баз данных SQL и работать в различных средах с разными префиксами таблиц. В дополнение к этим функциям класс автоматически создает соединение с базой данных. Помимо создания объекта вам нужны всего две строки кода, чтобы получить результат из базы данных в различных форматах. Использование уровня базы данных Joomla обеспечивает максимальную совместимость и гибкость для вашего расширения.

Запрос

Запросы к базе данных Joomla изменились с тех пор, как была введена новая платформа Joomla Framework, теперь «цепочка запросов» является рекомендуемым методом для создания запросов к базе данных (хотя строковые запросы все еще поддерживаются).

Цепочка запросов относится к методу, соединяющему несколько методов, один за другим, каждый метод возвращает объект, который может поддерживать следующий метод, улучшая читабельность и упрощая код.

Чтобы получить новый экземпляр класса JDatabaseQuery, мы используем метод getQuery JDatabaseDriver:

$db = JFactory::getDbo();

$query = $db->getQuery(true);

JDatabaseDriver :: getQuery принимает необязательный аргумент $ new, который может иметь значение true или false (по умолчанию используется значение false).

Чтобы запросить наш источник данных, мы можем вызвать несколько методов JDatabaseQuery; эти методы инкапсулируют язык запросов источника данных (в большинстве случаев SQL), скрывая специфический синтаксис запроса от разработчика и увеличивая переносимость исходного кода разработчика.

Некоторые из наиболее часто используемых методов включают в себя; include; select, from, join, where and order. Существуют также такие методы, как вставка, insert, update and delete для изменения записей в хранилище данных. Объединяя эти и другие вызовы методов, вы можете создать практически любой запрос к вашему хранилищу данных без ущерба для переносимости кода.

Вставка записи

С использованием SQL

Класс JDatabaseQuery предоставляет несколько методов для построения запросов на вставку, наиболее распространенными из которых являются: insert, columns и values.

// Get a db connection.
$db = JFactory::getDbo();

// Create a new query object.
$query = $db->getQuery(true);

// Insert columns.
$columns = array('user_id', 'profile_key', 'profile_value', 'ordering');

// Insert values.
$values = array(1001, $db->quote('custom.message'), $db->quote('Inserting a record using insert()'), 1);

// Prepare the insert query.
$query
    ->insert($db->quoteName('#__user_profiles'))
    ->columns($db->quoteName($columns))
    ->values(implode(',', $values));

// Set the query using our newly populated query object and execute it.
$db->setQuery($query);
$db->execute();

С использованием как объекта

Класс JDatabaseDriver также предоставляет удобный метод для сохранения объекта непосредственно в базе данных, что позволяет нам добавлять запись в таблицу без записи одной строки SQL.

// Create and populate an object.
$profile = new stdClass();
$profile->user_id = 1001;
$profile->profile_key='custom.message';
$profile->profile_value='Inserting a record using insertObject()';
$profile->ordering=1;

// Insert the object into the user profile table.
$result = JFactory::getDbo()->insertObject('#__user_profiles', $profile);

Обратите внимание, что нам не нужно экранировать имя таблицы; метод insertObject делает это за нас.

Метод insertObject выдаст ошибку, если возникнет проблема с вставкой записи в таблицу базы данных.

Если вы предоставляете уникальное значение первичного ключа (как в примере выше), настоятельно рекомендуется перед попыткой вставки выбрать из таблицы значение этого столбца.

Если вы просто вставляете следующую строку в вашу таблицу (т. Е. База данных генерирует значение первичного ключа), вы можете указать имя столбца первичного ключа в качестве третьего параметра метода insertObject (), и метод обновит объект с помощью вновь сгенерированного значения первичного ключа.

Например, с учетом следующего утверждения:

$result = $dbconnect->insertObject('#__my_table', $object, 'primary_key');

после выполнения $object->primary_key будет обновлено значением первичного ключа вновь вставленной строки.

ПОДСКАЗКА: Установите $object->primary_key в null или 0 (ноль) перед вставкой.

Обновление записи

С использованием SQL

Класс JDatabaseQuery также предоставляет методы для создания запросов на обновление, в частности update и set. Мы также повторно используем другой метод, который мы использовали при создании операторов выбора, метод where.

$db = JFactory::getDbo();

$query = $db->getQuery(true);

// Fields to update.
$fields = array(
    $db->quoteName('profile_value') . ' = ' . $db->quote('Updating custom message for user 1001.'),
    $db->quoteName('ordering') . ' = 2'
);

// Conditions for which records should be updated.
$conditions = array(
    $db->quoteName('user_id') . ' = 42', 
    $db->quoteName('profile_key') . ' = ' . $db->quote('custom.message')
);

$query->update($db->quoteName('#__user_profiles'))->set($fields)->where($conditions);

$db->setQuery($query);

$result = $db->execute();

С использованием как объекта

Как и insertObject, класс JDatabaseDriver предоставляет удобный метод для обновления объекта.

Ниже мы обновим нашу пользовательскую таблицу новыми значениями, используя существующий первичный ключ id:

// Create an object for the record we are going to update.
$object = new stdClass();

// Must be a valid primary key value.
$object->id = 1;
$object->title = 'My Custom Record';
$object->description = 'A custom record being updated in the database.';

// Update their details in the users table using id as the primary key.
$result = JFactory::getDbo()->updateObject('#__custom_table', $object, 'id');

Как и insertObject, updateObject позаботится об экранировании имен таблиц для нас.

Метод updateObject выдаст ошибку, если возникнет проблема с обновлением записи в таблице базы данных.

Мы должны убедиться, что запись уже существует, прежде чем пытаться обновить ее, поэтому мы, можем, добавить какую-то проверку записи перед выполнением метода updateObject.

Удаление записи

Наконец, есть также метод удаления для удаления записей из базы данных.

$db = JFactory::getDbo();

$query = $db->getQuery(true);

// delete all custom keys for user 1001.
$conditions = array(
    $db->quoteName('user_id') . ' = 1001', 
    $db->quoteName('profile_key') . ' = ' . $db->quote('custom.%')
);

$query->delete($db->quoteName('#__user_profiles'));
$query->where($conditions);

$db->setQuery($query);

$result = $db->execute();