php如何从数据库导出xls文件？代码示例有吗？

adminZpd 专业教程 2026-01-10 05:28:27

PHP从数据库导出XLS文件是一项常见的需求,尤其在数据报表、财务统计或数据备份等场景中，本文将详细介绍如何使用PHP实现从数据库读取数据并导出为XLS格式，涵盖环境准备、核心代码实现、错误处理及优化技巧等内容，帮助开发者快速掌握这一功能。

php如何从数据库导出xls文件？代码示例有吗？-第1张图片-99系统专家

环境准备与依赖安装

在开始实现导出功能前,需确保开发环境满足基本要求，PHP版本需不低于7.0，以兼容现代语法和函数，需要安装PHP的Excel操作扩展，推荐使用PhpSpreadsheet库，它是PHPExcel的继任者，功能更强大且维护活跃，可通过Composer安装该库：在项目根目录运行composer require phpoffice/phpspreadsheet，安装完成后，在PHP文件中通过require 'vendor/autoload.php';引入自动加载文件，需确保数据库连接正常，建议使用PDO或MySQLi扩展连接数据库，以增强安全性和兼容性。

数据库连接与数据查询

导出XLS的第一步是从数据库获取数据,以PDO为例，首先需配置数据库连接参数，包括主机名、数据库名、用户名和密码，通过new PDO()建立连接后，可执行SQL查询语句获取数据集，查询用户表的姓名、邮箱和注册时间：$sql = "SELECT name, email, created_at FROM users"; $stmt = $pdo->query($sql); $data = $stmt->fetchAll(PDO::FETCH_ASSOC);，这里使用FETCH_ASSOC获取关联数组，便于后续处理，查询时需注意SQL注入防护，建议使用预处理语句或参数化查询，确保数据安全性。

使用PhpSpreadsheet创建XLS文件

获取数据后,即可使用PhpSpreadsheet创建Excel文件，实例化Spreadsheet对象：$spreadsheet = new \PhpOffice\PhpSpreadsheet\Spreadsheet();，获取活动工作表：$sheet = $spreadsheet->getActiveSheet();，为便于阅读，可设置表头：$sheet->setCellValue('A1', '姓名')->setCellValue('B1', '邮箱')->setCellValue('C1', '注册时间');，通过循环将数据写入工作表：$row = 2; foreach ($data as $item) { $sheet->setCellValue('A'.$row, $item['name'])->setCellValue('B'.$row, $item['email'])->setCellValue('C'.$row, $item['created_at']); $row++; }，写入数据时，可根据需求调整单元格格式，如日期格式、文本对齐方式等，以提升报表可读性。

php如何从数据库导出xls文件？代码示例有吗？-第2张图片-99系统专家

设置文件格式与输出下载

创建完成后,需将工作表保存为XLS格式并触发下载，PhpSpreadsheet提供了多种保存格式，如XLS、XLSX、CSV等，若需兼容旧版Excel，可使用Xls写入器：$writer = new \PhpOffice\PhpSpreadsheet\Writer\Xls($spreadsheet);，通过设置HTTP头信息，确保浏览器正确处理文件：header('Content-Type: application/vnd.ms-excel'); header('Content-Disposition: attachment;filename="user_data.xls"'); header('Cache-Control: max-age=0');，使用$writer->save('php://output');将文件输出到浏览器，注意，输出前需确保没有其他内容（如空格、错误信息）被输出，否则可能导致文件损坏。

错误处理与性能优化

在实际应用中,错误处理和性能优化至关重要，错误处理方面，需捕获数据库查询和文件操作中的异常，如try-catch块包裹数据库连接和查询代码，避免因错误导致脚本中断，性能优化方面，若数据量较大，可分批查询数据库并写入Excel，减少内存占用；可禁用单元格的样式计算和公式缓存，通过$spreadsheet->setActiveSheetIndex(0)->getStyle()->setQuotePrefix(false);提升写入速度，对于超大数据集，建议考虑使用CSV格式或专业工具，如MySQL的SELECT ... INTO OUTFILE语句，以提高效率。

完整代码示例

以下是一个完整的代码示例,整合了上述步骤：

php如何从数据库导出xls文件？代码示例有吗？-第3张图片-99系统专家

<?php
require 'vendor/autoload.php';
use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Writer\Xls;
try {
    // 数据库连接
    $pdo = new PDO('mysql:host=localhost;dbname=test', 'username', 'password');
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    // 查询数据
    $stmt = $pdo->query("SELECT name, email, created_at FROM users");
    $data = $stmt->fetchAll(PDO::FETCH_ASSOC);
    // 创建Excel对象
    $spreadsheet = new Spreadsheet();
    $sheet = $spreadsheet->getActiveSheet();
    $sheet->setCellValue('A1', '姓名')->setCellValue('B1', '邮箱')->setCellValue('C1', '注册时间');
    // 写入数据
    $row = 2;
    foreach ($data as $item) {
        $sheet->setCellValue('A'.$row, $item['name'])
              ->setCellValue('B'.$row, $item['email'])
              ->setCellValue('C'.$row, $item['created_at']);
        $row++;
    }
    // 输出下载
    header('Content-Type: application/vnd.ms-excel');
    header('Content-Disposition: attachment;filename="users.xls"');
    header('Cache-Control: max-age=0');
    $writer = new Xls($spreadsheet);
    $writer->save('php://output');
} catch (Exception $e) {
    die('Error: ' . $e->getMessage());
}