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)。請參閱許可證文件以獲取更多資訊。