PHPackages                             hostnet/entity-tracker-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. [Utility & Helpers](/categories/utility)
4. /
5. hostnet/entity-tracker-bundle

ActiveLibrary[Utility & Helpers](/categories/utility)

hostnet/entity-tracker-bundle
=============================

Wraps around the hostnet/entity-tracker-component and allows configuration of several listener components

2.0.5(1y ago)7109.2k↓18.8%7[2 PRs](https://github.com/hostnet/entity-tracker-bundle/pulls)MITPHPPHP ^8.1

Since Aug 14Pushed 1mo ago4 watchersCompare

[ Source](https://github.com/hostnet/entity-tracker-bundle)[ Packagist](https://packagist.org/packages/hostnet/entity-tracker-bundle)[ RSS](/packages/hostnet-entity-tracker-bundle/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (13)Versions (20)Used By (0)

README
======

[](#readme)

- [What is the Entity Tracker Bundle?](#what-is-the-entity-tracker-bundle)
- [Requirements](#requirements)
- [Installation](#installation)

### Documentation

[](#documentation)

- [How does it work?](#how-does-it-work)
- [Setup](#setup)
    - [Register The Bundle in your AppKernel](#register-the-bundle-in-your-appkernel)
    - [Configuration Overview](#configuration-overview)
        - [Blamable Component](#configuring-the-blamable-component)
        - [Mutation Component](#configuring-the-mutation-component)
        - [Revision Component](#configuring-the-revision-component)

What is the Entity Tracker Bundle?
----------------------------------

[](#what-is-the-entity-tracker-bundle)

The Entity Tracker Bundle is a bundle used to configure the following components:

- [hostnet/entity-tracker-component](https://github.com/hostnet/entity-tracker-component)
- [hostnet/entity-blamable-component](https://github.com/hostnet/entity-blamable-component)
- [hostnet/entity-mutation-component](https://github.com/hostnet/entity-mutation-component)
- [hostnet/entity-revision-component](https://github.com/hostnet/entity-revision-component)

It will let you configure those components using the config.yaml

> Note: Only the Entity Tracker Component is mandatory, as this bundle configures the services. The other components only need to be configured if they are present.

Requirements
------------

[](#requirements)

The tracker bundle requires at least php 7.3 and runs on Doctrine2 and Symfony2. For specific requirements, please check [composer.json](../master/composer.json)

Installation
------------

[](#installation)

Installing is pretty easy, this package is available on [packagist](https://packagist.org/packages/hostnet/entity-tracker-bundle). You can register the package locked to a major as we follow [Semantic Versioning 2.0.0](http://semver.org/).

#### Example

[](#example)

```
    "require" : {
        "hostnet/entity-tracker-bundle" : "^2.0.0"
    }
```

> Note: You can use dev-master if you want the latest changes, but this is not recommended for production code!

Documentation
=============

[](#documentation-1)

How does it work?
-----------------

[](#how-does-it-work)

It features a config builder that allows you to config only what you need. If you have the "Blamable" annotation available, it will throw an exception during container compilation if it's not configured. The same goes for all other supported components. If you happen to configure it while it isn't used, it will also let you know.

Setup
-----

[](#setup)

#### Register The Bundle in your AppKernel

[](#register-the-bundle-in-your-appkernel)

This bundle is not dependent on others based on compiler passes or configuration.

```
class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = [
            // ...
            new Hostnet\Bundle\EntityTrackerBundle\HostnetEntityTrackerBundle()
            // ...
        ];

        return $bundles;
    }
}
```

#### Configuration Overview

[](#configuration-overview)

By default, nothing is required. Only when you enable a certain configuration option, it will yell you what's missing.

If you are using entities in your bundle, your bundle should have a dependency on the component using the specific annotation you use. If your bundle is in your application, your application should have a dependency on the component. If you use the [hostnet/entity-plugin-lib](https://github.com/hostnet/entity-plugin-lib), you will have separate packages for entities. You should put your dependencies on that package.

> Note: Based on what is available, the configuration requirements are determined. If one of the bundles or Entity packages has a dependency on one of the components, this bundle will also configure it for you.

The template is as following:

```
# Default configuration for extension with alias: "hostnet_entity_tracker"
hostnet_entity_tracker:

    # Configures and enables the blamable listener
    blamable:

        # Provider implementation of Hostnet\Component\EntityBlamable\Provider\BlamableProviderInterface
        provider: ~ # Required

    # Configures and enables the revision listener
    revision:

        # Factory implementation of Hostnet\Component\EntityRevision\Factory\RevisionFactoryInterface
        factory: ~ # Required

    # Configures and enables the mutation listener
    mutation: ~
```

##### Configuring the Blamable Component

[](#configuring-the-blamable-component)

The Blamable Component has 1 required option, the provider. The provider is [the class that implements the BlamableProviderInterface as explained in the documation](https://github.com/hostnet/entity-blamable-component/#creating-a-provider-for-the-username-and-timestamp). The argument passed to that option is the name of the service you are using for it. There are two ways you can go about using these providers. The first way is to make use of the [default blamamable provider](https://github.com/hostnet/entity-tracker-bundle/blob/master/src/Services/Blamable/DefaultBlamableProvider.php) that is shipped with this bundle. This can be done using the following method:

*config.yaml*

```
hostnet_entity_tracker:
    blamable:
        provider: entity_tracker.provider.blamable
        default_username: "username for example purposes"
```

It is also possible to create your own BlamamableProvider by implementing the BlamableProviderInterface. If you choose to do this the following method can be used to make use of your custom BlamableProvider.

> Note: The following example is based on the AcmeBlamableProvider from the link above

*services.yaml*

```
services:
    acme.provider.blamable:
        class: Acme\Bundle\AcmeBundle\Service\AcmeBlamableProvider
        arguments:
            - 'username for example purposes'
```

*config.yaml*

```
hostnet_entity_tracker:
    blamable:
        provider: acme.provider.blamable
```

##### Configuring the Mutation Component

[](#configuring-the-mutation-component)

The Mutation Component has no required options. All you have to do to enable it, is add "mutation: ~" to the config.

*config.yaml*

```
hostnet_entity_tracker:
    mutation: ~
```

##### Configuring the Revision Component

[](#configuring-the-revision-component)

The Revision Component has 1 required option, the factory. The factory is [the class that implements the RevisionFactoryInterface as explained in the documation](https://github.com/hostnet/entity-revision-component/#creating-the-acmerevisionfactory). The argument passed to that option is the name of the service you are using for it.

> Note: The following example is based on the AcmeRevisionFactory from the link above

*services.yaml*

```
services:
    acme.factory.revision:
        class: Acme\Bundle\AcmeBundle\Service\AcmeBlamableProvider
        arguments:
            - 'author->name for example purposes'
```

*config.yaml*

```
hostnet_entity_tracker:
    revision:
        factory: acme.factory.revision
```

###  Health Score

56

—

FairBetter than 98% of packages

Maintenance69

Regular maintenance activity

Popularity38

Limited adoption so far

Community22

Small or concentrated contributor base

Maturity81

Battle-tested with a long release history

 Bus Factor3

3 contributors hold 50%+ of commits

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

Recently: every ~526 days

Total

19

Last Release

461d ago

Major Versions

0.0.3 → 1.0.02014-09-10

1.2.6 → 2.0.02019-05-07

PHP version history (7 changes)0.0.1PHP 5.\*, >=5.4

1.2.1PHP ^5.4

1.2.2PHP >=5.5

1.2.5PHP 5.\*,>=5.6||7.\*

2.0.0PHP >=7.2

2.0.3PHP ^7.3||^8.0

2.0.4PHP ^8.1

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/5468127?v=4)[Yannick de Lange](/maintainers/yannickl88)[@yannickl88](https://github.com/yannickl88)

![](https://www.gravatar.com/avatar/65433e1ef6edb2e8f96e18614b6618c84eed20ad0de6de0d0da36a9032ec7a18?d=identicon)[hostnet](/maintainers/hostnet)

---

Top Contributors

[![yannickl88](https://avatars.githubusercontent.com/u/5468127?v=4)](https://github.com/yannickl88 "yannickl88 (10 commits)")[![nicoschoenmaker](https://avatars.githubusercontent.com/u/1469323?v=4)](https://github.com/nicoschoenmaker "nicoschoenmaker (8 commits)")[![linaori](https://avatars.githubusercontent.com/u/1754678?v=4)](https://github.com/linaori "linaori (6 commits)")[![nutama](https://avatars.githubusercontent.com/u/9001392?v=4)](https://github.com/nutama "nutama (5 commits)")[![janlam7](https://avatars.githubusercontent.com/u/5459235?v=4)](https://github.com/janlam7 "janlam7 (5 commits)")[![ping-localhost](https://avatars.githubusercontent.com/u/37925797?v=4)](https://github.com/ping-localhost "ping-localhost (3 commits)")[![hboomsma](https://avatars.githubusercontent.com/u/1465009?v=4)](https://github.com/hboomsma "hboomsma (1 commits)")[![stefanlenselink](https://avatars.githubusercontent.com/u/834562?v=4)](https://github.com/stefanlenselink "stefanlenselink (1 commits)")[![StijnKlopper2k](https://avatars.githubusercontent.com/u/198602351?v=4)](https://github.com/StijnKlopper2k "StijnKlopper2k (1 commits)")[![jras-gh](https://avatars.githubusercontent.com/u/6052599?v=4)](https://github.com/jras-gh "jras-gh (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/hostnet-entity-tracker-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/hostnet-entity-tracker-bundle/health.svg)](https://phpackages.com/packages/hostnet-entity-tracker-bundle)
```

###  Alternatives

[spomky-labs/pwa-bundle

Progressive Web App Manifest Generator Bundle for Symfony.

6144.4k1](/packages/spomky-labs-pwa-bundle)[netgen/layouts-core

Netgen Layouts enables you to build and manage complex web pages in a simpler way and with less coding. This is the core of Netgen Layouts, its heart and soul.

3689.4k10](/packages/netgen-layouts-core)[netgen/content-browser

Netgen Content Browser is a Symfony bundle that provides an interface which selects items from any kind of backend and returns the IDs of selected items back to the calling code.

14112.1k8](/packages/netgen-content-browser)[sineflow/clamav

ClamAV PHP Client for Symfony

10168.5k](/packages/sineflow-clamav)[numero2/contao-storelocator

Contao Plugin for managing stores (or in common address data) and providing a frontend-search based on geo data

121.5k](/packages/numero2-contao-storelocator)

PHPackages © 2026

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