当前位置：首页 > 文章列表 > 文章 > 前端 > PHP导入Excel生成HTML表格教程

PHP导入Excel生成HTML表格教程

2025-08-06 20:15:31 0浏览收藏

积累知识，胜过积蓄金银！毕竟在文章开发的过程中，会遇到各种各样的问题，往往都是一些细节知识点还没有掌握好而导致的，因此基础知识点的积累是很重要的。下面本文《PHP读取Excel数据并生成HTML表格教程》，就带大家讲解一下知识点，若是你对本文感兴趣，或者是想搞懂其中某个知识点，就请你继续往下看吧~

PHP与Excel数据交互：从Excel读取数据并渲染到HTML表格的教程

本教程旨在指导开发者如何利用PHP与Excel文件进行数据交互，特别是在HTML表格中展示Excel数据。鉴于PHP本身不直接支持Excel，我们将详细介绍如何安装并使用强大的PHPOffice/PhpSpreadsheet库。通过本文，你将学会如何加载Excel文件、遍历工作表内容，并将其动态渲染为网页上的HTML表格，从而实现高效的数据展示与管理。

使用PhpSpreadsheet库连接PHP与Excel

在Web开发中，经常会遇到需要将后端数据以HTML表格的形式展示给用户，而这些数据有时可能存储在Excel文件中。尽管PHP本身不提供直接操作Excel文件的内置功能，但幸运的是，强大的第三方库PHPOffice/PhpSpreadsheet为我们提供了完美的解决方案。这个库允许PHP应用程序读取、写入和修改多种电子表格格式，包括.xlsx、.xls和CSV等。本节将详细介绍如何利用该库，将Excel数据动态地呈现在网页的HTML表格中。

环境准备与库安装

在使用PHPOffice/PhpSpreadsheet之前，您需要确保PHP环境已配置妥当，并且安装了Composer。Composer是PHP的依赖管理工具，它能帮助我们轻松地安装和管理项目所需的库。

安装Composer：如果您的系统尚未安装Composer，请访问Composer官方网站下载并安装。
导航到项目目录：打开您的命令行工具（如CMD、PowerShell或Terminal），然后使用cd命令切换到您的PHP项目根目录。例如：
```
cd Your_Project_Folder
```
安装PhpSpreadsheet库：在项目目录下执行以下Composer命令来安装PHPOffice/PhpSpreadsheet：
```
composer require phpoffice/phpspreadsheet
```
此命令会自动下载PhpSpreadsheet及其所有依赖项，并将其安装到您项目目录下的vendor/文件夹中。同时，Composer还会生成一个vendor/autoload.php文件，用于自动加载所有已安装的类库。

从Excel文件读取数据并渲染到HTML表格

安装完PhpSpreadsheet库后，我们就可以编写PHP代码来读取Excel文件并将其内容展示到HTML表格中。以下是一个完整的示例代码，它将读取一个名为2-demo.xlsx的Excel文件，并将其内容输出为一个HTML表格。

请确保您的项目根目录下存在一个名为2-demo.xlsx的Excel文件，或者修改代码中的文件路径以匹配您的实际文件。

<table>
<?php
// (A) 引入Composer的自动加载文件，以便使用PhpSpreadsheet库
require "vendor/autoload.php";

// (B) 创建一个XLSX格式的读取器实例
$reader = new \PhpOffice\PhpSpreadsheet\Reader\Xlsx();

// (C) 加载指定的Excel文件
// 请确保 '2-demo.xlsx' 文件存在于与此PHP脚本相同的目录，或提供完整路径
try {
    $spreadsheet = $reader->load("2-demo.xlsx");
} catch (\PhpOffice\PhpSpreadsheet\Reader\Exception $e) {
    // 捕获加载Excel文件时可能发生的异常，并终止脚本执行
    die('加载Excel文件失败: ' . $e->getMessage());
}

// (D) 获取当前活动的工作表
$worksheet = $spreadsheet->getActiveSheet();

// (E) 遍历工作表中的每一行
foreach ($worksheet->getRowIterator() as $row) {
  // (E1) 获取当前行的单元格迭代器
  $cellIterator = $row->getCellIterator();
  // 设置迭代器，使其包含所有单元格，即使是空的单元格
  $cellIterator->setIterateOnlyExistingCells(false);

  // (E2) 输出HTML表格行
  echo "<tr>";
  // 遍历当前行的每个单元格
  foreach ($cellIterator as $cell) {
      // 输出单元格的值到HTML表格单元格
      // 使用 htmlspecialchars() 函数转义特殊字符，防止XSS攻击
      echo "<td>". htmlspecialchars($cell->getValue()) ."</td>";
  }
  echo "</tr>";
}
?>
</table>

代码解析

让我们逐行分析上述代码，理解其工作原理：

require "vendor/autoload.php";：这是使用Composer安装的库的入口点。它会自动加载所有PhpSpreadsheet类，使我们无需手动include或require每个文件。
$reader = new \PhpOffice\PhpSpreadsheet\Reader\Xlsx();：这行代码创建了一个Xlsx格式的读取器实例。如果您处理的是旧版.xls文件，您需要使用\PhpOffice\PhpSpreadsheet\Reader\Xls()。
try { $spreadsheet = $reader->load("2-demo.xlsx"); } catch (...) { ... }：使用读取器加载指定的Excel文件。这里我们使用了try-catch块来捕获文件加载过程中可能发生的异常，例如文件不存在或损坏，提高了程序的健壮性。
$worksheet = $spreadsheet->getActiveSheet();：获取Excel文件中当前活动（默认选中）的工作表。如果您需要访问特定的工作表，可以使用$spreadsheet->getSheetByName('SheetName')或$spreadsheet->getSheet(index)。
foreach ($worksheet->getRowIterator() as $row)：这是一个外层循环，用于遍历工作表中的每一行数据。getRowIterator()返回一个行迭代器。
$cellIterator = $row->getCellIterator();：对于当前行，获取其单元格迭代器。
$cellIterator->setIterateOnlyExistingCells(false);：此设置非常重要。默认情况下，PhpSpreadsheet的单元格迭代器只会遍历有内容的单元格。设置为false后，即使是空的单元格也会被遍历，确保HTML表格的列数与Excel文件保持一致，避免错位。
echo ""; 和 echo "";：在每次遍历一行时，输出HTML表格的行标签。
foreach ($cellIterator as $cell) { echo "". htmlspecialchars($cell->getValue()) .""; }：内层循环遍历当前行中的每个单元格。$cell->getValue()获取单元格的原始值。htmlspecialchars()函数用于将特殊字符转换为HTML实体，防止XSS攻击并确保数据显示正确。

注意事项与最佳实践

在使用PhpSpreadsheet进行Excel数据处理时，以下是一些重要的注意事项和最佳实践：

文件路径管理：确保load()方法中提供的Excel文件路径是正确的。可以是相对于PHP脚本的路径，也可以是绝对路径。在生产环境中，建议使用绝对路径或基于配置的路径。
错误处理：务必使用try-catch块来包装文件加载和处理的代码。这可以捕获文件不存在、文件损坏、权限不足等异常，提高程序的健壮性。
大型文件处理：对于非常大的Excel文件（例如几十MB甚至上百MB），直接加载到内存中可能会导致PHP内存溢出。
- 内存限制：您可能需要增加PHP的memory_limit配置。
- 分块读取：PhpSpreadsheet支持分块读取（Chunk Reading），这允许您一次只加载文件的一部分，显著降低内存消耗。这需要更复杂的实现，适用于超大型文件。
数据类型与格式：Excel中的日期、时间、数字等可能以特定的格式存储。getValue()通常返回原始值，您可能需要根据

今天关于《PHP导入Excel生成HTML表格教程》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！