zaichaopan/online-status

A package to show user online status in your laravel app

v0.2-beta 2018-06-21 20:37 UTC

Requires

• php: >=7.1.0
• illuminate/support: ~5.5.0|~5.6.0
• predis/predis: ^1.1

Requires (Dev)

• orchestra/testbench: ^3.5.0
• phpunit/phpunit: ^7.2

MIT

• zaichaopan

• redis
• laravel
• online

README

This packages adds functionality to show user online status, online users and online user number in your laravel app. This package can be used in laravel 5.5 or higher.

Installation

This packages uses redis behind the screen. So please install redis in your machine in order to use package.

composer require zaichaopan/online-status

Usage

• Add HasOnlineStatus trait to your user model

//...
use Zaichaopan\OnlineStatus\HasOnlineStatus;

class User extends Model
{
    use HasOnlineStatus;

}

• Set online expiration time.

This package uses lifetime in config/session.php as the default user online expiration time. If user remains inactive during this time period, he or she will be considered offline. So if you want to customize. you can override it in config/session.php or you can override it in User model as follow

// ...
class User extends Model
{
    use HasOnlineStatus;

    public static function getOnlineExpirationInMinutes(): int
    {
        return 10;
    }
}

• Apply UserOnline Middleware.php

// App\Http\Kernel.php
class Kernel extends HttpKernel
{
    // ...
    protected $middlewareGroups = [
        'web' => [
           \\...
           \Zaichaopan\OnlineStatus\Middleware\UserOnline::class
        ],
        //...
    ];
}

Now when authenticated user makes a web request, his or her online status will be automatically be set.

//
class UserOnline
{
   // ...
    public function handle(Request $request, Closure $next)
    {
        optional($request->user())->online();

        return $next($request);
    }
}

Available Apis

• Get whether user is online:

$status = $user->isOnline;

// or
$status = $user->isOnline();

• Get total online user number

$onlineUserCount = User::onlineCount();

• Get online users

$onlineUsers = User::ofOnline()->get();

// or
$onlineUsers = User::ofOnline()->paginate();

• Set user online

As long as you apply the UserOnline middleware properly, it will automatically set and update authenticated user online status. In case you want to set it manually, you can use online method provided by the trait.

$user->online();

• Set user offline

This package listens for Logout event. When user logs out, it will set user online status as offline. In case you may want to set user offline manually, you can use offline method provided by the trait.

$use->offline();

Events

This packages raises two events during the updating user online status process. You may attach listeners to these two events in your EventServiceProvider:

/**
 * The event listener mappings for the application.
 *
 * @var array
 */
protected $listen = [
    'Zaichaopan\OnlineStatus\Events\Online' => [
        'App\Listeners\Online',
    ],

    'Zaichaopan\OnlineStatus\Events\Offline' => [
        'App\Listeners\Offline',
    ]
];

The Online event will only fire once. It won't fire again if the user is already online