PHPackages                             nowo-tech/user-kit-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. [Security](/categories/security)
4. /
5. nowo-tech/user-kit-bundle

ActiveSymfony-bundle[Security](/categories/security)

nowo-tech/user-kit-bundle
=========================

Symfony bundle for user account enable/disable, last activity tracking, and online presence detection.

v1.1.6(2w ago)0577↑1875%MITPHPPHP &gt;=8.2 &lt;8.6CI passing

Since Jul 14Pushed 1w agoCompare

[ Source](https://github.com/nowo-tech/UserKitBundle)[ Packagist](https://packagist.org/packages/nowo-tech/user-kit-bundle)[ Docs](https://packagist.org/packages/nowo-tech/user-kit-bundle)[ GitHub Sponsors](https://github.com/HecFranco)[ RSS](/packages/nowo-tech-user-kit-bundle/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (10)Dependencies (38)Versions (11)Used By (0)

User Kit Bundle
===============

[](#user-kit-bundle)

[![CI](https://github.com/nowo-tech/UserKitBundle/actions/workflows/ci.yml/badge.svg)](https://github.com/nowo-tech/UserKitBundle/actions/workflows/ci.yml) [![Packagist Version](https://camo.githubusercontent.com/98e56ef6d0c84e4e581073cb85d6efc2ee4dec31ecc58f488cc9eb059b756534/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e6f776f2d746563682f757365722d6b69742d62756e646c652e7376673f7374796c653d666c6174)](https://packagist.org/packages/nowo-tech/user-kit-bundle) [![Packagist Downloads](https://camo.githubusercontent.com/d1cdeff1f8a630db741495402bbf45995c8be201861540b240f3a565bd652de0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e6f776f2d746563682f757365722d6b69742d62756e646c652e737667)](https://packagist.org/packages/nowo-tech/user-kit-bundle) [![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE) [![PHP](https://camo.githubusercontent.com/3f99b197569aa2dcfbefff17ecc68d74098e7f929d8b52dc40f3a898f740eae1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d3737374242343f6c6f676f3d706870)](https://php.net) [![Symfony](https://camo.githubusercontent.com/0701ae1a8855b98dea0f1dc9d9025d6b0f9444a803559dc983614d044176348b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53796d666f6e792d372e34253230253743253230382e30253230253743253230382e312532422d3030303030303f6c6f676f3d73796d666f6e79)](https://symfony.com) [![GitHub stars](https://camo.githubusercontent.com/4fd1d2c475930b21f2e3798853f2fe07494af98d203997d7ef367ed362111eed/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6e6f776f2d746563682f757365722d6b69742d62756e646c652e7376673f7374796c653d736f6369616c266c6162656c3d53746172)](https://github.com/nowo-tech/UserKitBundle) [![Coverage](https://camo.githubusercontent.com/cd0704b56f1d56def350b6d0164316307bb2f47834225fd85443b6fb0059bc73/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f7665726167652d3130302532352d627269676874677265656e)](#tests-and-coverage)

> ⭐ **Found this useful?** Install from [Packagist](https://packagist.org/packages/nowo-tech/user-kit-bundle) and give the repo a star on GitHub.

Symfony bundle for **user account lifecycle and presence**: enable/disable accounts (`UserChecker`), throttled `lastActivityAt` updates, and configurable online detection. Designed to complement [`nowo-tech/auth-kit-bundle`](https://github.com/nowo-tech/AuthKitBundle) without a hard Composer dependency.

[![FrankenPHP Friendly Worker Mode](docs/images/frankenphp-friendly.png)](docs/images/frankenphp-friendly.png)

This bundle is **FrankenPHP worker mode friendly**.

Features
--------

[](#features)

- **`enabled` / disabled accounts** — `AccountStatusUserChecker` blocks login for disabled users
- **`lastActivityAt`** — updated on authenticated HTTP requests (throttled)
- **`online_threshold`** — `UserPresenceResolver::isOnline()` and optional Twig `user_is_online()`
- **Named profiles** — separate config per user entity (`User`, `Admin`, …) with O(1) class resolution
- **Session invalidation hook** — optional listener when an account is disabled
- **Optional traits** — `EnabledUserTrait`, `LastActivityTrait`
- **Translations** — domain `NowoUserKitBundle` (`de`, `en`, `es`, `fr`, `it`, `nl`, `pt`)

Quick start
-----------

[](#quick-start)

```
composer require nowo-tech/user-kit-bundle
```

```
# config/packages/nowo_user_kit.yaml
nowo_user_kit:
    default_profile: default
    profiles:
        default:
            user_class: App\Entity\User
            account_status:
                enabled: true
            last_activity:
                enabled: true
                online_threshold: 300
```

The legacy flat layout (`user_class` at root) remains supported. See [Configuration](docs/CONFIGURATION.md).

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

[](#requirements)

- PHP 8.2+
- Symfony 7.4 | 8.x

AuthKit coexistence
-------------------

[](#authkit-coexistence)

```
Login (AuthKit) → form_login → UserProvider → UserChecker (UserKit) → OK / blocked

```

Use the same `user_class` in both bundles. UserKit may inherit `user_class` from `nowo_auth_kit.user_class` when that parameter exists.

Demo
----

[](#demo)

```
make -C demo up    # Symfony 8.1 — http://localhost:8023
```

Login with `demo@user-kit.test` / `demo`. The demo runs under **FrankenPHP** in Docker. See [demo/README.md](demo/README.md) and [docs/DEMO-FRANKENPHP.md](docs/DEMO-FRANKENPHP.md) for development vs production setup, including **FrankenPHP worker mode** for production.

Development
-----------

[](#development)

```
make up
make test-coverage-100
make phpstan
```

Documentation
-------------

[](#documentation)

- [GitHub Actions CI requirements](docs/GITHUB_CI.md)
- [Installation](docs/INSTALLATION.md)
- [Configuration](docs/CONFIGURATION.md)
- [Usage](docs/USAGE.md)
- [Contributing](docs/CONTRIBUTING.md)
- [Code of Conduct](CODE_OF_CONDUCT.md)
- [Changelog](docs/CHANGELOG.md)
- [Upgrading](docs/UPGRADING.md)
- [Release](docs/RELEASE.md)
- [Security](docs/SECURITY.md)
- [Engram](docs/ENGRAM.md)
- [Spec-driven development](docs/SPEC-DRIVEN-DEVELOPMENT.md)
- [GitHub Spec Kit](docs/SPEC-KIT.md)

### Additional documentation

[](#additional-documentation)

- [Demo with FrankenPHP](docs/DEMO-FRANKENPHP.md)
- [Baseline product spec](specs/001-baseline/spec.md)
- [Code inventory](specs/001-baseline/code-inventory.md)

Tests and coverage
------------------

[](#tests-and-coverage)

- **PHP:** 100% line coverage on `src/` (verified via `make test-coverage-100`)
- **Compatibility:** PHP 8.2+ · Symfony 7.4 / 8.x (CI matrix)

Package
-------

[](#package)

- **Composer:** `nowo-tech/user-kit-bundle`
- **Config root:** `nowo_user_kit`

###  Health Score

48

—

FairBetter than 94% of packages

Maintenance97

Actively maintained with recent releases

Popularity19

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 55.3% 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 ~3 days

Total

10

Last Release

19d ago

### Community

Maintainers

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

---

Top Contributors

[![HecFranco](https://avatars.githubusercontent.com/u/24323276?v=4)](https://github.com/HecFranco "HecFranco (21 commits)")[![actions-user](https://avatars.githubusercontent.com/u/65916846?v=4)](https://github.com/actions-user "actions-user (9 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (8 commits)")

---

Tags

frankenphpphpsecuritysymfonysymfony-bundleuser-managementphpsymfonysecurityfrankenphpSymfony Bundlepresenceuser-checkerlast-activitydisabled-account

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/nowo-tech-user-kit-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/nowo-tech-user-kit-bundle/health.svg)](https://phpackages.com/packages/nowo-tech-user-kit-bundle)
```

###  Alternatives

[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k18.7M445](/packages/easycorp-easyadmin-bundle)[2lenet/crudit-bundle

The easy like Crud'it Bundle.

1718.2k18](/packages/2lenet-crudit-bundle)[contao/core-bundle

Contao Open Source CMS

1231.7M3.2k](/packages/contao-core-bundle)[sulu/sulu

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

1.4k1.4M241](/packages/sulu-sulu)[pimcore/pimcore

Content &amp; Product Management Framework (CMS/PIM/E-Commerce)

3.8k4.0M552](/packages/pimcore-pimcore)[sylius/sylius

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

8.5k6.1M794](/packages/sylius-sylius)

PHPackages © 2026

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