This is a compilation of common problems and their respective solutions and/or workarounds.
Auditing does not work
You followed the documentation to the letter and yet,
Audit records are not being created?
Builder vs. Eloquent
Bear in mind that this package relies on Eloquent events and if they don't fire, an
Audit cannot be created.
The most common mistake is performing an
delete using a
Builder instance, rather than an using an Eloquent
Builder won't trigger an
Console and Jobs
Eloquent events triggered from the console or from a Job won't be audited by default.
Check the General Configuration to know how to overcome that.
Attributes are considered modified, when they're not
False positives cause Audit records to be created. This happens when model attributes are updated with BOOLEAN and/or DATE values.
The internal data of the Eloquent model will be as follows:
In the $attributes array attribute:
In the $original array attribute:
This makes the
isDirty() methods to consider wrongful attribute changes when comparing data.
According to a maintainer, this is an expected behaviour.
As a workaround, consider passing
0, instead of
false. For date values, append
At the time of writing, this is the only open issue about this subject.
Argument 1 passed to Illuminate\Database\Eloquent\Model::serializeDate() must implement interface DateTimeInterface, null given
This might happen in version 4.1.x, because the
updated_at column values in the
audits table are set to
After upgrading the table schema for 4.1.x, don't forget to set the
updated_at values to match the ones from
Read the Upgrading documentation for more details.