Laravel Filament私有磁盘文件上传后无法下载的解决方案咨询

因为私有磁盘的文件存储在storage/app/documents目录下，该目录不在Web可直接访问的public目录范围内，所以无法通过普通URL直接下载。要实现私有文件的安全下载，需要通过Laravel的控制器来处理文件输出，并控制访问权限。

步骤1：自定义Filament文件上传组件的下载链接 #

修改Filament资源中的FileUpload组件，使用getDownloadUrlUsing方法指定自定义的下载路由：

FileUpload::make('aadhar')
    ->disk('documents')
    ->directory('aadhar')
    ->visibility('private')
    ->maxSize(512)
    ->enableDownload()
    ->enableOpen()
    ->preserveFilenames()
    ->getDownloadUrlUsing(function ($record) {
        // 生成指向下载控制器的路由，传递记录ID
        return route('download-aadhar', ['record' => $record->id]);
    })

步骤2：创建下载控制器 #

生成一个控制器来处理文件下载逻辑：

php artisan make:controller DownloadController

在控制器中添加下载方法，验证用户权限并返回文件响应：

namespace App\Http\Controllers;

use App\Models\YourModel; // 替换为你的实际模型类
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Storage;

class DownloadController extends Controller
{
    public function aadhar(Request $request)
    {
        // 确保用户已认证（Filament默认已处理，可根据需求添加额外权限校验）
        $this->authorize('view', YourModel::class);

        // 查找对应记录
        $record = YourModel::findOrFail($request->record);
        
        // 获取数据库中存储的文件路径
        $filePath = $record->aadhar;

        // 检查文件是否存在
        if (!Storage::disk('documents')->exists($filePath)) {
            abort(404, '文件不存在');
        }

        // 返回文件下载响应，自动处理文件名和MIME类型
        return Storage::disk('documents')->download($filePath);
    }
}

步骤3：添加下载路由 #

在routes/web.php中注册下载路由，并添加认证中间件确保只有授权用户可访问：

use App\Http\Controllers\DownloadController;

Route::get('/download/aadhar/{record}', [DownloadController::class, 'aadhar'])
    ->name('download-aadhar')
    ->middleware('auth');

关键说明 #

• 这种方式通过控制器封装文件访问逻辑，你可以在控制器中添加额外的权限校验（比如检查用户是否有权限查看该记录的文件），确保文件的安全性。
• 不要将私有磁盘的目录软链接到public目录，这会破坏私有性，所有用户都能直接访问文件。

内容的提问来源于stack exchange，提问作者MADHAN PRASATH A