Laravel Tutorials

Streamline Pipeline Cleanup with Laravel's finally Method

Published
Streamline Pipeline Cleanup with Laravel's finally Method image

Laravel enhances pipeline management with the introduction of the finally method, offering a more elegant approach to handling post-pipeline operations regardless of success or failure outcomes.

Managing cleanup operations in Laravel pipelines previously required wrapping pipeline logic in try-finally blocks. The new finally method integrates cleanup directly into the pipeline chain, creating more readable and maintainable code:

$result = Pipeline::send($order)
->through([StepOne::class, StepTwo::class])
->finally(fn () => /** perform cleanup */)
->then(fn () => $order->process());

This approach particularly shines in complex operations that require guaranteed resource cleanup:

class OrderProcessor
{
public function process(Order $order)
{
return Pipeline::send($order)
->through([
ValidateInventory::class,
CalculateShipping::class,
ProcessPayment::class,
UpdateInventory::class
])
->finally(function () use ($order) {
// Always release inventory holds
InventoryManager::releaseHolds($order->id);
 
// Clear processing lock
Cache::forget("order-processing:{$order->id}");
 
// Update order status timestamp
$order->update(['processed_at' => now()]);
 
// Send notification regardless of outcome
event(new OrderProcessingCompleted($order));
})
->then(fn () => $this->completeOrder($order));
}
 
protected function completeOrder(Order $order)
{
return [
'status' => 'processed',
'order_id' => $order->id,
'total' => $order->total
];
}
}

The finally method offers several advantages over traditional try-finally blocks. It maintains cleanup logic within the pipeline flow, creating more natural code progression that's easier to follow. This approach proves especially valuable when handling complex operations requiring proper resource management.

Harris Raftopoulos photo

Senior Software Engineer • Staff & Educator @ Laravel News • Co-organizer @ Laravel Greece Meetup

Sponsored

acquaintsoft logo
Acquaint Softtech

Hire Laravel developers with AI expertise at $20/hr. Get started in 48 hours.

Visit Acquaint Softtech

The latest

View all →
NativePHP v4: Build Native iOS and Android UI in Blade image

NativePHP v4: Build Native iOS and Android UI in Blade

Read article
Laravel Lock: Distributed Locks for Models and Routes image

Laravel Lock: Distributed Locks for Models and Routes

Read article
Laravel Image Responses: Serve Resized Images From Routes image

Laravel Image Responses: Serve Resized Images From Routes

Read article
Pause All Laravel Queues During a Deploy image

Pause All Laravel Queues During a Deploy

Read article
Laravel Terminal UI for the artisan dev Command image

Laravel Terminal UI for the artisan dev Command

Read article
Pause All Queues and a New artisan dev UI in Laravel 13.25 image

Pause All Queues and a New artisan dev UI in Laravel 13.25

Read article