geisi / laravel-db-session-helper
This package is build on top of the Laravel session database driver. With it you are able to query users by their login state.
Fund package maintenance!
geisi
Requires
- php: ^7.4|^8.0
- illuminate/auth: ^8.0
- illuminate/container: ^8.0
- illuminate/contracts: ^8.0
- illuminate/database: ^8.42
- spatie/laravel-package-tools: ^1.4.3
Requires (Dev)
- brianium/paratest: ^6.3
- nunomaduro/collision: ^5.3
- orchestra/testbench: ^6.0
- phpunit/phpunit: ^8.0|^9.0
- predis/predis: ^1.1
- vimeo/psalm: ^4.8
This package is auto-updated.
Last update: 2024-10-29 06:36:23 UTC
README
⚠️ Laravel DB Session Helper is under development - use at your own risk.
Laravel helper package for the database session driver
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.
Installation
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"
Usage
//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
Requirements
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.
Configuration
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.
Beta
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.
Testing
composer test
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security Vulnerabilities
Please review our security policy on how to report security vulnerabilities.
Credits
License
The MIT License (MIT). Please see License File for more information.