PHPackages xanderevg/grid\_filters - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Database & ORM](/categories/database) 4. / 5. xanderevg/grid\_filters ActiveLibrary[Database & ORM](/categories/database) xanderevg/grid\_filters ======================= Grid filtering library for Laravel & Symfony. Dynamically apply user-defined filters (text, number, date, ranges) rules to Eloquent/Doctrine queries with unified API. Supports multi-field filters and complex UI-driven data grids. v1.1(3mo ago)1530↓50%MITPHPPHP >=8.2.0 Since Mar 25Pushed 3mo ago1 watchersCompare [ Source](https://github.com/XanderEVG/grid_filters)[ Packagist](https://packagist.org/packages/xanderevg/grid_filters)[ RSS](/packages/xanderevg-grid-filters/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (1)Dependencies (4)Versions (4)Used By (0) Универсальная библиотека для фильтрации данных в таблицах (Laravel & Symfony) ================================================================================= [](#универсальная-библиотека-для-фильтрации-данных-в-таблицах-laravel--symfony) Описание -------- [](#описание) Библиотека предоставляет инструменты для динамического добавления условий фильтрации (WHERE) к запросам Laravel Eloquent Builder и Doctrine QueryBuilder на основе параметров, переданных с клиента (например, из UI таблицы). Библиотека сократит время на реализацию фильтрации таблиц, унифицирует код для Laravel/Symfony и позволит легко масштабировать логику запросов. Решение идеально подходит для: - Админ-панелей с гридами. - Приложений с табличными данными, требующими гибкой фильтрации. Ключевые возможности - Поддержка Laravel (Eloquent) и Symfony (Doctrine ORM) из коробки. - Единый API для обеих платформ. - Объединение фильтров с помощью логического оператора AND - Фильтрация по любым полям модели/сущности. - Несколько фильтров на одно поле. - Комбинирование фильтров для разных полей. - Поддержка кэша (Xanderevg\\GridFiltersLibrary\\Core\\Cache\\CacheAdapterInterface) #### Поддержка типов: текст, число, дата, булево, диапазон, список и др. [](#поддержка-типов-текст-число-дата-булево-диапазон-список-и-др) Сортировка ---------- [](#сортировка) - Мультиколоночная сортировка. - Настраиваемые направления (ASC/DESC). Пример использования -------------------- [](#пример-использования) 1. Создание фабрики - `$baseFactory = new FilterFactory(); // Бибилиотечные фильтры` - `$baseFactory = new FilterFactory('App\BaseFilters'); // BaseFilters` - `$customFactory = (new FilterFactory())->addNamespace('App\CustomFilters'); //Библиотечные + CustomFilters, приоритет у библиотечных` - `$customFactory = (new FilterFactory('App\BaseFilters'))->addNamespace('App\CustomFilters'); //BaseFilters + CustomFilters, приоритет у BaseFilters` 2. Интеграция с DI-контейнерами Laravel: ``` // В ServiceProvider $this->app->singleton(FilterFactory::class, function() { return (new FilterFactory(config('filters.base_namespace')))->addNamespace(config('filters.custom_namespace')); }); ``` 3. Добавление фильтров ``` use FilterLibrary\Laravel\Query\EloquentBuilderAdapter; use FilterLibrary\Symfony\Query\DoctrineQueryBuilderAdapter; use FilterLibrary\Core\FilterFactory; // Инициализация фабрики $adapterLaravel = new EloquentBuilderAdapter($eloquentBuilder); $adapterSymfony = new DoctrineQueryBuilderAdapter($doctrineQueryBuilder); $factory = new FilterFactory('Xanderevg\GridFilters\Filters'); $factory->addNamespace('App\CustomFilters'); // Использование $filterElements = [ new FilterElement('column_1', 'value1', 'eq', 'string'), new FilterElement('column_2', 'value2', 'eq', 'string'), ]; try { foreach ($filterElements as $filterElement) { $filter = FilterFactory->create($adapterLaravel, $filterElement); $adapterLaravel = $filter->add(); } } catch (FilterNotFoundException $e) { // Обработка ошибки } $builder = $adapterLaravel->getBuilder(); $builder->get(); ``` 4. FilterFacade приблизительно ``` class FilterFacade { private static ?FilterFactory $instance = null; public static function addNamespace(string $namespace): void { self::getInstance()->addNamespace($namespace); } public static function create(string $type, ...$args): object { return self::getInstance()->create($type, ...$args); } private static function getInstance(): FilterFactory { if (!self::$instance) { self::$instance = new FilterFactory( 'Xanderevg\GridFilters\Filters' ); } return self::$instance; } } ``` Поддерживаемые фильтры (из коробки) ----------------------------------- [](#поддерживаемые-фильтры-из-коробки) - BooleanFilter - BoolFilter - DateFilter - DatetimeFilter - EditorFilter - IdFilter - IntFilter - NumberFilter - RolesFilter - SelectFilter - SelectTreeFilter - StringFilter - StringSelectFilter - TextFilter Установка --------- [](#установка) `composer require xanderevg/grid_filters` Кастомизация ------------ [](#кастомизация) Адаптер для кэша ---------------- [](#адаптер-для-кэша) ``` $redis = new Predis\Client(); $cacheAdapter = new App\Cache\RedisCacheAdapter($redis); $filterFactory = new Xanderevg\GridFiltersLibrary\Core\FilterFactory( 'Xanderevg\GridFiltersLibrary\Core\Filters', $cacheAdapter ); ``` Лицензия -------- [](#лицензия) MIT License. #### GitHub: [https://github.com/xanderevg/grid\_filters](https://github.com/xanderevg/grid_filters) [](#github-httpsgithubcomxanderevggrid_filters) TODO ==== [](#todo) Тесты, включая тесты на реальной бд ### Health Score 42 — FairBetter than 90% of packages Maintenance79 Regular maintenance activity Popularity18 Limited adoption so far Community7 Small or concentrated contributor base Maturity52 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~301 days Total 2 Last Release 112d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/35c37f75bbe91424a1eab024c20fd2157943b93b818cc7465057407844013690?d=identicon)[XanderEVG](/maintainers/XanderEVG) --- Top Contributors [![XanderEVG](https://avatars.githubusercontent.com/u/6702791?v=4)](https://github.com/XanderEVG "XanderEVG (24 commits)") --- Tags symfonylaraveldoctrineeloquentquery builderdynamic-filtersdata gridsgrid filters ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/xanderevg-grid-filters/health.svg) ``` [![Health](https://phpackages.com/badges/xanderevg-grid-filters/health.svg)](https://phpackages.com/packages/xanderevg-grid-filters) ``` ### Alternatives [mehdi-fathi/eloquent-filter Eloquent Filter adds custom filters automatically to your Eloquent Models in Laravel.It's easy to use and fully dynamic, just with sending the Query Strings to it. 450191.6k1](/packages/mehdi-fathi-eloquent-filter)[timgws/query-builder-parser Build complex Eloquent & QueryBuilder queries automatically when using jQuery-QueryBuilder 159387.8k](/packages/timgws-query-builder-parser) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)