In Laravel, saveQuietly()
is a method available on Eloquent models that allows you to save a model without firing any events, such as creating
, created
, updating
, updated
, and other Eloquent model events. This can be useful in situations where you want to update or save data without triggering any additional actions tied to those events, such as logging, notifications, or data validation.
Here’s a step-by-step guide with a hands-on example of saveQuietly()
in Laravel, including a detailed explanation of each part.
Scenario Example
Imagine you have a User
model, and every time a user is updated, an event triggers that sends a notification to the user. However, in some specific cases (such as admin updates or background maintenance tasks), you may want to update user information silently without triggering this notification.
Steps to Implement saveQuietly()
Step 1: Define the User
Model and Event
In your User
model, you may have event listeners for updating
and updated
events, which get fired when a user is updated.
Example User
model with events:
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
class User extends Model
{
protected $fillable = ['name', 'email', 'status'];
protected static function booted()
{
// Event listener for updating
static::updating(function ($user) {
// Log or handle the update event
\Log::info("User is being updated: {$user->id}");
});
// Event listener for updated
static::updated(function ($user) {
// Example action, such as sending a notification
$user->notify(new \App\Notifications\UserUpdatedNotification());
});
}
}
Here, each time a user is updated:
- The
updating
event will log information about the update. - The
updated
event will send a notification to the user.
Step 2: Update a User Normally
When you update a user using save()
, these events will fire.
Example:
$user = User::find(1);
$user->status = 'active';
$user->save();
Expected Result: The updating
and updated
events are triggered, which means the log entry will be created, and the user will be notified.
Step 3: Using saveQuietly()
to Bypass Events
To avoid triggering these events (e.g., if an admin updates the user status as part of a bulk operation), you can use saveQuietly()
.
Example:
$user = User::find(1);
$user->status = 'inactive';
$user->saveQuietly();
With saveQuietly()
, neither the updating
nor updated
events are fired, meaning:
- No log entry is created for the update.
- No notification is sent to the user.
Step-by-Step Explanation of saveQuietly()
-
Locate the Model: Fetch the model instance you want to update. Here, we use
User::find(1)
to retrieve the user with an ID of 1.
$user = User::find(1);
-
Modify the Model’s Attributes: Change the necessary attributes on the model. For instance, changing the
status
fromactive
toinactive
.
$user->status = 'inactive';
-
Save Without Triggering Events: Use
saveQuietly()
instead ofsave()
. This ensures that noupdating
orupdated
events are fired.
$user->saveQuietly();
When to Use saveQuietly()
saveQuietly()
is beneficial in scenarios like:
- Bulk Updates: When performing mass updates where triggering events could lead to performance issues.
- Admin Overrides: When an admin makes updates that don’t require notifications.
- Background Processes: For scheduled tasks or maintenance scripts that modify records without needing to alert users or log the changes.
- Bypassing Validations/Listeners: When specific updates don’t need to adhere to standard model listeners or validations.
Full Example in Controller
Here’s how you might put this into a Laravel controller to handle admin updates:
namespace App\Http\Controllers;
use App\Models\User;
class AdminController extends Controller
{
public function updateUserStatus($id, $status)
{
$user = User::find($id);
if (!$user) {
return response()->json(['error' => 'User not found'], 404);
}
$user->status = $status;
// Use saveQuietly to avoid firing events
$user->saveQuietly();
return response()->json(['message' => 'User status updated quietly'], 200);
}
}
Summary
-
save()
triggers all associated events, useful for standard updates. -
saveQuietly()
bypasses these events, useful for silent or bulk updates without additional processing.
Using saveQuietly()
can significantly streamline tasks where event handling is unnecessary, giving you greater control over Eloquent model behavior in Laravel.
Top comments (1)
Very userful article!