Thinkphp中PHPExcel使用方法详解

'# ThinkPHP中PHPExcel使用方法详解

一、背景与问题

在企业级开发中，Excel文件处理是常见的需求。ThinkPHP作为国内主流的PHP框架，常需要与PHPExcel库结合实现数据导入导出功能。然而在实际开发中，开发者常遇到以下问题：

1. 导出大文件时内存溢出
2. 导入时数据类型识别错误
3. 读取格式化单元格样式失败
4. 跨版本兼容性问题

PHPExcel作为PHPExcel-1.8.2-obsolete.php的前身，虽然已停止维护，但在旧项目中仍有大量使用。本文将深入解析其工作原理，结合实际开发场景，给出最佳实践指南。

二、基本原理

PHPExcel的工作原理可以分为三个核心部分：

1. 文件读取机制

PHPExcel通过解析Excel文件的二进制数据，识别其内部结构。对于.xlsx文件，它会读取压缩包中的workbook.xml文件，解析其XML结构。对于.xls文件，则通过二进制流解析其内部的BIFF8格式。

// 读取文件示例
$objPHPExcel = PHPExcel_IOFactory::load($file);

2. 内存管理机制

PHPExcel采用"懒加载"策略，只在需要时才加载数据。其核心类PHPExcel_Reader_Abstract负责处理不同格式的读取，通过工厂模式创建对应实例。

3. 内存优化机制

PHPExcel通过设置setMemoryLimit()方法控制内存使用，但其内存占用依然随着数据量线性增长。处理百万级数据时，内存占用可能达到几百MB。

三、环境准备

# 安装PHPExcel
composer require phpoffice/phpexcel

注意：PHPExcel已停止维护，建议升级到 PhpSpreadsheet。但为了兼容旧项目，仍需保留其使用方法。

四、核心实现

1. 创建Excel文件

// 创建Excel文件
$objPHPExcel = new PHPExcel();
$objPHPExcel->setActiveSheetIndex(0)
    ->setCellValue('A1', 'ID')
    ->setCellValue('B1', 'Name')
    ->setCellValue('C1', 'Price');

// 写入数据
for ($i = 2; $i <= 10; $i++) {
    $objPHPExcel->getActiveSheet()
        ->setCellValue("A$i", $i - 1)
        ->setCellValue("B$i", "Product " . ($i - 1))
        ->setCellValue("C$i", 100 * ($i - 1));
}

// 保存文件
$objWriter = PHPExcel_IOFactory::createWriter($objPHPExcel, 'Excel2007');
$objWriter->save('products.xlsx');

关键代码解释：

• setActiveSheetIndex选择活动工作表
• setCellValue设置单元格内容
• createWriter指定输出格式

2. 读取Excel文件

// 读取Excel文件
$objPHPExcel = PHPExcel_IOFactory::load('products.xlsx');
$sheet = $objPHPExcel->getActiveSheet();
$data = [];

// 读取数据
foreach ($sheet->getRowIterator() as $row) {
    $cellIterator = $row->getCellIterator();
    $cells = [];
    foreach ($cellIterator as $cell) {
        $cells[] = $cell->getValue();
    }
    $data[] = $cells;
}

// 输出数据
print_r($data);

关键代码解释：

• getRowIterator遍历所有行
• getCellIterator获取单元格迭代器
• getValue()获取单元格值

3. 处理样式与格式

// 设置样式
$objPHPExcel->getActiveSheet()
    ->getStyle('A1:C1')
    ->getFont()
    ->setBold(true)
    ->getColor()
    ->setARGB('FF0000');

// 设置边框
$objPHPExcel->getActiveSheet()
    ->getStyle('A1:C1')
    ->getBorders()
    ->getOutline()
    ->setBorderStyle(PHPExcel_Style_Border::BORDER_THIN);

关键代码解释：

• getStyle获取样式对象
• getFont()设置字体样式
• getBorders()设置边框样式

五、完整案例：订单导出功能

1. 业务场景

电商平台需要将当日订单导出为Excel文件，包含订单号、用户ID、商品信息、支付状态等字段。

2. 实现代码

// 导出订单数据
public function exportOrders()
{
    $orders = Db::name('orders')->where('create_time', '>', date('Y-m-d 00:00:00'))
        ->field('order_id, user_id, total_price, status')->select();

    $objPHPExcel = new PHPExcel();
    $sheet = $objPHPExcel->getActiveSheet();

    // 设置表头
    $sheet->setCellValue('A1', '订单号')
        ->setCellValue('B1', '用户ID')
        ->setCellValue('C1', '金额')
        ->setCellValue('D1', '状态');

    // 设置样式
    $sheet->getStyle('A1:D1')->getFont()->setBold(true);
    $sheet->getStyle('A1:D1')->getBorders()
        ->getOutline()
        ->setBorderStyle(PHPExcel_Style_Border::BORDER_THIN);

    // 写入数据
    $row = 2;
    foreach ($orders as $order) {
        $sheet->setCellValue("A$row", $order['order_id'])
            ->setCellValue("B$row", $order['user_id'])
            ->setCellValue("C$row", $order['total_price'])
            ->setCellValue("D$row", $order['status']);
        $row++;
    }

    // 保存文件
    $objWriter = PHPExcel_IOFactory::createWriter($objPHPExcel, 'Excel2007');
    $objWriter->save('orders_export.xlsx');
}

六、源码解析

1. 核心类结构

PHPExcel主要由以下类构成：

• PHPExcel：核心类，管理整个工作簿
• PHPExcel_Worksheet：工作表类
• PHPExcel_Style：样式类
• PHPExcel_IOFactory：IO工厂类

2. 内存管理机制

// 设置内存限制
PHPExcel_Settings::setMemoryLimit(1024 * 1024 * 100); // 100MB

3. 内存泄漏问题

PHPExcel在处理大量数据时容易出现内存泄漏，建议使用分页处理：

// 分页处理
$offset = 0;
$limit = 1000;
while ($data = Db::name('orders')->field('...')->limit($offset, $limit)->select()) {
    // 处理数据
    $offset += $limit;
}

七、进阶使用

1. 复杂格式处理

// 设置单元格格式
$objPHPExcel->getActiveSheet()
    ->getStyle('C2:C10')
    ->getNumberFormat()
    ->setFormatCode(PHPExcel_Style_NumberFormat::FORMAT_CURRENCY_USD_SIMPLE);

2. 高级样式设置

// 设置单元格背景色
$objPHPExcel->getActiveSheet()
    ->getStyle('A1')
    ->getFill()
    ->setFillType(PHPExcel_Style_Fill::FILL_SOLID)
    ->getStartColor()
    ->setARGB('FF00FF00');

3. 多工作表处理

// 添加新工作表
$objPHPExcel->createSheet();
$objPHPExcel->setActiveSheetIndex(1);

八、性能与工程实践

1. 性能优化方案

2. 异常处理机制

try {
    $objPHPExcel = PHPExcel_IOFactory::load($file);
} catch (Exception $e) {
    echo '错误信息：' . $e->getMessage();
}

3. 安全注意事项

1. 文件类型验证
2. 上传文件过滤
3. 数据校验
4. 防止XSS注入

九、常见问题与踩坑

1. 常见错误

2. 常见坑点

1. 文件路径问题：确保文件路径正确
2. 编码问题：设置正确的字符编码
3. 数据类型转换：注意数字与文本的区分
4. 版本兼容性：不同版本的PHPExcel存在差异

十、最佳实践

1. 推荐方案

1. 使用PhpSpreadsheet替代PHPExcel
2. 对于大文件采用分页处理
3. 对重要数据进行校验
4. 设置合理的内存限制
5. 使用缓存机制提高性能

2. 使用建议

十一、总结

PHPExcel作为老牌的Excel处理库，虽然已停止维护，但在旧项目中仍有重要价值。本文深入解析了其工作原理，提供了多个代码示例和完整案例，分析了常见错误和性能优化方案。建议在新项目中使用PhpSpreadsheet，而在维护旧项目时合理使用PHPExcel。在开发过程中，要特别注意内存管理、数据校验和安全防护，避免常见错误。通过合理的设计和优化，可以有效提高Excel处理的效率和稳定性。