Add withoutAuditing() callback method to temporarily disable auditing for one class

[derekmd]

Summary

Similar to Laravel's Model::withoutEvents() method, allow running Eloquent queries on a given model class inside a callback:

User::withoutAuditing(function () use ($user, $inputs, $additional) {
    // no audit
    $user->update($inputs);

    // this _will_ be audited if the Profile class is Auditable
    $user->profile()->updateOrCreate([], $additional);
});

Only the {class}::withoutAuditing() class will have auditing disabled, so additional model classes need their own call. e.g.,

User::withoutAuditing(fn () => $user->update($inputs));
Profile::withoutAuditing(fn () => $user->profile()->updateOrCreate([], $additional));

---

1. It's wrapped in try / finally to handle restoring auditing after Eloquent possibly throws QueryException.
2. If auditing is already disabled, that setting will be kept. i.e., don't call enableAuditing()

Links

• https://laravel.com/docs/11.x/eloquent#muting-events
• https://github.com/laravel/framework/blob/6c9cbc9ba0437bcfe54609ae0af312feefc7e309/src/Illuminate/Database/Eloquent/Concerns/HasEvents.php#L426-L441
• https://github.com/laravel/framework/blob/e307d111c22066ef614a112664724b4db4956968/src/Illuminate/Support/Traits/Localizable.php#L16 Another example using the same design pattern.

[willpower232]

I don't hate this but I must ask, since this package makes use of Laravel events, could you not make use of ::withoutEvents() or ->saveQuietly() to achieve the same thing?

[derekmd]

You can but that will also prevent other event listeners from being invoked. This method would allow only disabling audit callbacks.

[anteriovieira]

Could someone please update the documentation? You could follow the idea from the Laravel documentation.

https://laravel.com/docs/11.x/eloquent#muting-events

[willpower232]

@derekmd would you like the honours? https://github.com/owen-it/laravel-auditing.com/ perhaps something under the advanced section?