O Laravel é conhecido por sua elegância e facilidade de uso, e uma das áreas onde ele realmente brilha é na consulta de banco de dados. Freqüentemente, você precisará criar consultas complexas com base na entrada do usuário ou em outros fatores dinâmicos. O Eloquent ORM do Laravel oferece uma maneira limpa e simples de interagir com seu banco de dados, mas e se você quiser tornar suas consultas de modelo mais flexíveis? Insira o conceito de filtragem de modelo.

Neste blog, exploraremos como criar um filtro de modelo poderoso e reutilizável no Laravel. Isso permitirá que você aplique condições de consulta dinamicamente com base nos parâmetros de solicitação recebidos, tornando suas consultas do Eloquent mais modulares e fáceis de manter.

Por que usar um filtro de modelo?

Um filtro de modelo no Laravel é uma classe que encapsula toda a lógica necessária para construir condições de consulta dinâmica com base na entrada do usuário. Isso ajuda a manter seus controladores limpos, reutilizando código e tornando seu aplicativo mais modular.

Vantagens de usar um filtro de modelo:

• Separação de preocupações: mantém seu controlador limpo movendo a lógica de consulta para uma classe dedicada.

• Reutilização: permite reutilizar a mesma lógica de filtro em vários controladores ou consultas.

• Flexibilidade: torna mais fácil adicionar ou modificar condições de consulta sem alterar a lógica central do seu aplicativo.

Guia passo a passo para implementar um filtro de modelo

Etapa 1: Configurando a classe de filtro

Comece criando uma classe de filtro base que lidará com a adição dinâmica de condições de consulta. Esta classe se encarregará de aplicar filtros com base nos dados da solicitação.

request = $request;
    }

    public function apply(Builder $builder)
    {
        $this->builder = $builder;

        foreach ($this->filters() as $filter => $value) {
            if (method_exists($this, $filter)) {
                $this->$filter($value);
            }
        }

        return $this->builder;
    }

    public function filters()
    {
        return $this->request->all();
    }
}

Etapa 2: Criando classes de filtro específicas

Em seguida, crie uma classe de filtro específica para o modelo que deseja filtrar. Esta classe estenderá a classe base QueryFilter e conterá métodos para cada atributo filtrável.

Por exemplo, digamos que você tenha um modelo de Produto e queira filtrar por categoria, preço e disponibilidade.

builder->where('category_id', $value);
    }

    public function price($value)
    {
        return $this->builder->where('price', 'builder->where('availability', $value);
    }
}

Etapa 3: aplicando o filtro em seu controlador

Agora, aplique o filtro em seu controlador para filtrar dinamicamente os resultados com base nos parâmetros da solicitação.

get();

        return view('products.index', compact('products'));
    }
}

Etapa 4: Adicionando um escopo de filtro ao modelo

Para facilitar a aplicação de filtros, adicione um escopo ao seu modelo Eloquent.

apply($query);
    }
}

Etapa 5: usando o filtro em seu aplicativo

Com tudo configurado, agora você pode filtrar facilmente seu modelo de produto com base nos parâmetros de solicitação recebida. Por exemplo:

// Example: /products?category=1&price=100&availability=in_stock

Este URL filtrará os produtos com base na categoria, preço e disponibilidade especificados, e os resultados filtrados serão exibidos ao usuário.

Conclusão

A filtragem de modelo no Laravel é uma maneira poderosa de lidar com condições de consulta dinâmica com código limpo e reutilizável. Seguindo as etapas acima, você pode criar um sistema de filtro flexível que simplifica seus controladores e torna sua aplicação mais fácil de manter. Essa abordagem não apenas ajuda a escrever menos código, mas também torna suas consultas mais adaptáveis ​​a requisitos futuros.

Em sua jornada como desenvolvedor Laravel, dominar esses padrões melhorará significativamente a qualidade e escalabilidade de seus aplicativos. Então, experimente e leve suas consultas do Laravel para o próximo nível!

Aproveitar!