Laravel Eloquent: как построить сложный WHERE с комбинацией OR и AND?

Проблема приоритета операторов и группировка условий

Вы верно заметили главную проблему: в SQL операторы AND имеют более высокий приоритет, чем OR. Поэтому ваш исходный запрос:

WHERE status = 'active' AND price < 1000 OR is_featured = 1 AND category_id = 5

Фактически выполняется как:

WHERE (status = 'active' AND price < 1000) OR (is_featured = 1 AND category_id = 5)

...но только потому, что AND группируется сам. Однако если бы у вас было три условия, логика сломалась бы. Главное — в Eloquent нужно явно указывать группировку с помощью замыканий (closure).

Правильное решение: группировка через замыкания

Eloquent предоставляет метод where(function($query) { ... }) для создания вложенных групп условий. Внутри замыкания вы можете использовать любые методы where, orWhere и т.д., и они будут обёрнуты в скобки.

Вот как должен выглядеть ваш запрос:

use App\Models\Product;

$products = Product::where(function ($query) {
    $query->where('status', 'active')
          ->where('price', '<', 1000);
})->orWhere(function ($query) {
    $query->where('is_featured', 1)
          ->where('category_id', 5);
})->get();

Этот код сгенерирует именно тот SQL, который вам нужен:

SELECT * FROM products 
WHERE (status = 'active' AND price < 1000) 
   OR (is_featured = 1 AND category_id = 5)

Как это работает

• Первый where(function($query) {...}) создаёт группу (status = 'active' AND price < 1000). Все where() внутри этого замыкания соединяются через AND.
• Затем orWhere(function($query) {...}) добавляет вторую группу с OR. Внутри неё условия также соединяются через AND.
• Eloquent автоматически расставляет скобки вокруг каждой группы.

Дополнительные примеры

Вы можете комбинировать сколько угодно уровней вложенности. Например, если нужно добавить ещё одно условие с AND ко всему запросу:

$products = Product::where(function ($query) {
    $query->where('status', 'active')
          ->where('price', '<', 1000);
})->orWhere(function ($query) {
    $query->where('is_featured', 1)
          ->where('category_id', 5);
})->where('created_at', '>=', now()->subDays(30)) // это AND ко всему
  ->get();

Результат:

SELECT * FROM products 
WHERE (status = 'active' AND price < 1000) 
   OR (is_featured = 1 AND category_id = 5)
   AND created_at >= '2024-01-01'

Распространённые ошибки

• Забыть обернуть условия в замыкание — тогда orWhere будет применяться ко всему предыдущему условию, а не к группе.
• Использовать orWhere без группировки — как в вашем первом примере, это приводит к неправильной логике.
• Путать where и orWhere внутри группы — внутри группы все where по умолчанию соединяются через AND, если не указано иное.

Этот подход — стандартный для Laravel и используется в большинстве сложных запросов. Освоив его, вы сможете строить запросы любой сложности.

$products = Product::whereRaw(
    '(status = ? AND price < ?) OR (is_featured = ? AND category_id = ?)',
    ['active', 1000, 1, 5]
)->get();