使用 Laravel 的 finally 方法优雅地进行管道(Pipeline)清理

Laravel 中的管道清理通过新的 finally 方法变得更加优雅。这一新增函数添加简化了管道流水线之后的处理方式，无论管道是成功还是失败。

传统上，管理管道中的清理操作需要将管道包裹在 try-finally 块中。Laravel 的新 finally 方法通过将清理直接集成到管道链中来简化这一过程，使代码更具可读性和可维护性。

让我们看看它是如何工作的：

$result = Pipeline::send($deployment)
    ->through([PipeOne::class, PipeTwo::class])
    ->finally(fn () => /** perform cleanup */)
    ->then(fn () => $deployment->deploy());

真实示例

下例是部署系统中可能用到的示例：

class DeploymentManager
{
    public function deploy(Deployment $deployment)
    {
        return Pipeline::send($deployment)
            ->through([
                ValidateEnvironment::class,
                BackupCurrentState::class,
                UpdateDependencies::class,
                RunMigrations::class
            ])
            ->finally(function () use ($deployment) {
                // Always cleanup temporary files
                Storage::delete("temp/{$deployment->id}");
                
                // Release deployment lock
                Cache::forget("deployment-lock:{$deployment->id}");
                
                // Log completion timestamp
                $deployment->update(['completed_at' => now()]);
            })
            ->then(fn () => $this->finalizeDeployment($deployment));
    }

    protected function finalizeDeployment(Deployment $deployment)
    {
        return [
            'status' => 'completed',
            'deployment_id' => $deployment->id
        ];
    }
}

传统的 try-finally 块相比，finally 方法具有几个优点。它将你的清理逻辑保留在管道链中，使代码流更自然、更容易遵循。在处理需要适当资源清理的复杂操作时，这一点尤其有价值。

将其视为管道的内置清理处理程序(handler)——它确保你的清理代码无论管道是成功、失败还是中断都能运行。这在以下情况下特别有用：

• 管理临时资源
• 释放锁或信号
• 清理临时文件
• 更新状态记录
• 日志记录完成状态

例如，如果你的部署过程创建了临时文件或获取了锁，即使在部署过程中发生错误，finally 方法也会确保这些文件被清理干净。