README

使用此包，您可以轻松查看谁正在在线，以及有多少访客正在查看您的网站。

安装

要安装此包，只需按照以下简单步骤进行。

Composer

一如既往，通过在composer.json文件中添加以下内容，通过Composer获取此包：

"kim/activity": "^1.1"

注意：如果您正在运行Laravel 5.0或5.1，请要求版本"^1.0"。

之后，运行composer update。

服务提供商和别名

接下来，打开config/app.php文件，将其添加到您的提供者数组中

Kim\Activity\ActivityServiceProvider::class

并添加到您的别名数组中

'Activity' => Kim\Activity\ActivityFacade::class

会话和数据库设置

最后，您需要更改会话配置以使用数据库。打开位于Laravel项目根目录的.env文件。然后，将您的会话驱动程序更改为数据库。

SESSION_DRIVER=database

如果您正在运行L5.2，请发布默认会话迁移文件，然后运行以下命令进行迁移

php artisan session:table

php artisan migrate

如果您正在运行L5.0或L5.1，请运行以下命令

php artisan vendor:publish --provider="Kim\Activity\ActivityServiceProvider" --tag="migrations"

php artisan migrate

使用

此包将自动更新用户或访客的最新活动。要获取最新用户和访客，可以使用易于使用的内置方法。

获取最新活动

在顶部导入Activity外观，然后进行简单查询。

// Import at the top
use Activity;


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

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

users方法将获取过去5分钟内的最新活动。您可以通过指定分钟数来更改默认的时间跨度。

$activities = Activity::users(1)->get();   // Last 1 minute
$activities = Activity::users(10)->get();  // Last 10 minutes
$activities = Activity::users(60)->get();  // Last 60 minutes

您还有其他方便的方法来按秒或小时获取最新活动。

$activities = Activity::usersBySeconds(30)->get();  // Get active users within the last 30 seconds
$activities = Activity::usersByMinutes(10)->get();  // Get active users within the last 10 minutes
$activities = Activity::usersByHours(1)->get();     // Get active users within the last 1 hour

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

排序方法

为了按最新和最旧排序活动，只需使用mostRecent和leastRecent方法。

$activities = Activity::users()->mostRecent()->get();   // Get active users and sort them by most recent
$activities = Activity::users()->leastRecent()->get();  // Get active users and sort them by least recent

除此之外，您还可以使用orderByUsers方法对用户的属性进行排序。例如，与其按最新活动排序，不如说您想按用户名字母顺序排序。您可以这样做。

$activities = Activity::users()->orderByUsers('email')->get();

获取访客

要获取在线访客的数量，与获取用户一样直观。例如

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

许可证

此包是免费软件，根据MIT许可证条款分发。