smartisan/laravel-query-filter

Filter Eloquent via query URL

2.0.0 2023-02-16 16:27 UTC

Requires

• php: ^8.1
• illuminate/contracts: ^10.0
• illuminate/database: ^10.0
• illuminate/http: ^10.0
• illuminate/support: ^10.0

Requires (Dev)

• laravel/pint: ^1.5
• orchestra/testbench: ^8.0
• phpunit/phpunit: ^9.3 || ^10.0.7

MIT

• Mohamed Isa

• query-filter
• smartisan

README

Laravel query filter is a simple package that allows you to filter Eloquent results via URL query params.

Installation

You can install the package via composer:

composer require smartisan/laravel-query-filter

You can publish the config file with:

php artisan vendor:publish --provider="Smartisan\QueryFilter\QueryFilterServiceProvider" --tag="config"

Usage

1. Create a new filter class using the following command

php artisan make:filter UserFilter

1. Add a new filter method with your logic to the generated filter class

namespace App\Filters;

use Smartisan\QueryFilter\QueryFilter;

class UserFilter extends QueryFilter
{
    public function status($value)
    {
        return $this->builder->where('status', $value);
    }
}

1. To trigger the filter method, do the following in your controller

use App\Filters\UserFilter;

public function index()
{
    User::filter(UserFilter::class)->get();
}

the status filter method will be triggered automatically when the URL contains the following query param ?status=value

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Mohammed Isa
• All Contributors

License

The MIT License (MIT). Please see License File for more information.