PHP | Spreadsheet - GeeksforGeeks

为什么我们需要 PHPSpreadsheet？

作为一名开发者，你是否曾经在处理 Excel 文件时感到头疼？原生的 PHP 函数虽然能够处理 CSV，但一旦涉及到复杂的 Excel (.xlsx) 或 LibreOffice (.ods) 格式，事情就会变得非常棘手。我们需要一个强大的工具来简化这一切，这就是 PHPSpreadsheet 登场的时候。

在这篇文章中，我们将深入探讨如何使用 PHP 来读取、写入以及操作各种类型的电子表格文件。无论你是要生成财务报表，还是需要从用户上传的 Excel 中导入海量数据，通过本文的学习，你都能掌握一套完整的解决方案。

什么是 PHPSpreadsheet？

PHPSpreadsheet 是一个由 PHP 开发的强大库，它允许我们通过一组精心设计的类来读取和写入各种电子表格文件格式。这就意味着，我们不再需要去解析复杂的二进制文件结构，只需调用简单的方法，就能操控数据。

核心功能一览

在深入研究代码之前，让我们先看看它主要能为我们做什么：

• 格式支持广泛：它不仅支持 Excel (.xlsx)、Open Document Format (.ods)、SpreadsheetML (.xml)，还完美支持 CSV 以及许多其他遗留格式。
• 样式设计：我们可以像在 Excel 中一样，设置字体、颜色、边框，甚至合并单元格。
• 公式计算：它内置了计算引擎，能够计算单元格中的数学公式。
• 数据验证：甚至可以为单元格设置下拉菜单和输入限制。

环境准备：确保一切就绪

在开始编码之前，让我们先检查一下服务器环境。为了保证 PHPSpreadsheet 能够正常且高效地运行，我们需要确保以下条件已经满足：

• PHP 版本：建议使用 PHP 7.0 或更新版本（虽然官方支持 PHP 5.6，但为了保证性能和安全性，更高的版本总是更好的选择）。
• PHP 扩展：请检查 php.ini 文件，确认以下扩展已启用：

* php_zip：用于处理 .xlsx 格式的压缩流。

* php_xml：用于解析 XML 结构。

* INLINECODEcc054b00 或 INLINECODEfdbffcd2：用于处理图像和图表。

* php_mbstring：对于处理多字节字符（如中文）至关重要，强烈推荐启用。

* php_excel2013 (可选)：如果需要处理较老的格式。

安装指南：使用 Composer

现代 PHP 开发离不开依赖管理，我们将使用 Composer 来安装这个库。打开你的终端，进入项目目录，运行以下命令：

composer require phpoffice/phpspreadsheet

安装完成后，你需要在代码中引入 Composer 的自动加载器：

require_once(‘vendor/autoload.php‘);

核心实战：从零开始操作表格

好了，一切准备就绪。让我们通过一系列的实战例子来看看如何使用它。

示例 1：创建并写入数据

让我们从最基础的操作开始：创建一个新的电子表格，并写入一些数据。这通常用于生成动态报表或导出数据。

getActiveSheet();

// 3. 设置单元格的值
$sheet->setCellValue(‘A1‘, ‘技术开源社区!‘);
$sheet->setCellValue(‘B1‘, ‘程序员的计算机科学门户‘);

// 4. 在第二行添加一些数据
$sheet->setCellValue(‘A2‘, ‘用户ID‘);
$sheet->setCellValue(‘B2‘, ‘用户名‘);

// 5. 创建写入器对象，用于保存为 .xlsx 格式
$writer = new Xlsx($spreadsheet);

// 6. 将文件保存到当前目录
$writer->save(‘demo.xlsx‘);

echo "表格已成功生成！";
?>

工作原理解析：

我们首先实例化了一个 INLINECODEdd8d73bd 对象，这就好比我们在内存中打开了一个 Excel 窗口。INLINECODE9c326210 让我们拿到当前操作的“纸”。INLINECODE2e6c4f04 就是我们手中的笔，想在哪个格子写字，就调用哪个格子。最后，INLINECODEf9baddfa 类的 Writer 负责将内存中的数据“打印”成硬盘上的文件。

示例 2：读取现有数据

生成文件只是第一步，更多时候我们需要处理已经存在的数据。下面的代码展示了如何读取刚刚生成的文件。

getActiveSheet();

// 3. 将工作表中的数据转换为数组
// toArray(null, true, true, true) 参数说明：
// 第一个 null 表示空值存储为 null
// 第二个 true 表示计算公式结果
// 第三个 true 表示格式化日期
// 第四个 true 表示将行和列的键作为索引（如 ‘A1‘, ‘B1‘）
$data = $sheet->toArray(null, true, true, true);

// 4. 显示读取到的数据
var_dump($data);

echo "
读取的 A1 单元格内容为：" . $sheet->getCell(‘A1‘)->getValue();
?>

输出结果预览：

运行上述代码后，你应该能在浏览器中看到包含数组结构的 INLINECODEe1a15a34 输出，其中包含了我们在上一个例子中写入的“技术开源社区”等字样。INLINECODE134ae579 方法非常适合用于将整个表格一次性转换为 PHP 数组进行处理。

示例 3：进阶操作 – 样式与公式

仅仅读写文字是不够的，专业的表格需要漂亮的样式和精确的公式。让我们给刚才的表格加点料。

getActiveSheet();

// 输入一些模拟数据
$sheet->setCellValue(‘A1‘, ‘产品名称‘);
$sheet->setCellValue(‘B1‘, ‘单价‘);
$sheet->setCellValue(‘C1‘, ‘数量‘);
$sheet->setCellValue(‘D1‘, ‘总价‘);

// 添加几行数据
$sheet->setCellValue(‘A2‘, ‘机械键盘‘);
$sheet->setCellValue(‘B2‘, 500);
$sheet->setCellValue(‘C2‘, 2);

// 设置公式：D2 = B2 * C2
$sheet->setCellValue(‘D2‘, ‘=B2*C2‘);

// 设置样式：让表头更醒目
$sheet->getStyle(‘A1:D1‘)->getFont()->setBold(true)->getColor()->setARGB(‘FFFFFF‘);
$sheet->getStyle(‘A1:D1‘)->getFill()->setFillType(\PhpOffice\PhpSpreadsheet\Style\Fill::FILL_SOLID)->getStartColor()->setARGB(‘4472C4‘);
$sheet->getStyle(‘A1:D1‘)->getAlignment()->setHorizontal(Alignment::HORIZONTAL_CENTER);

// 设置 D 列为货币格式
$sheet->getStyle(‘D2‘)->getNumberFormat()->setFormatCode(‘¥#,##0.00‘);

$writer = new Xlsx($spreadsheet);
$writer->save(‘styled_report.xlsx‘);
?>

代码解读：

在这个例子中，我们使用了 INLINECODEeb76f0a1 来获取特定区域的样式控制器。我们不仅设置了字体加粗和颜色，还填充了背景色。更重要的是，我们在 D2 单元格中写入了一个 Excel 公式 INLINECODEb06fc0d7，当你在 Excel 中打开这个文件时，它是可以自动计算的。

深入探讨：常见问题与最佳实践

在开发过程中，你可能会遇到一些棘手的问题。作为经验丰富的开发者，让我们来看看如何应对这些挑战。

1. 处理中文字符（乱码问题）

如果你在读取 CSV 文件时发现中文变成了乱码，或者写入时编码不正确，通常是因为字符集的问题。虽然 PHPSpreadsheet 处理 xlsx 没问题（因为它是 UTF-8 的 XML），但在处理 CSV 时需格外小心。

解决方案：

在读取 CSV 时，显式指定输入编码。

$reader = new \PhpOffice\PhpSpreadsheet\Reader\Csv();
// 如果你不确定文件的编码，可以使用 ‘UTF-8‘ 或 ‘GBK‘ 尝试
$reader->setInputEncoding(‘GBK‘); // 假设源文件是 GBK
$spreadsheet = $reader->load(‘chinese_data.csv‘);

2. 性能优化：处理大数据量

当你尝试用 PHPSpreadsheet 加载一个 10 万行的 Excel 文件时，可能会遇到内存耗尽（Out of Memory）的错误。这是因为默认情况下，所有数据都会被加载到内存中。

优化策略：

• 使用“单元格缓存”：我们可以配置缓存机制，将单元格数据暂存到磁盘（如 tmpfs、Redis 或 SQLite），而不是全部挤在内存中。

require ‘vendor/autoload.php‘;
use PhpOffice\PhpSpreadsheet\Settings;

// 使用磁盘缓存
$cacheDir = __DIR__ . ‘/cache‘; // 确保该目录可写
$cache = new \PhpOffice\PhpSpreadsheet\Cache\Filesystem($cacheDir);
Settings::setCache($cache);

// 现在加载大文件
$spreadsheet = \PhpOffice\PhpSpreadsheet\IOFactory::load(‘huge_file.xlsx‘);

• 分块读取（Read Filter）：如果你只需要读取前 100 行，可以自定义一个 Read Filter。

3. 自动调整列宽

生成的表格经常出现文字被截断的情况，看起来很不专业。我们可以利用代码自动调整列宽。

// 自动计算 A 列到 D 列的宽度
foreach (range(‘A‘, ‘D‘) as $colID) {
    $sheet->getColumnDimension($colID)->setAutoSize(true);
}

总结与展望

在这篇文章中，我们不仅学习了如何安装和配置 PHPSpreadsheet，还深入实践了从简单的读写到复杂的样式设置和公式计算。我们还探讨了处理乱码和性能优化的实用技巧。

掌握这个库，将极大地扩展你 PHP 应用程序的能力。无论是为企业开发自动化的报表系统，还是构建一个需要导出订单的电商后台，PHPSpreadsheet 都是一个值得信赖的伙伴。

接下来，你可以尝试：

• 实际操作：尝试连接你的数据库，将 MySQL 中的数据导出为 Excel 文件。
• 探索文档：查阅官方文档，看看如何插入图片或创建图表。
• 异常处理：在实际生产环境中，务必使用 try...catch 块来捕获 IO 异常，因为文件读写操作往往伴随着各种不可预见的错误。

希望这篇文章能帮助你更好地理解 PHP 电子表格处理的世界。如果你有任何疑问或者在实践中发现了新的技巧，欢迎继续交流探索！