如何在Laravel中处理文件下载

use Illuminate\Support\Facades\Response;

// 假设文件在 public 目录下
public function downloadPublicFile()
{
    $filePath = public_path('documents/report.pdf');
    $fileName = '年度报告.pdf'; // 用户下载时看到的文件名
    return Response::download($filePath, $fileName);
}

// 假设文件在 storage/app 目录下，需要先通过 Storage facade 获取路径
// 注意：直接访问 storage 目录的文件是不安全的，应通过控制器处理
public function downloadProtectedFile()
{
    $filePath = storage_path('app/private/secret_doc.docx');
    $fileName = '机密文件.docx';
    if (!file_exists($filePath)) {
        abort(404, '文件不存在。');
    }
    return Response::download($filePath, $fileName);
}

return Response::download($filePath, $fileName, [
    'Content-Type' => 'application/octet-stream',
    'Content-Disposition' => 'attachment; filename="' . $fileName . '"',
]);

use Illuminate\Support\Facades\Storage;

public function downloadFromDisk()
{
    // 假设文件在默认的 'local' disk (storage/app)
    $path = 'invoices/invoice_123.pdf';
    $fileName = '发票_123.pdf';

    if (!Storage::disk('local')->exists($path)) {
        abort(404, '文件不存在。');
    }

    return Storage::disk('local')->download($path, $fileName);

    // 如果是S3等云存储，配置好disk后用法一样
    // return Storage::disk('s3')->download('reports/sales.csv', '销售报告.csv');
}

use Illuminate\Support\Facades\Response;

public function streamDynamicCsv()
{
    $headers = [
        'Content-Type' => 'text/csv',
        'Content-Disposition' => 'attachment; filename="data_export.csv"',
    ];

    $callback = function() {
        $file = fopen('php://output', 'w');
        fputcsv($file, ['ID', '名称', '邮箱']); // CSV header

        // 模拟从数据库获取数据并写入
        for ($i = 1; $i <= 10000; $i++) {
            fputcsv($file, [$i, '用户' . $i, 'user' . $i . '@example.com']);
        }
        fclose($file);
    };

    return Response::streamDownload($callback, 'data_export.csv', $headers);
}

Route::middleware('auth')->group(function () {
    Route::get('/download/report/{id}', [FileController::class, 'downloadReport']);
});

use App\Models\Report;
use Illuminate\Support\Facades\Auth;

public function downloadReport(Report $report) // 假设使用了路由模型绑定
{
    // 检查当前用户是否有权限下载这份报告
    if (Auth::user()->cannot('download', $report)) {
        abort(403, '您无权下载此文件。');
    }

    // 或者更简单的，如果报告属于当前用户
    if ($report->user_id !== Auth::id()) {
        abort(403, '您无权下载此文件。');
    }

    $filePath = storage_path('app/' . $report->file_path); // 假设文件路径存在数据库中
    if (!file_exists($filePath)) {
        abort(404, '文件不存在。');
    }

    return response()->download($filePath, $report->original_name);
}

// 生成一个10分钟有效的预签名URL
$url = Storage::disk('s3')->temporaryUrl(
    'private/document.pdf', now()->addMinutes(10)
);
return redirect($url); // 将用户重定向到这个临时URL进行下载

public function streamLargeLogFile()
{
    $filePath = storage_path('app/large_log.txt');
    if (!file_exists($filePath)) {
        abort(404, '日志文件不存在。');
    }

    $headers = [
        'Content-Type' => 'text/plain',
        'Content-Disposition' => 'attachment; filename="large_log.txt"',
    ];

    $callback = function() use ($filePath) {
        $handle = fopen($filePath, 'r');
        while (!feof($handle)) {
            echo fread($handle, 8192); // 每次读取8KB
            flush(); // 强制输出缓冲区内容
        }
        fclose($handle);
    };

    return response()->streamDownload($callback, 'large_log.txt', $headers);
}

location /protected_files/ {
    internal; # 只能由Nginx内部重定向访问
    alias /path/to/your/storage/app/; # 实际文件路径
}

public function downloadWithNginxAccel()
{
    $filePath = 'private/large_archive.zip'; // 相对于 storage/app 的路径
    $fileName = '大型档案.zip';

    if (!Storage::disk('local')->exists($filePath)) {
        abort(404, '文件不存在。');
    }

    // 假设你的Nginx配置中 /protected_files/ 映射到 storage/app/
    return response()->make('', 200, [
        'X-Accel-Redirect' => '/protected_files/' . $filePath,
        'Content-Type' => 'application/zip',
        'Content-Disposition' => 'attachment; filename="' . $fileName . '"',
    ]);
}

public function downloadFile($fileId)
{
    $file = File::find($fileId); // 假设从数据库获取文件信息

    if (!$file) {
        // 文件不存在
        abort(404, '您请求的文件不存在。');
    }

    if (Auth::user()->cannot('view', $file)) {
        // 用户没有权限
        abort(403, '您没有权限下载此文件。');
    }

    $filePath = storage_path('app/' . $file->path);
    if (!file_exists($filePath)) {
        // 数据库记录存在，但物理文件丢失
        Log::error("File not found on disk: {$filePath} for file ID {$fileId}");
        abort(500, '服务器内部错误：文件暂时无法下载，请稍后再试。');
    }

    return response()->download($filePath, $file->name);
}

use Illuminate\Support\Facades\Log;

public function streamWithErrorHandling()
{
    $filePath = storage_path('app/problematic_file.txt');
    $headers = [
        'Content-Type' => 'text/plain',
        'Content-Disposition' => 'attachment; filename="problematic_file.txt"',
    ];

    $callback = function() use ($filePath) {
        try {
            $handle = fopen($filePath, 'r');
            if (!$handle) {
                throw new \Exception("无法打开文件: {$filePath}");
            }
            while (!feof($handle)) {
                echo fread($handle, 8192);
                flush();
            }
            fclose($handle);
        } catch (\Exception $e) {
            Log::error("文件流下载失败: " . $e->getMessage());
            // 此时可能无法向用户返回友好的HTTP响应，因为头部可能已发送
            // 但至少记录了错误，并尝试关闭连接
            if (isset($handle) && is_resource($handle)) {
                fclose($handle);
            }
            // 也可以尝试输出一个简单的错误信息到流中，但用户体验可能不佳
            // echo "文件下载过程中发生错误，请联系管理员。";
        }
    };

    return response()->streamDownload($callback, 'problematic_file.txt', $headers);
}