This package adds some niceties when using the database session driver in Laravel Projects. Its main purpose is to be able to filter users by their online state.
It integrates well with Laravel Jetstream applications.
You can install the package via composer:
composer require geisi/laravel-db-session-helper
First add HasDatabaseSessions trait to your User model(s):
//User.php
use Illuminate\Foundation\Auth\User as Authenticatable;
use Geisi\LaravelDbSessionHelper\Traits\HasDatabaseSessions
class User extends Authenticatable
{
use HasDatabaseSessions;
// ...
}
You can publish the config file with:
php artisan vendor:publish --provider="Geisi\LaravelDbSessionHelper\LaravelDbSessionHelperServiceProvider"
//Query all online users
\App\Models\User::isOnline()->get();
//Query all offline users
\App\Models\User::isOffline()->get();
//Get user online state
var_dump($user->is_online);
// true or false
//Get user last login date
var_dump($user->last_login);
// Carbon instance
To be able to run this package you need Laravel >= 8.42.x and PHP => 7.4 or PHP 8.0. In order to query the users session data the database session driver is needed.
By default the time span to determine if a user is online or offline is 10 minutes. So if a user does not interact with your application within 10 minutes he is gonna be queried as offline.
You can change this timespan with the login_time_span configuration value.
You can extend or replace our Session model with your own. The only necessary thing to do is to implement the Geisi\LaravelDbSessionHelper\Contracts\Session contract interface.
This package is currently in Beta state. As we cannot guarantee 100% stability and feature safety we don't recommend using this package in production. Please submit possible bugs under issues.
composer test
Please see CHANGELOG for more information on what has changed recently.
Please see CONTRIBUTING for details.
Please review our security policy on how to report security vulnerabilities.
The MIT License (MIT). Please see License File for more information.