在Web开发中，处理CSV和Excel文件的导入导出是一项非常常见的需求，例如数据备份、报表生成以及批量数据录入等。PHP作为一门成熟的Web后端语言，提供了原生方法处理CSV，同时也拥有强大的第三方库来处理复杂的Excel文件。本文将详细讲解如何在PHP中优雅、高效地完成这些操作。
一、 CSV文件的导入与导出
CSV（逗号分隔值）是一种纯文本格式，结构简单，读取和生成速度快，非常适合处理不需要复杂排版的海量数据。PHP原生提供了fgetcsv和fputcsv函数，无需安装任何扩展即可操作。
- CSV文件导出
导出CSV的核心思路是设置HTTP响应头，告知浏览器下载文件，然后利用php://output流直接将数据写入输出缓冲区。需要注意的是，中文CSV在Windows系统下容易乱码，因此建议在输出前添加BOM头。
header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename=data_export.csv');
// 打开PHP输出流
$output = fopen('php://output', 'w');
// 写入BOM头，解决Windows下Excel打开中文乱码问题
fwrite($output, "xEFxBBxBF");
// 准备数据
$data = [
['姓名', '年龄', '职业'],
['张三', '28', '工程师'],
['李四', '25', '设计师']
];
foreach ($data as $row) {
fputcsv($output, $row);
}
fclose($output);
exit;
2. CSV文件导入
导入CSV文件同样使用原生函数。通过fopen打开上传的临时文件，循环使用fgetcsv读取每一行数据。
$filePath = 'uploaded_data.csv';
if (($handle = fopen($filePath, 'r')) !== false) {
while (($row = fgetcsv($handle, 1000, ',')) !== false) {
// $row 是一个索引数组，代表当前行的每一列数据
// 例如：$row[0] 为姓名，$row[1] 为年龄
// 在此进行数据校验和数据库插入操作
}
fclose($handle);
}
二、 Excel文件的导入与导出
Excel文件（.xlsx 或 .xls）格式复杂，包含样式、多工作表、公式等信息，无法通过PHP原生函数直接解析。目前业界最主流的库是PhpSpreadsheet，它是旧版PHPExcel的继承者，全面支持现代PHP特性。
使用前请通过Composer安装：composer require phpoffice/phpspreadsheet
- Excel文件导出
导出Excel需要创建工作簿对象，操作活动工作表写入数据，最后通过Writer类将对象写入输出流供下载。
require 'vendor/autoload.php';
use PhpOfficePhpSpreadsheetSpreadsheet;
use PhpOfficePhpSpreadsheetWriterXlsx;
$spreadsheet = new Spreadsheet();
$sheet = $spreadsheet->getActiveSheet();
// 填充数据
$sheet->setCellValue('A1', '姓名');
$sheet->setCellValue('B1', '年龄');
$sheet->setCellValue('A2', '王五');
$sheet->setCellValue('B2', '30');
// 设置HTTP头，触发浏览器下载
header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
header('Content-Disposition: attachment; filename="export.xlsx"');
header('Cache-Control: max-age=0');
$writer = new Xlsx($spreadsheet);
$writer->save('php://output');
exit;
2. Excel文件导入
导入Excel时，使用IOFactory自动识别文件类型并加载，然后将工作表数据转化为数组进行遍历处理。
require 'vendor/autoload.php';
use PhpOfficePhpSpreadsheetIOFactory;
$filePath = 'uploaded_data.xlsx';
try {
// 加载文件
$spreadsheet = IOFactory::load($filePath);
$sheet = $spreadsheet->getActiveSheet();
// 将工作表数据转为数组（最高效的处理方式之一）
$data = $sheet->toArray(null, true, true, true);
foreach ($data as $row) {
// $row 是关联数组，键名为 A, B, C...
// 例如：$row['A'] 为姓名，$row['B'] 为年龄
// 执行数据库写入等业务逻辑
}
} catch (Exception $e) {
die('文件读取失败: ' . $e->getMessage());
}
三、 实战注意事项与性能优化
- 大文件内存溢出问题
PhpSpreadsheet在处理大型Excel文件时极其消耗内存。如果一个Excel包含数万行数据，直接load极易导致Allowed memory size exhausted错误。
对于大文件读取，可以使用ReadFilter过滤不需要的行/列，或者采用分块读取机制，每次只加载指定行数的数据进行处理。对于大文件导出，可以考虑使用原生的CSV格式替代，或者借助底层库如box/spout（现更名为OpenSpout），它专门为流式读取大文件设计，内存占用极低。更多大文件处理方案可参考 www.ipipp.com 提供的性能优化指南。
-
安全性防范
允许用户上传CSV或Excel文件存在潜在风险。恶意用户可能在上传表单中嵌入HTML或JavaScript代码（CSV注入）。在将数据输出到前端或存入数据库前，务必对特殊字符进行htmlspecialchars转义或剥离，绝不能盲目信任文件内容。 -
日期与数字格式处理
Excel内部将日期存储为数字序列值（如45678代表某个日期），在读取时经常会遇到时间格式错乱的问题。PhpSpreadsheet提供了格式化方法，可以使用PhpOfficePhpSpreadsheetSharedDate::excelToDateTimeObject()将Excel的数字时间转换为PHP的DateTime对象，确保日期解析的准确性。
总结来说，简单的数据迁移和导出推荐使用原生CSV方案，效率最高；如果需要支持排版、多Sheet和复杂格式，则必须借助PhpSpreadsheet，并注意做好内存控制与安全校验。
原文地址：https://www.ipipp.com/html/20260418/201.html