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

tinkerwell logo
Tinkerwell

Enjoy coding and debugging in an editor designed for fast feedback and quick iterations. It's like a shell for your application – but with multi-line editing, code completion, and more.

Visit Tinkerwell

The latest

View all →
CPX: The Composer Package Executor for PHP image

CPX: The Composer Package Executor for PHP

Read article
Laravel AI SDK Adds Human-in-the-Loop Tool Approval image

Laravel AI SDK Adds Human-in-the-Loop Tool Approval

Read article
Pest 5 Released With Test Impact Analysis, Agent Verification, and Evals image

Pest 5 Released With Test Impact Analysis, Agent Verification, and Evals

Read article
Queue-SQL: Run Mass Deletes and Updates Across Parallel Queue Jobs image

Queue-SQL: Run Mass Deletes and Updates Across Parallel Queue Jobs

Read article
Blade Formatting in Laravel Pint image

Blade Formatting in Laravel Pint

Read article
Inertia DevTools Is Now on the Chrome Web Store image

Inertia DevTools Is Now on the Chrome Web Store

Read article