Раньше при создании запросов в базу данных мы всегда получали объект запроса с помощью метода getQuery()
. Если передавался параметр $new = true
, то получали новый запрос. Если без - последний.
<?php
use Joomla\CMS\Factory;
$db = Factory::getContainer()->get('DatabaseDriver');
$query = $db->getQuery(new: true);
// и строим запрос
Под капот Joomla 4 вошёл Joomla Framework (PHP фреймворк а-ля Laravel, Yii и т.д.), а для Joomla 5 он обновился - версия 3.4.1 вышла 6 октября 2023г. В методе фреймворка есть примечание о том, что параметр $new
, который передавался в метод getQuery()
помечен как устаревший и будет удалён в версии фреймворка 4.0.
The parameter $new is deprecated and will be removed in 4.0, use %s::createQuery() instead.
В Joomla 4 версия Joomla Framework была 2.x., в Joomla 5 - 3.x. Поэтому есть предположение, что с выходом Joomla 6 обновится и версия фреймворка - станет 4.0. Поэтому для получения объекта для новых запросов следует использовать метод createQuery()
. Он уже представлен в ядре и широко используется. При этом метод getQuery()
останется, но, скорее всего, будет выполнять функцию только геттера - получения текущего запроса.
Однако, следует помнить о том, что объект Database - один из самых "тяжёлых" в Joomla. Поэтому если вы, например, пишете CLI приложение для Joomla, то память сервера лучше экономить. Метод createQuery()
создаёт новый объект. Вместо этого можно взять уже существующий объект и очистить его значения методом clear()
.
<?php
use Joomla\CMS\Factory;
use Joomla\Database\ParameterType;
$db = Factory::getContainer()->get('DatabaseDriver');
$query = $db->getQuery(new: true);
$query->select($db->quote('*'))->from($db->quotName('#__content'));
// и выполняем запрос
$result = $db->setQuery($query)->loadAssoclist();
// очистим существующий объект Database от данных предыдущего запроса
$query->clear();
// Строим новый запрос
$query->delete($db->quoteName('#__any_table'))
->where('id = :id')
->bind(':id', (int) $id, ParameterType::INTEGER);
// Выполним новый запрос
$db->setQuery($query)->execute();