如何在页面重载后保留搜索条件并导出筛选结果为 CSV

本文介绍如何通过 laravel session 持久化前端筛选参数（如日期范围），使“下载 csv”功能精准导出当前搜索结果，而非全量数据库数据。核心在于将表单提交的查询条件存入 session，并在下载接口中复用相同查询逻辑。

要实现「仅下载当前搜索结果」而非全部数据库记录，关键在于让下载接口感知并复用用户在搜索时提交的筛选条件。由于 HTTP 是无状态协议，页面重载后原始请求参数（如 startDate/dateEnd）在下载请求中已丢失，因此需借助 Session 在两次请求间传递筛选上下文。

✅ 正确做法：统一查询逻辑 + Session 持久化

首先，在 index() 方法中，将用户提交的筛选条件存入 Session（建议放在查询执行前）：

public function index(Request $request)
{
    // ✅ 保存搜索条件到 Session（便于 download() 复用）
    if ($request->has(['startDate', 'dateEnd']) || $request->has('startDate')) {
        session([
            'download_filter_start_date' => $request->startDate,
            'download_filter_end_date'   => $request->dateEnd,
        ]);
    }

    // 构建与视图展示完全一致的查询
    $user = DB::table('downloads')
        ->select('user_id as downloader_id', DB::raw('COUNT(id) as count'))
        ->groupBy('user_id');

    // 复用相同的条件判断逻辑
    if ($request->filled('startDate') && $request->filled('dateEnd')) {
        $user = $user->whereBetween(DB::raw("DATE_FORMAT(downloads.created_at, '%Y-%m-%d')"), [
            $request->startDate,
            $request->dateEnd
        ]);
    } elseif ($request->filled('startDate')) {
        $user = $user->whereDate('downloads.created_at', $request->startDate);
    }

    $works = DB::table('users')
        ->joinSub($user, 'downloads_byuser', function ($join) {
            $join->on('id', '=', 'downloads_byuser.downloader_id');
        })
        ->select('users.id as user_id', 'users.name as name', 'users.email as email', 'count')
        ->get();

    return view('admin.downloadsuser', compact('works'));
}

然后，在 download() 方法中，不再依赖 $request，而是从 Session 中读取筛选条件，并执行完全相同的数据库查询逻辑：

use Illuminate\Support\Facades\Session;
use Illuminate\Http\Response;

public function download()
{
    // ✅ 从 Session 获取筛选条件（若不存在则设为 null，表示不加过滤）
    $startDate = Session::get('download_filter_start_date');
    $endDate   = Session::get('download_filter_end_date');

    // ✅ 完全复用 index() 中的查询构建逻辑（保持一致性！）
    $user = DB::table('downloads')
        ->select('user_id as downloader_id', DB::raw('COUNT(id) as count'))
        ->groupBy('user_id');

    if ($startDate && $endDate) {
        $user = $user->whereBetween(DB::raw("DATE_FORMAT(downloads.created_at, '%Y-%m-%d')"), [$startDate, $endDate]);
    } elseif ($startDate) {
        $user = $user->whereDate('downloads.created_at', $startDate);
    }

    $works = DB::table('users')
        ->joinSub($user, 'downloads_byuser', function ($join) {
            $join->on('id', '=', 'downloads_byuser.downloader_id');
        })
        ->select('users.id as user_id', 'users.name as name', 'users.email as email', 'count')
        ->get();

    // ✅ 生成 CSV 文件
    $filename = public_path('Downloads.csv');
    $handle = fopen($filename, 'w');

    fputcsv($handle, ['Email', 'Downloads']);

    foreach ($works as $each_user) {
        fputcsv($handle, [
            $each_user->email,
            $each_user->count,
        ]);
    }
    fclose($handle);

    // 设置响应头（推荐使用更标准的 Content-Type）
    $headers = [
        'Content-Type' => 'text/csv',
        'Content-Disposition' => 'attachment; filename="Downloads.csv"',
    ];

    return Response::download($filename, 'Downloads.csv', $headers);
}

⚠️ 注意事项与优化建议

• 安全性：Session 中存储的是用户可控输入，但此处仅用于内部查询构造，且已通过 filled() 和类型安全判断处理，风险可控；生产环境建议对日期格式做校验（如 Carbon::createFromFormat()）。
• 用户体验：可在 Blade 中添加提示，例如「当前导出：{{ $startDate ?? '全部时间' }} 至 {{ $endDate ?? '全部时间' }} 的数据」。
• 避免重复逻辑：可将公共查询逻辑提取为私有方法（如 buildDownloadQuery()），供 index() 和 download() 共用，提升可维护性。
• 清除 Session：若希望每次搜索后自动清理旧条件，可在 index() 开头调用 Session::forget(['download_filter_start_date', 'download_filter_end_date'])，再重新写入。
• Blade 表单优化：建议为搜索表单添加 method="GET" 并使用 route()，使 URL 可书签化；下载按钮保持独立 POST/GET 即可（当前方式可行）。

通过以上改造，即可确保「下载」操作严格对应用户当前看到的表格数据，真正实现按需导出。