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

laravelcloud logo
Laravel Cloud

Easily create and manage your servers and deploy your Laravel applications in seconds.

Visit Laravel Cloud

The latest

View all →
Laravel 14 Adds a defaults() Method to Eloquent Models image

Laravel 14 Adds a defaults() Method to Eloquent Models

Read article
Laravel AI SDK and Laravel MCP Security Fixes: Update Now image

Laravel AI SDK and Laravel MCP Security Fixes: Update Now

Read article
Mailbox for Laravel: Preview and Test Rendered Email image

Mailbox for Laravel: Preview and Test Rendered Email

Read article
Count Worker Crashes as Job Exceptions in Laravel 13.34 image

Count Worker Crashes as Job Exceptions in Laravel 13.34

Read article
Elastic Bridge: Eloquent-Style Queries for Elasticsearch and OpenSearch image

Elastic Bridge: Eloquent-Style Queries for Elasticsearch and OpenSearch

Read article
Laravel Release Cycle: Versions, Support Policy, and Dates image

Laravel Release Cycle: Versions, Support Policy, and Dates

Read article