PHPackages                             bartlomiejbeta/filter-sorter-bundle - 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. bartlomiejbeta/filter-sorter-bundle

ActiveSymfony-bundle[Database & ORM](/categories/database)

bartlomiejbeta/filter-sorter-bundle
===================================

v2.1.0(7y ago)0756MITPHPPHP ^7.0

Since Sep 1Pushed 7y ago1 watchersCompare

[ Source](https://github.com/bartlomiejbeta/FilterSorterBundle)[ Packagist](https://packagist.org/packages/bartlomiejbeta/filter-sorter-bundle)[ RSS](/packages/bartlomiejbeta-filter-sorter-bundle/feed)WikiDiscussions master Synced 2w ago

READMEChangelog (7)Dependencies (9)Versions (9)Used By (0)

FilterSorterBundle
==================

[](#filtersorterbundle)

This Symfony bundle aims to provide structurized filtering and sorting with usage of the specification pattern (see [doctrine-specification](https://github.com/Happyr/Doctrine-Specification)). It was design to use in the api applications but it could be also used with standard web apps.

##### Provides feature like:

[](#provides-feature-like)

- `FilterQueryManager` - it collects all `filter services` and gives you queryBuilder with applied specifications.
- `FilterParamConverter` - provide `filter object` by the data in query string
- `SortParamConverter` - provide `sort object` by the data in query string

[![Build Status](https://camo.githubusercontent.com/84beca922641ceb6db40b5aef50295b873e4393562f65a6245ab621e3ed75635/68747470733a2f2f7472617669732d63692e6f72672f626172746c6f6d69656a626574612f46696c746572536f7274657242756e646c652e706e673f6272616e63683d6d6173746572)](https://travis-ci.org/bartlomiejbeta/FilterSorterBundle)

### Installation

[](#installation)

##### 1. Install via composer:

[](#1-install-via-composer)

```
composer require bartlomiejbeta/filter-sorter-bundle

```

##### 2. Register bundle in `AppKernel`:

[](#2-register-bundle-in-appkernel)

```
public function registerBundles()
{
    $bundles = array(
        // ...
        new BartB\FilterSorterBundle\FilterSorterBundle(),
    );
}
```

### Usage

[](#usage)

I assume that you already have entities, and so one.

##### 1. Change parent of the entities to `AbstractEntitySpecificationAwareRepository`:

[](#1-change-parent-of-the-entities-to-abstractentityspecificationawarerepository)

example:

```
class CarRepository extends AbstractEntitySpecificationAwareRepository
{
}
```

##### 2. Add specifications ([example](https://github.com/bartlomiejbeta/FilterSorterBundleExample/tree/master/src/AppBundle/Repository/Specification))

[](#2-add-specifications-example)

##### 3. Add Collection filter ([example](https://github.com/bartlomiejbeta/FilterSorterBundleExample/blob/master/src/AppBundle/Data/Filter/CarCollectionFilter.php))

[](#3-add-collection-filter-example)

##### 4. Add Sort Enum ([example](https://github.com/bartlomiejbeta/FilterSorterBundleExample/blob/master/src/AppBundle/Data/Sort/CarSort.php))

[](#4-add-sort-enum-example)

##### 5. Build and register your first service adapter ([adapter example](https://github.com/bartlomiejbeta/FilterSorterBundleExample/blob/master/src/AppBundle/Service/Filter/Adapter/FilterCarAdapter.php), [register adapter example](https://github.com/bartlomiejbeta/FilterSorterBundleExample/blob/master/src/AppBundle/Resources/config/services.yml))

[](#5-build-and-register-your-first-service-adapter-adapter-example-register-adapter-example)

##### 5. Run ([standard](https://github.com/bartlomiejbeta/FilterSorterBundleExample/blob/master/src/AppBundle/Controller/DefaultController.php), [api with paramConverters](https://github.com/bartlomiejbeta/FilterSorterBundleExample/blob/master/src/AppBundle/Controller/GetCarController.php))

[](#5-run-standard-api-with-paramconverters)

```
$carCollectionFilter = (new CarCollectionFilter())->setGearboxType('automatic');

$carSorter     = new CarSort(CarSort::FUEL_TYPE);
$sortDirection = new SortDirectionType(SortDirectionType::DESC);

/** @var FilterQueryManager $filterQueryManager */
$filterQueryManager = $this->filterQueryManager;
$carRepository      = $this->repostioryCar;
$sort 	            = new Sort($sortDirection, $carSorter);
$limit              = new Limit(1);

$basicRepositoryDTO = new BasicRepositoryDTO($carRepository);
$queryAttributesDTO = new QueryAttributesDTO($carCollectionFilter, $sort, $limit);

$queryBuilder = $filterQueryManager->getQueryBuilder($basicRepositoryDTO, $queryAttributesDTO);
$query        = $queryBuilder->getQuery();
$result       = $query->execute();
```

TODO: Upgrade example to symfony 3.4 [Also I prepared full stand alone example](https://github.com/bartlomiejbeta/FilterSorterBundleExample)

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity63

Established project with proven stability

 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 ~52 days

Total

8

Last Release

2860d ago

Major Versions

v0.2.1 → v1.0.02018-02-18

v1.0.1 → v2.0.02018-08-31

### Community

Maintainers

![](https://www.gravatar.com/avatar/74ae63f212d957f86bee321c97a221bc5a464d55ffe7871778bcf8ae17a685fc?d=identicon)[bartlomiejbeta](/maintainers/bartlomiejbeta)

---

Top Contributors

[![bartlomiejbeta](https://avatars.githubusercontent.com/u/17701206?v=4)](https://github.com/bartlomiejbeta "bartlomiejbeta (20 commits)")

---

Tags

specificationdoctrinefiltersorter

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/bartlomiejbeta-filter-sorter-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/bartlomiejbeta-filter-sorter-bundle/health.svg)](https://phpackages.com/packages/bartlomiejbeta-filter-sorter-bundle)
```

###  Alternatives

[rcsofttech/audit-trail-bundle

Enterprise-grade, high-performance Symfony audit trail bundle. Automatically track Doctrine entity changes with split-phase architecture, multiple transports (HTTP, Queue, Doctrine), and sensitive data masking.

1175.2k](/packages/rcsofttech-audit-trail-bundle)[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k17.5M378](/packages/easycorp-easyadmin-bundle)[kimai/kimai

Kimai - Time Tracking

4.8k8.7k1](/packages/kimai-kimai)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.4M196](/packages/sulu-sulu)[ahmed-bhs/doctrine-doctor

Runtime analysis tool for Doctrine ORM integrated into Symfony Web Profiler. Unlike static linters, it analyzes actual query execution at runtime to detect performance bottlenecks, security vulnerabilities, and best practice violations during development with real execution context and data.

939.0k](/packages/ahmed-bhs-doctrine-doctor)[2lenet/crudit-bundle

The easy like Crud'it Bundle.

1615.6k12](/packages/2lenet-crudit-bundle)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)