使用PHP和PhpSpreadsheet库将Excel数据导入HTML表格-js教程-PHP中文网

使用PHP和PhpSpreadsheet库将Excel数据导入HTML表格

霞舞

发布： 2025-07-19 21:02:23

原创

666人浏览过

使用PHP和PhpSpreadsheet库将Excel数据导入HTML表格

本文详细介绍了如何利用PHP和第三方库PhpSpreadsheet，将Excel电子表格中的数据高效地读取并呈现在HTML表格中。内容涵盖了Composer包管理器的安装、PhpSpreadsheet库的引入，以及核心的PHP代码实现，通过迭代Excel行和单元格，将数据动态转换为HTML表格结构，为Web应用集成Excel数据提供了实用的解决方案。

在现代web开发中，经常需要将外部数据源集成到web页面中。excel电子表格作为一种常见的数据存储格式，其数据如何通过php在网页上展示，是许多开发者面临的问题。由于php本身并不直接支持excel文件的原生读写，我们需要借助功能强大的第三方库来完成这项任务。phpoffice/phpspreadsheet便是其中一个广泛使用且功能完善的解决方案。

1. PhpSpreadsheet库简介

PhpSpreadsheet是PHPOffice项目下的一个PHP库，用于纯PHP编写的电子表格读写器。它支持多种电子表格格式，包括.xlsx、.xls、.csv等，提供了丰富的API来操作工作表、单元格、样式、公式等。

2. 环境准备与库安装

在使用PhpSpreadsheet之前，您需要确保系统已安装PHP，并且推荐使用Composer作为PHP的依赖管理工具。

2.1 安装Composer

如果您的系统中尚未安装Composer，请访问Composer官方网站获取安装指南。Composer是一个PHP的依赖管理工具，它允许您声明项目所依赖的库，并管理它们的安装。

2.2 安装PhpSpreadsheet库

安装Composer后，打开命令行工具（如CMD、PowerShell或Terminal），导航到您的项目根目录。然后执行以下命令来安装PHPOffice/PhpSpreadsheet库：

立即学习“PHP免费学习笔记（深入）”；

启科网络PHP商城系统

启科网络商城系统由启科网络技术开发团队完全自主开发，使用国内最流行高效的PHP程序语言，并用小巧的MySql作为数据库服务器，并且使用Smarty引擎来分离网站程序与前端设计代码，让建立的网站可以自由制作个性化的页面。系统使用标签作为数据调用格式，网站前台开发人员只要简单学习系统标签功能和使用方法，将标签设置在制作的HTML模板中进行对网站数据、内容、信息等的调用，即可建设出美观、个性的网站。

查看详情

cd your_project_folder # 替换为您的项目路径
composer require phpoffice/phpspreadsheet

登录后复制

执行此命令后，Composer会自动下载PhpSpreadsheet及其所有依赖项到您项目目录下的vendor/文件夹中。

3. 读取Excel数据并展示到HTML表格

安装完成后，您就可以开始编写PHP代码来读取Excel文件并将其内容展示到HTML表格中了。

3.1 核心代码示例

以下是一个PHP代码示例，演示了如何读取一个名为2-demo.xlsx的Excel文件，并将其所有工作表的数据呈现在HTML表格中：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>Excel数据导入HTML表格</title>
    <style>
        table {
            width: 100%;
            border-collapse: collapse;
            margin: 20px 0;
        }
        table, th, td {
            border: 1px solid #ddd;
        }
        th, td {
            padding: 8px;
            text-align: left;
        }
        th {
            background-color: #f2f2f2;
        }
    </style>
</head>
<body>

    <h1>Excel数据展示</h1>

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

        // 定义要读取的Excel文件路径
        $excelFilePath = "2-demo.xlsx"; // 确保此文件存在于与PHP脚本相同的目录或指定正确路径

        // 检查文件是否存在
        if (!file_exists($excelFilePath)) {
            echo "<tr><td colspan='100%'>错误：Excel文件 '{$excelFilePath}' 不存在。</td></tr>";
        } else {
            try {
                // (A) 使用PhpSpreadsheet加载Excel文件
                // 根据文件扩展名选择合适的Reader
                $reader = new \PhpOffice\PhpSpreadsheet\Reader\Xlsx();
                $spreadsheet = $reader->load($excelFilePath);

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

                // (B) 遍历当前工作表的每一行
                foreach ($worksheet->getRowIterator() as $row) {
                    // (B1) 获取当前行的所有单元格
                    $cellIterator = $row->getCellIterator();
                    // 设置只迭代现有单元格，如果需要包含空单元格，则设置为false
                    $cellIterator->setIterateOnlyExistingCells(false);

                    // (B2) 输出HTML行
                    echo "<tr>";
                    foreach ($cellIterator as $cell) {
                        // 获取单元格的值并输出为HTML表格单元格
                        echo "<td>" . htmlspecialchars($cell->getValue()) . "</td>";
                    }
                    echo "</tr>";
                }
            } catch (\PhpOffice\PhpSpreadsheet\Reader\Exception $e) {
                echo "<tr><td colspan='100%'>读取Excel文件时发生错误：" . htmlspecialchars($e->getMessage()) . "</td></tr>";
            } catch (\Exception $e) {
                echo "<tr><td colspan='100%'>发生未知错误：" . htmlspecialchars($e->getMessage()) . "</td></tr>";
            }
        }
        ?>
    </table>

</body>
</html>

登录后复制

3.2 代码解析

require "vendor/autoload.php";: 这是Composer的关键所在。它会自动加载PhpSpreadsheet库以及所有其他通过Composer安装的依赖项，使得您无需手动include或require每个文件。
$reader = new \PhpOffice\PhpSpreadsheet\Reader\Xlsx();: 这一行创建了一个XLSX格式的读取器实例。如果您的Excel文件是.xls格式，您需要使用\PhpOffice\PhpSpreadsheet\Reader\Xls()。
$spreadsheet = $reader->load($excelFilePath);: 使用读取器加载指定的Excel文件。这将返回一个Spreadsheet对象，代表整个Excel工作簿。
$worksheet = $spreadsheet->getActiveSheet();: 获取当前活动的工作表。如果您需要读取特定名称的工作表，可以使用$spreadsheet->getSheetByName('Sheet1')或通过索引$spreadsheet->getSheet(0)。
foreach ($worksheet->getRowIterator() as $row): 这是一个关键的循环，它遍历工作表中的每一行。getRowIterator()返回一个迭代器，允许您逐行访问数据。
$cellIterator = $row->getCellIterator();: 对于每一行，获取其单元格的迭代器。
$cellIterator->setIterateOnlyExistingCells(false);: 默认情况下，PhpSpreadsheet可能只迭代包含数据的单元格。将此设置为false可以确保即使是空的单元格也会被迭代到，从而保持HTML表格的列结构与Excel一致。
echo "<td>" . htmlspecialchars($cell->getValue()) . "</td>";: 在内层循环中，$cell代表当前的单元格对象。$cell->getValue()获取单元格的原始值。htmlspecialchars()函数用于将特殊字符转换为HTML实体，防止XSS攻击并确保数据显示正确。

4. 注意事项与进阶

文件路径: 确保$excelFilePath变量指向正确的Excel文件路径。如果Excel文件不在PHP脚本的同一目录下，您需要提供完整的相对或绝对路径。
错误处理: 上述代码已添加了基本的file_exists检查和try-catch块来捕获读取Excel文件时可能发生的异常，例如文件不存在或文件损坏。在生产环境中，建议进行更完善的错误日志记录和用户友好的错误提示。
性能优化: 对于非常大的Excel文件（例如，几十万行数据），直接一次性加载并全部显示在HTML页面上可能会导致内存溢出或页面加载缓慢。在这种情况下，您可能需要考虑：
- 分批加载: 只加载部分数据，并使用分页功能。
- 数据缓存: 将Excel数据导入到数据库中，然后从数据库读取数据。
- 优化迭代: PhpSpreadsheet提供了ReadFilter接口，可以只读取特定范围的行或列，进一步优化性能。
数据类型: PhpSpreadsheet会尝试自动识别单元格的数据类型（数字、日期、字符串等）。如果需要对日期或数字进行特定格式化，您可以使用$cell->getFormattedValue()或在PHP中进行进一步处理。
多工作表: 如果Excel文件包含多个工作表，您可以通过$spreadsheet->getAllSheets()遍历所有工作表，或者通过$spreadsheet->getSheet(index)或$spreadsheet->getSheetByName('SheetName')来访问特定的工作表。

总结

PhpSpreadsheet库为PHP开发者提供了强大而灵活的工具，用于处理Excel文件。通过上述教程，您可以轻松地将Excel数据读取并动态地呈现在Web页面上的HTML表格中。无论是用于数据展示、报表生成还是数据导入导出功能，PhpSpreadsheet都是一个值得信赖的选择。掌握其基本用法，将极大地提升您在PHP项目中处理电子表格数据的能力。

以上就是使用PHP和PhpSpreadsheet库将Excel数据导入HTML表格的详细内容，更多请关注php中文网其它相关文章！