PHPackages                             bvisonl/inactivity-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. bvisonl/inactivity-bundle

ActiveLibrary

bvisonl/inactivity-bundle
=========================

Symfony2 Bundle to handle user Inactivity and Session idle time outs

v1.0.0(8y ago)032MITPHPPHP >=5.6.0

Since Aug 13Pushed 8y ago1 watchersCompare

[ Source](https://github.com/bvisonl/inactivity-bundle)[ Packagist](https://packagist.org/packages/bvisonl/inactivity-bundle)[ RSS](/packages/bvisonl-inactivity-bundle/feed)WikiDiscussions master Synced 2d ago

READMEChangelogDependencies (2)Versions (2)Used By (0)

BvisonlInactivityBundle
=======================

[](#bvisonlinactivitybundle)

Introduction
------------

[](#introduction)

The purpose of this bundle is to provide a "better" way of handling the log in session of an User in Symfony2. While handling multiple tabs opened and client idletime.

I have to thank () for giving me the ideas of how to implement this. Sadly, that bundle was not working properly for me and also it just covered the client part of the issue that I was having so I decided to just make something that merged both client and server.

Pre-requisites
--------------

[](#pre-requisites)

This bundle depends on store.js ==>

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

[](#installation)

1. Install via composer

```
composer require bvisonl/inactivitybundle 1.x

```

2. Add to the AppKernel

```
 public function registerBundles()
    {
        $bundles = array(
        ...
        new Bvisonl\InactivityBundle\BvisonlInactivityBundle(),
        ...
        );
    }

```

3. Define the *bvisonl\_session\_timeout* parameter in your parameters.yml

```
parameters:
    bvisonl_session_lifetime: 300 # 5 minutes

```

If you are using the *cookie\_lifetime*, set it up to a very high value in your config.yml:

```
session:
    ...
    cookie_lifetime: 300000000000 # Set this value high enough and let the bundle handle the session inactivity

```

Also, if you intend to use this parameter in your HTML (as shown below). You must define it in your twig globals in your config.yml:

```
# Twig Configuration
twig:
    ...
    globals:
        bvisonl_session_lifetime: "%bvisonl_session_lifetime%"

```

4. Add the javascript somewhere in your HTML (i.e. in the base.html.twig)

```
{% javascripts '@BvisonlInactivityBundle/Resources/public/js/inactivity.handler.js' %}

{% endjavascripts %}

```

5. Configure the JS plugin to check for user activity

```

    $(document).ready(function() {
        $.fn.bvisonlInactivityHandler({
            // This is the default configuration, in reality no parameter is required but check that the defaults are ok for you
            sessionTimeout: {{ bvisonl_session_lifetime }}, // Default is 300 (5 minutes)
            logoutUrl: "{{ path('fos_user_security_logout') }}", // Default is "/"
            pingServer: true, // Default is false
            pingUrl: '/bvisonl/inactivity/ping', // Url to ping to keep session alive in the server, MUST RETURN A 204 response
            pingInterval: {{ bvisonl_session_lifetime/2 }}, // Default is 150
            events: 'click keypress scroll wheel mousewheel mousemove keyup', // Default events to check on the browser
        });
    })

```

6. Add the routes of the bundle in the routing.yml if using default ping function:

```
# BvisonlInactivityBundle Routes
bvisonl_inactivity:
    resource: "@BvisonlInactivityBundle/Resources/config/routing.yml"

```

7. Remember to clear your cache, install assets, and if using assetic to install them as well

```
php app/console assets:install --env=dev
php app/console assetic:dump --env=dev
php app/console cache:clear --env=dev

```

How it works
------------

[](#how-it-works)

Basically, if configured as shown above, the process divides itself in 2:

#### ~ Server

[](#-server)

On the server, there is a listener that keeps...well...listening the last time a session was used, and compares it to the session\_lifetime parameter. If the session should be destroyed, then it will be destroyed. Simple enough for the server.

#### ~ Client

[](#-client)

In Symfony2, if you do not affect the session for a configurable amount of time, the session will be destroyed and you won't be able to perform any requests to any secured route. However, let's say that an user is analyzing a very complex report on screen scrolling around and you have the lifetime of your session to 5 minutes, when the user finishes working on the report and attempts to move around the app. On the next request, Symfony2 will re-route the user to the login screen.

To solve this, the plugin takes care of tracking the configured events and maintaining timers (using the store.js). Also, in conjunction with the pingServer functionality, the client will keep pinging the server (which should return a 204, 200 is no good since Symfony2 may return code 200 when redirecting the request to the login screen, if you use the default settings you shouldn't worry about this) everytime the client pings the server, it tells Symfony2's session that the user is still active therefore it won't log them off.

Todo
----

[](#todo)

- Maybe: Add dialog window before logging out

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity58

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

Unknown

Total

1

Last Release

3195d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/6f99006c1166f9b227007df67d7faffae12c93ab67794f37a5fce71feabf27df?d=identicon)[bvisonl](/maintainers/bvisonl)

---

Top Contributors

[![bvisonl](https://avatars.githubusercontent.com/u/4421747?v=4)](https://github.com/bvisonl "bvisonl (11 commits)")

### Embed Badge

![Health badge](/badges/bvisonl-inactivity-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/bvisonl-inactivity-bundle/health.svg)](https://phpackages.com/packages/bvisonl-inactivity-bundle)
```

###  Alternatives

[sylius/sylius

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

8.4k5.6M651](/packages/sylius-sylius)[sulu/sulu

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

1.3k1.3M152](/packages/sulu-sulu)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[scheb/2fa

Two-factor authentication for Symfony applications (please use scheb/2fa-bundle to install)

578630.7k1](/packages/scheb-2fa)[auth0/symfony

Symfony SDK for Auth0 Authentication and Management APIs.

128738.1k](/packages/auth0-symfony)[sulu/skeleton

Project template for starting your new project based on the Sulu content management system

29733.3k](/packages/sulu-skeleton)

PHPackages © 2026

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