[11.x] Introduce whenWhere methods in query builder

[zakariaarrid]

Introduction of whenWhere function to Laravel Query Builder

Usage Examples

$users = User::query()
            ->whenWhere($request->active, 'is_active', true)
            ->whenWhere($request->role, 'role', $request->role)
            ->get();

instead of

 $users = User::query()
            ->when($request->active, function($query) {
                $query->where('is_active', true);
            })
            ->when($request->role, function($query, $role) {
                $query->where('role', $role);
            })
            ->get();

[rodrigopedra]

IMO, this is already short enough:

$users = User::query()
    ->when($request->active, fn ($q) => $q->where('is_active', true))
    ->when($request->role, fn ($q, $role) => $q->where('role', $role))
    ->get();

And also, IMO, more expressive/declarative of intent of its parameters.

Other than that, what about whenWhereNull, whenWhereNotNull, whenWhereIn, whenWhereNotIn, whenWhereHas, whenWhereExists, whenWhereRaw, whenWhereNot, etc.?

[gdebrauwer]

@rodrigopedra you can even make your example shorter by using the higher-order 'when' method 😄

$users = User::query()
    ->when($request->active)->where('is_active', true)
    ->when($request->role)->where('role', $role)
    ->get();

[howdu]

It'd be useful if when auto handled the where clause wrapping for use with OR conditions.

$users = User::query()
    ->when(
        $search,
        fn (Builder $query) => $query->where(
            fn (Builder $query) => $query
                ->where('test', $search)
                ->orWhereNull('test')
        )
    )