Конструктор запросов
Для быстрого извлечения данных из моделей в MV используются специальные методы, которые обращаются к конструктору SQL запросов.
Примеры использования конструктора запросов
//Запросы внутри класса модели
$rows = $this -> select(['order->desc' => 'date', 'limit->' => 21,7]);
$rows = $this -> select(['parent' => 7, 'active' => 1, 'in_menu' => 1, 'order->asc' => 'order']);
//Запросы из шаблона
$page = $mv -> pages -> find(34);
$block_content = $mv -> blocks -> find(['id' => 1, 'active' => 1]);
$last_article = $mv -> articles -> selectOne(['order->desc' => 'active' => 1]);
$total_active = $mv -> events -> countRecords(['active' => 1]);Методы модели, использующие конструктор запросов, в качестве параметра все используют массив с параметрами для SQL запроса и обращаются к таблице модели. Если параметры не были переданы, либо передан пустой массив, то будут извлечены все записи из таблицы модели.
- select() - возвращает ассоциированный массив записей из базы данных, удовлетворяющих условиям поиска, индексы массива - id записей
- selectOne() - возвращает ассоциированный массив, с полями одной записи
- selectColumn() - возвращает одномерный индексный массив со значениями нужной колонки, параметр 'fields->' обязателен
- countRecords() - возвращает целое число, которое является количеством полей удовлетворяющих заданным условиям, без условий посчитает все записи
- find() - тоже что и selectOne(), но если искомая запись была найдена, то возвращается объект класса Record, если запись не найдена, то вернется null
//Поиск активной страницы по URL
$content = $mv -> pages -> find(['url' => 'contact', 'active' => 1]);
echo $content -> name;
echo $content -> content;
//Построение списка меню
public function displayMenu($parent)
{
$rows = $this -> select(['parent' => $parent,
'active' => 1,
'in_menu' => 1,
'order->asc' => 'order']);
foreach($rows as $row)
{
...
}
}
//Построение ленты новостей с учетом пагинации
public function display()
{
$rows = $this -> select(['order->desc' => 'date',
'limit->' => $this -> paginator -> getParamsForSQL()]);
foreach($rows as $row)
{
...
}
}Параметры для конструктора SQL запросов
'field' => 'value' - параметры вида ‘ключ-значение’, проверка на равенство
//Все записи в родительском разделе id=32
$rows = $this -> select(['parent' => 32]);
//Записи с определенными id в виде массива
$rows = $this -> select(['id' => [1,5,12]]);
//Все новости из раздела Спорт, которые одобрены для публикации
$rows = $mv -> news -> select(['type' => 'sport', 'active' => 1]);
//Все новости определенных категорий
$rows = $mv -> news -> select(['type' => ['sport', 'life', 'relax'], 'active' => 1]);
//Корпоративные клиенты с подтвержденной регистрацией за конкретную дату
$rows = $mv -> clients -> select(['group' => 'copropate', 'confirm' => 1, 'date' => '2023-07-24']);'field(!=, >, <, >=, <=)' => 'value' - параметры вида ‘ключ-значение’, проверка на неравенство и другие условия
//Все записи кроме типа с id=7
$rows = $this -> select(['type!=' => 7]);
//Товары с ценой больше 450
$rows = $this -> select(['price>' => 450]);
//Книги объемом более 300 страниц, поступившие за определенный временной интервал
$rows = $mv -> books -> select(['pages>=' => 300, 'date>=' => '2022-02-21', 'date<=' => '2024-05-07']);'fields->' => 'aaa, bbb, ccc' - ограничение полей для выборки, по умолчанию берутся все поля таблицы
//Взять названия и содержания всех активных блоков
$rows = $mv -> blocks -> select(['active' => 1, 'fields->' => 'name,content']);'field->in' => '1,2,3' - перечисление возможных значений параметра
//Выбрать товары с id равными 3, 64, и 9, которые отображаются в меню
$rows = $mv -> products -> select(['id->in' => '3,64,9', 'in_menu' => 1]);
//Выбрать новости из разделов 1,3,4,7 и 12
$rows = $mv -> news -> select(['theme->in' => '1,3,4,7,12']);
//Вариант с массивом
$rows = $mv -> news -> select(['theme' => [1,3,4,7,12]]);'field->not-in' => '1,2,3' - перечисление значений, которым не должен удовлетворять параметр
//Выбрать всех клиентов, кроме перечисленных
$rows = $mv -> clients -> select(['id->not-in' => '3,77,91']);'field->like' => 'abc' - сравнение со строковым значением
//Все клиенты, у которых в фамилии присутствует 'иван'
$rows = $mv -> clients -> select(['last_name->like' => 'иван']);'field->not-like' => 'abc' - сравнение с отсутствием строкового значения
//Все страницы, у которых в заголовках отсутствует 'магазин'
$rows = $mv -> pages -> select(['title->not-like' => 'магазин']);'order->asc' => 'field', 'order->desc' => 'field' - сортировка результатов выборки, подробнее в разделе Сортировка
//Статьи по дате публикации, вначале самые поздние
$rows = $mv -> articles -> select(['order->desc' => 'date']);
//Товары раздела по цене, вначале дешевые
$rows = $mv -> products -> select(['catalog' => 49, 'order->asc' => 'price']);'order->double' => 'field->direction' - дополнительная двойная сортировка результатов выборки, применяется совместно с 'order->asc' => 'field' или 'order->desc' => 'field'
//Статьи по дате публикации и дополнительно по рейтингу, в начале самые популярные
$rows = $mv -> articles -> select(['order->desc' => 'date', 'order->double' => 'rating->desc']);'order->in' => '23,5,76,9' - сортировка результатов выборки в порядке следования значений параметра id, применяется только для MySQL, при этом запускается конструкция 'ORDER BY FIELD (`id`, 23,5,76,9)'
//Товары в порядке следования переданных id
$rows = $mv -> products -> select(['id->in' => '7,32,56', 'order->in' => '7,32,56']);'order->' => 'random' - сортировка результатов выборки в случайном порядке
//3 статьи в случайном порядке
$rows = $mv -> articles -> select(['order->' => 'random', 'limit->' => 3]);'limit->' => 'value' - ограничение количества результатов выборки, подробнее в разделе Постраничная разбивка
//3 фотографии, которые доступны для размещение на главной странице
$rows = $mv -> photos -> select(['index_page' => 1, 'limit->' => '3']);
//Последние события, 3 страница при выводе 10 событий на страницу
$rows = $mv -> events -> select(['order->desc' => 'date', 'limit->' => '20,10']);'table->' => 'value' - указание таблицы к которой направлен запрос, по умолчанию берется таблица модели, из которой вызывается метод
//Все активные комментарии к статье
$rows = $mv -> articles -> select(['active' => 1, 'parent' => 45 'table->' => 'comments']);
//Часто применяется внутри метода модели, когда нужно обратиться к другой таблице
$this -> select(['table->' => 'people', 'event_id' => 3]);'group->by' - группировка результатов по заданному полю
//Все производители товаров в данном каталоге
$conditions = ['active' => 1, 'group->by' => 'producer', 'parent' => $catalog -> id, 'fields->' => 'id'];
$current_producers = $mv -> products -> selectColumn($conditions);'extra->' => 'sql query' - дополнительные условия запроса в обыкновенном SQL формате. Добавляются после всех условий оператора WHERE в SQL запросе. Используется для передачи в запрос сложных условий со скобками и/или условием OR.
$mv -> photos -> select(['active' => 1, 'extra->' => "((`type`='ceiling' AND `square`<='38' AND `square`>='7') OR `type` IN('wall', 'table', 'floor'))"]);'field->m2m' => 'value' - извлечение данных по полю многие ко многим, в качестве значения передается id записи противоположной модели
//Все новости по тэгу с id=24, тэги и новости связаны соотношением многие ко многим
$mv -> news -> select(['active' => 1, 'tag->m2m' => 24]);Предыдущий раздел
Методы форм