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 " 

変更履歴

最近の変更の詳細については、CHANGELOG を参照してください。

アップグレード中

詳細については、「アップグレード」を参照してください。

テスト

composer test 

貢献する

詳細については、「貢献」を参照してください。

安全

セキュリティに関するバグを見つけた場合は、問題トラッカーを使用する代わりに [email protected] にメールを送信してください。

クレジット

• フリーク・ファン・デル・ヘルテン
• セバスチャン・デ・デイン
• トム・ウィトコウスキー
• すべての貢献者

そして、ロゴを作成してくれた Caneco と、 v4に費やしたすべての作業に対して Ahmed Nagi に特別な感謝を捧げます。

ライセンス

MIT ライセンス (MIT)。詳細については、ライセンス ファイルを参照してください。