Laravel使用Dompdf实现多条件搜索结果的PDF导出功能

核心原则是复用现有查询逻辑、保证导出使用的筛选参数和页面展示时完全一致，避免出现导出结果和页面展示内容不匹配的问题，不需要把大体积的结果集在前后端之间反复传输。

1. 抽取公共查询逻辑 #

把现有search方法里的所有多条件判断代码抽成独立私有方法，让页面展示和PDF导出两个场景共用同一段查询逻辑，从根源上避免后续修改筛选规则时两处代码不同步的问题：

private function buildSearchQuery(Request $request)
{
    $result = \DB::table('matromonial_data');
    if ($request->has('gender')) {
        $result->where('gender', $request->input('gender'));
    }
    if ($request->has('age_from') &&  $request->has('age_to')) {
        $datefrom=$request->input('age_from');
        $dateto=$request->input('age_to');
        $result->where(function($query) use ($datefrom,$dateto){
            $query->whereBetween('age',array($datefrom,$dateto)) ;
        });
    }
    if ($request->has('height_from') &&  $request->has('height_to')) {
        $height_from=$request->input('height_from');
        $height_to=$request->input('height_to');
        $result->where(function($query) use ($height_from,$height_to){
            $query->whereBetween('height',array($height_from,$height_to)) ;
        });
    }
    if ($request->has('religion')) {
        $result->whereIn('religion', $request->input('religion'));
    }
    if ($request->has('cast')) {
        $result->whereIn('cast', $request->input('cast'));
    }
    if ($request->has('mother_tongue')) {
        $result->whereIn('mother_tongue', $request->input('mother_tongue'));
    }
    if ($request->has('maritial_status')) {
        $result->whereIn('maritial_status', $request->input('maritial_status'));
    }
    if ($request->has('country')) {
        $result->whereIn('country', $request->input('country'));
    }
    if ($request->has('city')) {
        $result->whereIn('city', $request->input('city'));
    }
    if ($request->has('profession')) {
        $result->whereIn('profession', $request->input('profession'));
    }
    if ($request->has('education')) {
        $result->whereIn('education', $request->input('education'));
    }
    if ($request->has('income')) {
        $result->whereIn('income', $request->input('income'));
    }
    if ($request->has('keywords')) {
        $result->where('keywords',  'like','%' . $request->input('keywords') .'%');
    }
    if ($request->has('smoking_status')) {
        $result->where('smoking_status', $request->input('smoking_status'));
    }
    if ($request->has('drinking_status')) {
        $result->where('drinking_status', $request->input('drinking_status'));
    }
    // 返回未执行查询的构建器实例，方便后续扩展分页、排序逻辑
    return $result;
}

将原search方法改造为调用上述公共方法，同时把当前页面的全部搜索参数传递给前端视图：

public function search(Request $request){
    $query = $this->buildSearchQuery($request);
    $data['result_set'] = $query->get();
    // 将当前搜索的所有参数传给视图，供导出按钮使用
    $data['search_params'] = $request->all();
    return view('admin/search_result', $data);
}

2. 新增PDF导出接口 #

编写独立方法处理PDF导出，同样调用公共查询逻辑获取和页面完全一致的结果集，渲染到PDF视图中：

public function exportSearchPdf(Request $request)
{
    // 复用公共查询，保证导出结果和页面展示一致
    $query = $this->buildSearchQuery($request);
    $resultSet = $query->get();
    // 渲染专门适配PDF格式的视图
    $pdf = PDF::loadView('pdf.search_result_pdf', ['result_set' => $resultSet]);
    // 导出文件加时间戳后缀避免重名
    return $pdf->download('搜索结果_'.date('YmdHis').'.pdf');
}

不建议将前端渲染好的完整HTML回传给后端解析生成PDF：一方面大体积结果集的前后端传输会增加耗时，另一方面Dompdf对现代CSS布局、JS的兼容度较低，直接解析前端页面的HTML很容易出现样式错乱。

3. 前端页面添加导出按钮 #

在搜索结果页面中添加导出按钮，通过隐藏表单将当前所有搜索参数提交到导出接口，保证参数完全对齐：

<form action="{{ route('export.search.pdf') }}" method="POST">
    @csrf
    <!-- 遍历传递过来的搜索参数生成隐藏域，保证筛选条件不丢失 -->
    @foreach($search_params as $key => $value)
        @if(is_array($value))
            <!-- 针对多选类的数组参数，循环生成对应name的隐藏输入框 -->
            @foreach($value as $item)
                <input type="hidden" name="{{ $key }}[]" value="{{ $item }}">
            @endforeach
        @else
            <input type="hidden" name="{{ $key }}" value="{{ $value }}">
        @endif
    @endforeach
    <button type="submit" class="btn">导出PDF</button>
</form>

注意事项 #

• 记得在路由配置中注册导出接口的访问地址，和前端表单提交的目标路由保持对应
• 为PDF编写独立的blade视图，尽量使用基础表格布局、内联样式，避免引用外部CSS、图片资源，减少Dompdf的渲染兼容问题
• 如果查询结果数据量较大，可在导出方法中增加数量截断逻辑，避免单次内存占用过高导致生成失败

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