PHP导出查询结果支持CSV、Excel（PhpSpreadsheet）、JSON三种格式：CSV兼容性强，适合结构化数据；Excel支持样式与多表；JSON适用于前后端交互。导出前需字段筛选、映射与脱敏，大数据量时应分批处理防超时溢出。
一、使用PHP生成CSV文件导出查询结果
CSV格式兼容性强，可被Excel、WPS等表格软件直接打开，适合导出结构化查询数据。该方法通过设置HTTP响应头强制浏览器下载，并逐行写入数据库查询结果。
1、执行SQL查询获取结果集，例如：$result = mysqli_query($conn, "SELECT id, name, email FROM users");
2、设置响应头：header('Content-Type: text/csv'); header('Content-Disposition: attachment; filename="export_users.csv"');
3、打开输出流：$output = fopen('php://output', 'w');
立即学习“PHP免费学习笔记（深入）”；
4、写入表头：fputcsv($output, ['ID', '姓名', '邮箱']);
5、遍历结果集并写入每行数据：while ($row = mysqli_fetch_assoc($result)) { fputcsv($output, $row); }
6、关闭输出流：fclose($output);
二、使用PHPExcel类库导出为Excel文件
PHPExcel（或其现代替代库PhpSpreadsheet）支持.xlsx格式，可保留单元格样式、公式与多工作表结构，适用于需要格式控制的导出场景。
1、通过Composer安装：composer require phpoffice/phpspreadsheet
2、引入类库：require 'vendor/autoload.php'; use PhpOffice\PhpSpreadsheet\Spreadsheet; use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
3、创建新Spreadsheet实例：$spreadsheet = new Spreadsheet(); $sheet = $spreadsheet->getActiveSheet();
4、写入表头：$sheet->setCellValue('A1', 'ID')->setCellValue('B1', '姓名')->setCellValue('C1', '邮箱');
5、从数据库读取数据并逐行填充：$rowIndex = 2; while ($row = mysqli_fetch_assoc($result)) { $sheet->setCellValue('A' . $rowIndex, $row['id']) ->setCellValue('B' . $rowIndex, $row['name']) ->setCellValue('C' . $rowIndex, $row['email']); $rowIndex++; }
6、设置响应头并输出：header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'); header('Content-Disposition: attachment; filename="users_export.xlsx"'); $writer = new Xlsx($spreadsheet); $writer->save('php://output');
三、将查询结果以JSON格式导出为文件
JSON格式适用于前后端分离架构下的数据交换，也便于后续程序解析处理。导出时需确保中文字符正确编码，避免乱码。
1、执行查询并收集全部数据：$data = []; while ($row = mysqli_fetch_assoc($result)) { $data[] = $row; }
2、对数据进行UTF-8编码保障：array_walk_recursive($data, function(&$item) { if (is_string($item)) $item = mb_convert_encoding($item, 'UTF-8', 'auto'); });
3、生成JSON字符串：$json = json_encode($data, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
4、设置响应头：header('Content-Type: application/json'); header('Content-Disposition: attachment; filename="query_result.json"');
5、输出JSON内容：echo $json;
四、导出前对查询结果进行条件筛选与字段映射
实际业务中常需隐藏敏感字段（如密码哈希）、重命名列名或转换值（如状态码转文字），此步骤应在数据写入导出流前完成，确保输出内容符合安全与展示要求。
1、定义允许导出的字段白名单：['id', 'username', 'created_at', 'status']
2、定义字段别名映射：$aliases = ['id' => '用户编号', 'username' => '登录账号', 'created_at' => '注册时间', 'status' => '账户状态'];
3、遍历原始结果，仅提取白名单字段并替换键名：$exportRow = []; foreach ($whitelist as $field) { $exportRow[$aliases[$field]] = $row[$field] ?? ''; }
4、若status字段值为1/0，转换为启用/停用：if (isset($row['status'])) { $exportRow['账户状态'] = $row['status'] == 1 ? '启用' : '停用'; }
5、将处理后的$exportRow加入导出数组，再统一写入CSV或Excel。
五、防止导出过程超时与内存溢出的分批处理方式
当查询结果超过万级记录时，一次性加载全部数据易触发PHP内存限制或脚本超时。采用LIMIT+OFFSET分页或游标式查询，配合flush机制可稳定导出大体量数据。
1、设置脚本不超时：set_time_limit(0);
2、初始化偏移量：$offset = 0; $limit = 1000;
3、在循环中执行分页查询：$sql = "SELECT id, name, email FROM users ORDER BY id ASC LIMIT {$limit} OFFSET {$offset}";
4、每次查询后立即写入输出流并调用ob_flush()和flush()推送缓冲区内容
5、更新偏移量：$offset += $limit;
6、当本次查询结果行数小于$limit时，终止循环。
