PHPackages                             webfactory/visibility-filter-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. webfactory/visibility-filter-bundle

AbandonedArchivedLibrary[Database & ORM](/categories/database)

webfactory/visibility-filter-bundle
===================================

Symfony Bundle that filters out invisible Doctrine entities in a centralised way

2.0.0(1y ago)01.8k[8 issues](https://github.com/webfactory/webfactory-visibility-filter-bundle/issues)[2 PRs](https://github.com/webfactory/webfactory-visibility-filter-bundle/pulls)MITPHPPHP ^8.1CI passing

Since Apr 18Pushed 1y ago1 watchersCompare

[ Source](https://github.com/webfactory/webfactory-visibility-filter-bundle)[ Packagist](https://packagist.org/packages/webfactory/visibility-filter-bundle)[ RSS](/packages/webfactory-visibility-filter-bundle/feed)WikiDiscussions master Synced today

READMEChangelog (6)Dependencies (11)Versions (23)Used By (0)

VisibilityFilterBundle – A centralised approach to visibility of Doctrine Entities
==================================================================================

[](#visibilityfilterbundle--a-centralised-approach-to-visibility-of-doctrine-entities)

This bundle provides a Doctrine Filter which handles visibility filtering for Entities transparently for a whole application, removing the need to repeatedly phrase the filtering in every repository method of an Entity. Most notably, the filtering also applies to Doctrine queries that bypass the repository, like relationships declared in the entity mapping.

Getting started
---------------

[](#getting-started)

First, you need to declare this bundle as a composer dependency.

```
composer require webfactory/visibility-filter-bundle
```

Next, the bundle needs to be registered to Symfony. Depending on your Symfony version, this might look like that:

```
# src/bundles.php

return [
    # ...
        Webfactory\VisibilityFilterBundle\VisibilityFilterBundle::class => ['all' => true],
    # ...
];
```

The filter class needs to be registered manually.

```
# src/config.yml
doctrine:
    orm:
        filters:
            visibility: Webfactory\VisibilityFilterBundle\Filter\VisibilityColumnConsideringSQLFilter
```

Important: The YAML key of the filter needs to `visibility`, otherwise the filter won't be activated on requests.

Configuring the visibility column
---------------------------------

[](#configuring-the-visibility-column)

This bundle assumes that the visibility determination is going to be based on a specific field in the Entity containing visibility information; e.g. functioning as a "visibility switch" containing "yes" or "no" or containing a visibility grade on a scale, based on which the visibility of the object will be determined.

**Currently, only entities that have a visibility column configured will be filtered at all.**

All you need to configure on your entity is *which* of its fields will be the one with the visibility information. You can do that by Adding the `VisibilityColumn` attribute to that field.

```
use Doctrine\ORM\Mapping as ORM;
use Webfactory\VisibilityFilterBundle\Attribute\VisibilityColumn;

 #[ORM\Entity()]
class EntityWithVisibilityColumn
{
    // ...
     #[ORM\Column(type: "string")]
     #[VisibilityColumn]
    private string $visibilityColumn;
    // ...
}
```

Please note that configuring more than one field as visibility column will throw an exception.

Replacing the filter strategy
-----------------------------

[](#replacing-the-filter-strategy)

By default, the library makes you application only query entities from the database that have the string `y` in their visibility column. You can change this behaviour by overwriting the service `Webfactory\VisibilityFilterBundle\Filter\FilterStrategy` with your own implementation.

Your implementation needs to implement the `FilterStrategy` interface. If you only want to change the `y` string to something different, you can use the `Webfactory\VisibilityFilterBundle\Filter\Strategy\ValueInField` implementation and provide it with a different `visibleValue` in its constructor.

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance48

Moderate activity, may be stable

Popularity15

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity71

Established project with proven stability

 Bus Factor1

Top contributor holds 77.2% 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 ~217 days

Total

8

Last Release

382d ago

Major Versions

1.5.0 → 2.0.02025-06-16

PHP version history (3 changes)1.0PHP ^7.2

1.3.0PHP ^7.2|^8.1

1.5.0PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/d4ed0a0f5a1c56f7df31bb8c854a2ad99d24281dc8df4b4d3dd986a9e84b7a24?d=identicon)[webfactory](/maintainers/webfactory)

---

Top Contributors

[![janopae](https://avatars.githubusercontent.com/u/8160319?v=4)](https://github.com/janopae "janopae (78 commits)")[![mpdude](https://avatars.githubusercontent.com/u/1202333?v=4)](https://github.com/mpdude "mpdude (12 commits)")[![relthyg](https://avatars.githubusercontent.com/u/8628559?v=4)](https://github.com/relthyg "relthyg (9 commits)")[![MalteWunsch](https://avatars.githubusercontent.com/u/2504942?v=4)](https://github.com/MalteWunsch "MalteWunsch (2 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/webfactory-visibility-filter-bundle/health.svg)

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

###  Alternatives

[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k17.9M388](/packages/easycorp-easyadmin-bundle)[symfony/framework-bundle

Provides a tight integration between Symfony components and the Symfony full-stack framework

3.6k251.7M11.6k](/packages/symfony-framework-bundle)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k5.9M737](/packages/sylius-sylius)[sulu/sulu

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

1.3k1.4M203](/packages/sulu-sulu)[contao/core-bundle

Contao Open Source CMS

1231.6M2.8k](/packages/contao-core-bundle)[open-dxp/opendxp

Content & Product Management Framework (CMS/PIM)

9421.6k61](/packages/open-dxp-opendxp)

PHPackages © 2026

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