PHPackages                             rlb/active-users - 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. rlb/active-users

ActiveLibrary

rlb/active-users
================

A Laravel Package for easily retrieving a list of active users and guests that are currently online.

2.1(5y ago)014MITPHPPHP &gt;=7.2

Since Sep 11Pushed 4y agoCompare

[ Source](https://github.com/rafaelbaiolim/active-users)[ Packagist](https://packagist.org/packages/rlb/active-users)[ Docs](https://github.com/joshrainwater/active-users)[ RSS](/packages/rlb-active-users/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (1)Dependencies (4)Versions (4)Used By (0)

A Laravel Package for easily retrieving a list of active users and guests that are currently online.
====================================================================================================

[](#a-laravel-package-for-easily-retrieving-a-list-of-active-users-and-guests-that-are-currently-online)

This is a small, simple little package for seeing who's currently online.

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

[](#installation)

Install via composer with:

```
composer require joshrainwater/active-users

```

Setup
-----

[](#setup)

### Sessions and Database

[](#sessions-and-database)

For now, this package only supports the 'database' type for session storage. Open your .env file and change the session driver to database:

```
SESSION_DRIVER=database

```

and also make sure to publish the default session table with:

```
php artisan session:table

php artisan migrate

```

### Providers and Aliases

[](#providers-and-aliases)

In order to use the Active class, reference the full vendor namespace, or just import the class at the top of the file that you want to use it in. Eg:

```
\Rainwater\Active\Active::users();

```

or

```
use Rainwater\Active\Active;
Active::users();

```

This package also includes a provider and alias to make things easier. To set those up properly, open `config/app.php` and add this to your providers array:

```
Rainwater\Active\ActiveServiceProvider::class

```

and this to your aliases array:

```
'Active' => Rainwater\Active\ActiveFacade::class

```

Usage
-----

[](#usage)

### Grabbing Most Recent Activities

[](#grabbing-most-recent-activities)

Import the Active facade at the top and then do a simple query.

```
// Import at the top
use Active;

// Find latest users
$users = Active::users()->get();

// Loop through and echo user's name
foreach ($users as $activity) {
    echo $activity->user->name . '';
}

```

By default, the 'users' method will return users that have been active in the past 5 minutes. If you want to display a different timespan, use the following functions:

```
$users = Active::users(3)->get();   				// Last 3 minutes
$users = Active::usersWithinSeconds(30)->get();  	// Get active users within the last 30 seconds
$users = Active::usersWithinMinutes(10)->get();  	// Get active users within the last 10 minutes
$users = Active::usersWithinHours(1)->get();     	// Get active users within the last 1 hour

```

The functions listed above all return Eloquent Queries, so you can do anything with the results that would do with any other model:

```
$numberOfUsers = Active::users()->count();        // Count the number of active users

```

### Sorting Methods

[](#sorting-methods)

There are a couple convenience methods for sorting results, as well:

```
$users = Active::users()->mostRecent()->get();   // Get active users and sort them by most recent
$users = Active::users()->orderByUsers('email')->get(); // Sort by the email column on the users table.

```

### Guests

[](#guests)

You can also view online guests with all the same methods as users above:

```
$guests = Active::guests(1)->get();   				// Last 1 minute
$guests = Active::guests(3)->get();   				// Last 3 minutes
$guests = Active::guestsWithinSeconds(30)->get();  	// Get active guests within the last 30 seconds
$guests = Active::guestsWithinMinutes(10)->get();  	// Get active guests within the last 10 minutes
$guests = Active::guestsWithinHours(1)->get();     	// Get active guests within the last 1 hour

$numberOfGuests = Active::guests()->count();      // Count the number of active guests

```

Many thanks to [thomastkim/laravel-online-users](https://github.com/thomastkim/laravel-online-users) on which this is very heavily based.

License
-------

[](#license)

This package is free software distributed under the terms of the MIT license.

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~324 days

Total

3

Last Release

1792d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/927db3c849b9f65ac7062d6e94456dc76c65b7f1831643e42709ebce36bdc8d1?d=identicon)[rafaelbaiolim](/maintainers/rafaelbaiolim)

---

Top Contributors

[![rafaelbaiolim](https://avatars.githubusercontent.com/u/8842898?v=4)](https://github.com/rafaelbaiolim "rafaelbaiolim (3 commits)")[![divdax](https://avatars.githubusercontent.com/u/1456739?v=4)](https://github.com/divdax "divdax (2 commits)")[![jeremykenedy](https://avatars.githubusercontent.com/u/6244570?v=4)](https://github.com/jeremykenedy "jeremykenedy (2 commits)")[![Dylan-DPC](https://avatars.githubusercontent.com/u/99973273?v=4)](https://github.com/Dylan-DPC "Dylan-DPC (1 commits)")[![Holonist](https://avatars.githubusercontent.com/u/8386455?v=4)](https://github.com/Holonist "Holonist (1 commits)")

---

Tags

phplaravelonline activityactive uesrs

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/rlb-active-users/health.svg)

```
[![Health](https://phpackages.com/badges/rlb-active-users/health.svg)](https://phpackages.com/packages/rlb-active-users)
```

###  Alternatives

[maatwebsite/excel

Supercharged Excel exports and imports in Laravel

12.7k144.3M712](/packages/maatwebsite-excel)[larastan/larastan

Larastan - Discover bugs in your code without running it. A phpstan/phpstan extension for Laravel

6.4k43.5M5.2k](/packages/larastan-larastan)[monicahq/laravel-cloudflare

Add Cloudflare ip addresses to trusted proxies for Laravel.

3372.7M4](/packages/monicahq-laravel-cloudflare)[joshrainwater/active-users

A Laravel Package for easily retrieving a list of active users and guests that are currently online.

9119.8k](/packages/joshrainwater-active-users)[glushkovds/phpclickhouse-laravel

Adapter of the most popular library https://github.com/smi2/phpClickHouse to Laravel

2031.2M2](/packages/glushkovds-phpclickhouse-laravel)[tzsk/otp

A secure, database-free One-Time Password (OTP) generator and verifier for PHP and Laravel.

241641.4k1](/packages/tzsk-otp)

PHPackages © 2026

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