PHPExcel 技术指南：使用 Reader 读取电子表格文件

PHPExcel 技术指南：使用 Reader 读取电子表格文件

PHPExcel ARCHIVED 项目地址: https://gitcode.com/gh_mirrors/ph/PHPExcel

前言

在 PHPExcel 项目中，读取不同格式的电子表格文件是常见的操作需求。本文将详细介绍如何使用 PHPExcel 提供的 Reader 组件来加载各种格式的电子表格文件，包括 Excel 5/95、Excel 2007、CSV 等多种格式。

直接实例化 Reader 对象

当您明确知道要读取的文件格式时，可以直接实例化对应格式的 Reader 对象。PHPExcel 为每种支持的格式都提供了专门的 Reader 类：

$inputFileName = './sampleData/example1.xls';

// 根据文件格式选择对应的 Reader
$objReader = new PHPExcel_Reader_Excel5();  // Excel 5/95 (.xls)
// $objReader = new PHPExcel_Reader_Excel2007();  // Excel 2007 (.xlsx)
// $objReader = new PHPExcel_Reader_Excel2003XML();  // Excel 2003 XML
// $objReader = new PHPExcel_Reader_OOCalc();  // OpenOffice/LibreOffice Calc
// $objReader = new PHPExcel_Reader_SYLK();  // SYLK 格式
// $objReader = new PHPExcel_Reader_Gnumeric();  // Gnumeric
// $objReader = new PHPExcel_Reader_CSV();  // CSV 文件

// 加载文件到 PHPExcel 对象
$objPHPExcel = $objReader->load($inputFileName);

注意事项：

1. 虽然可以直接根据文件扩展名选择 Reader，但如果文件实际格式与扩展名不符，可能会导致解析错误
2. 每种 Reader 都有特定的配置选项，如 CSV Reader 可以设置分隔符、编码等

使用 IOFactory 创建 Reader

PHPExcel 提供了更灵活的 IOFactory 类来创建 Reader 对象，这种方式更为推荐：

$inputFileType = 'Excel5';  // 指定文件类型
// 其他可选类型：
// 'Excel2007', 'Excel2003XML', 'OOCalc', 'SYLK', 'Gnumeric', 'CSV'
$inputFileName = './sampleData/example1.xls';

// 通过 IOFactory 创建对应类型的 Reader
$objReader = PHPExcel_IOFactory::createReader($inputFileType);
// 加载文件
$objPHPExcel = $objReader->load($inputFileName);

优势：

1. 代码更加统一，便于维护
2. 可以方便地切换不同的文件类型
3. 工厂模式提供了更好的扩展性

自动识别文件类型

对于不确定文件格式的情况，PHPExcel 可以自动检测文件类型：

$inputFileName = './sampleData/example1.xls';

// 自动识别文件类型
$inputFileType = PHPExcel_IOFactory::identify($inputFileName);
// 创建对应的 Reader
$objReader = PHPExcel_IOFactory::createReader($inputFileType);
// 加载文件
$objPHPExcel = $objReader->load($inputFileName);

识别原理：

1. 通过文件内容而非扩展名来判断格式
2. 支持所有 PHPExcel 能够处理的格式
3. 对于无法识别的格式会抛出异常

最佳实践建议

1. 性能考虑：对于已知格式的文件，直接指定 Reader 类型比自动识别更快
2. 错误处理：始终对 load() 方法进行异常捕获
3. 内存管理：处理大文件时考虑使用分块读取或设置缓存选项
4. 文件验证：即使使用自动识别，也应验证文件内容是否符合预期

扩展知识

PHPExcel 的 Reader 组件还支持许多高级功能：

• 只读取特定工作表
• 自定义 CSV 分隔符和编码
• 设置只读模式以减少内存占用
• 过滤和转换输入数据

通过合理使用这些功能，可以构建出更健壮、高效的电子表格处理应用。

PHPExcel ARCHIVED 项目地址: https://gitcode.com/gh_mirrors/ph/PHPExcel