PHPackages joshrainwater/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. [Utility & Helpers](/categories/utility) 4. / 5. joshrainwater/active-users ActiveLibrary[Utility & Helpers](/categories/utility) joshrainwater/active-users ========================== A Laravel Package for easily retrieving a list of active users and guests that are currently online. 2.1(5y ago)9119.8k—0%31[4 PRs](https://github.com/joshrainwater/active-users/pulls)MITPHPPHP >=7.2 Since Nov 11Pushed 3y ago5 watchersCompare [ Source](https://github.com/joshrainwater/active-users)[ Packagist](https://packagist.org/packages/joshrainwater/active-users)[ Docs](https://github.com/joshrainwater/active-users)[ RSS](/packages/joshrainwater-active-users/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (2)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 38 — LowBetter than 85% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity41 Moderate usage in the ecosystem Community20 Small or concentrated contributor base Maturity60 Established project with proven stability 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 ~525 days Total 3 Last Release 2057d ago Major Versions 1.0.0 → 2.02019-09-11 PHP version history (2 changes)1.0.0PHP >=7.0 2.0PHP >=7.2 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/1697347?v=4)[joshrainwater](/maintainers/joshrainwater)[@joshrainwater](https://github.com/joshrainwater) --- Top Contributors [![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)")[![joshrainwater](https://avatars.githubusercontent.com/u/1697347?v=4)](https://github.com/joshrainwater "joshrainwater (1 commits)")[![KalimeroMK](https://avatars.githubusercontent.com/u/24772657?v=4)](https://github.com/KalimeroMK "KalimeroMK (1 commits)") --- Tags laravelonline-activityphpphplaravelonline activityactive uesrs ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/joshrainwater-active-users/health.svg) ``` [![Health](https://phpackages.com/badges/joshrainwater-active-users/health.svg)](https://phpackages.com/packages/joshrainwater-active-users) ``` ### Alternatives [stevebauman/location Retrieve a user's location by their IP Address 1.3k7.6M65](/packages/stevebauman-location)[monicahq/laravel-cloudflare Add Cloudflare ip addresses to trusted proxies for Laravel. 3372.7M4](/packages/monicahq-laravel-cloudflare)[kra8/laravel-snowflake Snowflake for Laravel and Lumen. 188402.3k6](/packages/kra8-laravel-snowflake)[bezhansalleh/filament-google-analytics Google Analytics integration for FilamentPHP 205144.8k5](/packages/bezhansalleh-filament-google-analytics)[laragear/preload Effortlessly make a Preload script for your Laravel application. 119363.5k](/packages/laragear-preload)[kim/activity Easily retrieve a list of users and guests that are online. 12830.4k](/packages/kim-activity) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)