Backpack for Laravel 如何添加自定义操作实现文件下载功能？

两种实现方式都可用，按需选择即可，优先推荐Backpack规范的Operation写法，方便后续复用和统一权限管理。

方案1：遵循Backpack规范实现DownloadOperation（推荐） #

• 第一步：在对应的CRUD控制器中添加setupDownloadOperation初始化方法

public function setupDownloadOperation()
{
    // 按需配置操作权限
    $this->crud->allowAccess('download');

    // 在列表行末尾添加下载按钮，按钮模板需自行创建
    $this->crud->addButton('line', 'download', 'view', 'crud.buttons.download', 'end');
}

对应的按钮模板文件路径为resources/views/vendor/backpack/crud/buttons/download.blade.php，内容参考：

<a href="{{ route('crud.your-crud.download', $entry->getKey()) }}" class="btn btn-sm btn-outline-primary">
    <i class="la la-download"></i> 下载
</a>

• 第二步：添加下载逻辑处理方法

public function download($id)
{
    // 校验操作权限，非必需但建议添加
    $this->crud->hasAccessOrFail('download');

    // 获取当前条目数据
    $entry = $this->crud->getEntry($id);
    
    // 自定义下载逻辑，示例为返回本地存储的文件
    return response()->download(storage_path('app/'.$entry->file_path), $entry->file_name);
}

• 第三步：添加对应路由
  在routes/backpack/custom.php中注册路由，和Backpack其他CRUD路由保持统一管理：

Route::get('your-crud-route/{id}/download', [YourCrudController::class, 'download'])->name('crud.your-crud.download');

方案2：Laravel原生路由实现（适用于临时需求） #

如果是不需要复用的简单下载场景，可以直接用Laravel原生写法，不需要遵循Backpack的Operation规范：

• 直接在路由文件中添加路由和逻辑，记得添加backpack.auth中间件保证接口安全：

Route::get('custom-download/{id}', function ($id) {
    $entry = \App\Models\YourModel::findOrFail($id);
    // 自定义下载逻辑
    return response()->download(storage_path('app/'.$entry->file_path));
})->middleware('backpack.auth');

两种实现方式都建议增加权限校验逻辑，涉及敏感文件的场景可以额外使用Laravel签名路由做访问限制。

内容的提问来源于stack exchange，提问作者realtebo