laravel.pw

Русский

English

Русский

English

Оформление

Query BuilderEloquent-запросы из запросов к API

Параметры filter[], sort, include и fields[] проверяются по списку разрешённых и применяются к Eloquent-запросу.

Документация 1.x
GitHub
UserController.php
GET /users?fields[users]=name&fields[posts]=title&include=posts
QueryBuilder::for(User::class)
    ->allowedFields('name', 'posts.title')
    ->allowedIncludes('posts')
    ->get();
select "users"."name", "users"."id" from "users"
select "posts"."title", "posts"."user_id" from "posts"
  where "posts"."user_id" in (1, 2, 3)
   ключи связи добавлены автоматически

Полная замена spatie

Совместим по API со spatie/laravel-query-builder 7.x — те же имена классов, сигнатуры методов, исключения и файл конфигурации. Переход сводится к смене namespace.

Подгруженные связи никогда не пусты

Если вместе с include запрошен набор полей, ключи, нужные каждой подгружаемой связи, добавляются в SELECT автоматически.

Definitions API

Типизированные фильтры и операторы, сортировка по связям, виртуальные поля, вложенные определения, пагинация и все ошибки запроса за один раз.

Установка ​

bash
composer require myprogs/query-builder

Нужны PHP 8.3 или новее и Laravel 12 или 13. Сервис-провайдер подключается автоматически. Дальше — в документацию.