laravel activitylog

spatie/laravel-activitylog包提供了易于使用的功能来记录应用程序用户的活动。它还可以自动记录模型事件。包将所有活动存储在activity_log表中。

以下是如何使用它的演示：

 activity ()-> log ( ' Look, I logged something ' );

您可以使用SpatieActivitylogModelsActivity模型检索所有活动。

Activity:: all ();

这是一个更高级的示例：

 activity ()
   -> performedOn ( $ anEloquentModel )
   -> causedBy ( $ user )
   -> withProperties ([ ' customProperty ' => ' customValue ' ])
   -> log ( ' Look, I logged something ' );

$ lastLoggedActivity = Activity:: all ()-> last ();

$ lastLoggedActivity -> subject ; //returns an instance of an eloquent model
$ lastLoggedActivity -> causer ; //returns an instance of your user model
$ lastLoggedActivity -> getExtraProperty ( ' customProperty ' ); //returns 'customValue'
$ lastLoggedActivity -> description ; //returns 'Look, I logged something'

这是事件日志记录的示例。

 $ newsItem -> name = ' updated name ' ;
$ newsItem -> save ();

//updating the newsItem will cause the logging of an activity
$ activity = Activity:: all ()-> last ();

$ activity -> description ; //returns 'updated'
$ activity -> subject ; //returns the instance of NewsItem that was saved

调用$activity->changes()将返回此数组：

[
   ' attributes ' => [
        ' name ' => ' updated name ' ,
        ' text ' => ' Lorum ' ,
    ],
    ' old ' => [
        ' name ' => ' original name ' ,
        ' text ' => ' Lorum ' ,
    ],
];

支持我们

我们投入了大量资源来创建一流的开源包。您可以通过购买我们的一款付费产品来支持我们。

我们非常感谢您从家乡寄给我们一张明信片，并注明您正在使用我们的哪种套餐。您可以在我们的联系页面上找到我们的地址。我们在虚拟明信片墙上发布所有收到的明信片。

文档

您可以在 https://spatie.be/docs/laravel-activitylog/introduction 上找到文档。

发现自己在使用该包时陷入困境？发现错误？您对改进活动日志有一般性问题或建议吗？请随意在 GitHub 上创建问题，我们将尽力尽快解决它。

安装

您可以通过 Composer 安装该软件包：

composer require spatie/laravel-activitylog

该包将自动注册。

您可以通过以下方式发布迁移：

php artisan vendor:publish --provider= " SpatieActivitylogActivitylogServiceProvider " --tag= " activitylog-migrations "

注意：默认迁移假设您使用整数作为模型 ID。如果您使用 UUID 或某种其他格式，请先调整已发布迁移中的 subject_id 和 Causer_id 字段的格式，然后再继续。

发布迁移后，您可以通过运行迁移来创建activity_log表：

php artisan migrate

您可以选择使用以下方式发布配置文件：

php artisan vendor:publish --provider= " SpatieActivitylogActivitylogServiceProvider " --tag= " activitylog-config " 

变更日志

有关最近更改的更多信息，请参阅变更日志。

升级中

详情请参阅升级。

测试

composer test 

贡献

详细信息请参阅贡献。

安全

如果您发现有关安全的错误，请发送邮件至 [email protected]，而不是使用问题跟踪器。

制作人员

• 弗里克·范德赫滕
• 塞巴斯蒂安·德·戴因
• 汤姆·维特科斯基
• 所有贡献者

特别感谢 Caneco 的徽标和 Ahmed Nagi 在v4中所做的所有工作。

执照

麻省理工学院许可证 (MIT)。请参阅许可证文件以获取更多信息。