Laravel AuditingGetting Audits
Audit records can be fetched very easily, via Eloquent relations.
Retrieving audit records
Using an Article model example, here's how it works:
php
// Get first available Article
$article = Article::first();
// Get all associated Audits
$all = $article->audits;
// Get first Audit
$first = $article->audits()->first();
// Get last Audit
$last = $article->audits()->latest()->first();
// Get Audit by id
$audit = $article->audits()->find(4);
Getting audit records with the associated User model
php
// Get all associated Audits
$all = $article->audits()->with('user')->get();
TIP
Remember to properly set the User morph_prefix and guards in the config/audit.php file.
Getting the Audit metadata
Retrieve an array with the Audit metadata.
php
// Get first available Article
$article = Article::first();
// Get latest Audit
$audit = $article->audits()->latest()->first();
var_dump($audit->getMetadata());
Output:
php
array(10) {
["audit_id"]=>
string(1) "1"
["audit_event"]=>
string(7) "updated"
["audit_url"]=>
string(26) "http://example.com/articles/1"
["audit_ip_address"]=>
string(9) "127.0.0.1"
["audit_user_agent"]=>
string(68) "Mozilla/5.0 (X11; Linux x86_64; rv:53.0) Gecko/20100101 Firefox/53.0"
["audit_tags"]=>
string(7) "foo,bar"
["audit_created_at"]=>
string(19) "2017-01-01 01:02:03"
["audit_updated_at"]=>
string(19) "2017-01-01 01:02:03"
["user_id"]=>
string(1) "1"
["user_type"]=>
string(8) "App\User"
}
Getting the modified properties
Get an array with the modified properties of the Auditable model. The data includes the old and new values for each attribute.
php
// Get first available Article
$article = Article::first();
// Get latest Audit
$audit = $article->audits()->latest()->first();
var_dump($audit->getModified());
Output:
php
array(2) {
["title"]=>
array(2) {
["new"]=>
string(28) "How To Audit Eloquent Models"
["old"]=>
string(19) "How to audit models"
}
["content"]=>
array(2) {
["new"]=>
string(62) "First, let's start by installing the laravel-auditing package."
["old"]=>
string(16) "This is a draft."
}
}
INFO
By default, Audit records will be sorted by created_at in ascending order (oldest to newest).