使用 PHPSpreadsheet 高效修改和保存现有 Excel 文件教程

雨杰姑娘_6857

雨杰姑娘_6857

2025-08-29

452人浏览

原创

使用 PHPSpreadsheet 高效修改和保存现有 Excel 文件教程

本教程详细指导如何使用 PHPSpreadsheet 库加载、修改并保存现有 Excel 文件。我们将涵盖通过 IOFactory 读取文件、访问工作表、更新单元格数据(包括追加新行),以及正确使用 IOFactory 写入修改后的文件。文章还将提供示例代码并强调常见错误及注意事项,确保您能顺利实现 Excel 文件的程序化更新。

引言

phpspreadsheet 是一个功能强大的 php 库,用于读取、写入和操作各种电子表格文件格式,包括 xlsx、xls 和 csv。在许多业务场景中,我们不仅需要生成新的 excel 文件,还需要对已有的文件进行修改,例如更新特定单元格、添加新行或调整数据。本教程将引导您完成使用 phpspreadsheet 修改和保存现有 excel 文件的整个过程。

准备工作

在开始之前,请确保您已通过 Composer 安装了 PHPSpreadsheet 库:

composer require phpoffice/phpspreadsheet

并在您的 PHP 脚本中引入必要的命名空间:

<?php require 'vendor/autoload.php';

use PhpOffice\PhpSpreadsheet\IOFactory;
use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;

// 假设您的 Excel 文件名为 'yourspreadsheet.xlsx'
$filePath = 'yourspreadsheet.xlsx';

// 确保文件存在,否则创建它(可选,根据需求)
if (!file_exists($filePath)) {
    $spreadsheet = new Spreadsheet();
    $writer = new Xlsx($spreadsheet);
    $writer->save($filePath);
    echo "文件 {$filePath} 不存在,已创建空文件。\n";
}

?>

加载现有 Excel 文件

要修改一个现有的 Excel 文件,首先需要将其加载到 PHPSpreadsheet 对象中。推荐使用 IOFactory::createReader() 方法来根据文件类型创建合适的读取器,然后调用 load() 方法。

<?php // ... (之前的准备工作和命名空间引入)

try {
    // 创建一个读取器对象,根据文件类型(例如 "Xlsx")
    $reader = IOFactory::createReader("Xlsx");

    // 加载指定的 Excel 文件
    $spreadsheet = $reader->load($filePath);

    echo "文件 {$filePath} 加载成功。\n";

} catch (\PhpOffice\PhpSpreadsheet\Reader\Exception $e) {
    die('加载文件时发生错误: ' . $e->getMessage());
}
?>

修改或添加数据

加载文件后,您可以访问其中的工作表并对单元格进行操作。

1. 获取工作表

通常,我们会操作活动工作表,或者通过名称获取特定工作表:

<?php // ... (加载文件后的代码)

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

// 或者通过名称获取特定工作表
// $sheet = $spreadsheet->getSheetByName('Sheet1'); 
?>

2. 设置单元格值

使用 setCellValue() 方法可以修改指定单元格的内容。

<?php // ... (获取工作表后的代码)

// 修改 A1 单元格的值
$sheet->setCellValue('A1', '新的标题');

// 修改 B2 单元格的值
$sheet->setCellValue('B2', '更新的数据');
?>

3. 追加新行数据

在现有数据下方添加新行是常见的需求。这可以通过获取当前工作表的最高行数,然后在此基础上增加一行来实现。

CircleCI Orb Composer
CircleCI Orb Composer

使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。

下载
<?php // ... (获取工作表后的代码)

// 获取当前工作表的最高行数
$lastRow = (int) $sheet->getHighestRow();

// 计算新行的行号
$newRow = $lastRow + 1;

// 在新行中设置多个单元格的值
$sheet->setCellValue('A' . $newRow, '数据1');
$sheet->setCellValue('B' . $newRow, '数据2');
$sheet->setCellValue('C' . $newRow, '数据3');
$sheet->setCellValue('D' . $newRow, '数据4');
$sheet->setCellValue('E' . $newRow, '数据5');

echo "已在第 {$newRow} 行追加新数据。\n";
?>

保存修改后的 Excel 文件

完成所有修改后,您需要将 Spreadsheet 对象写回文件系统。与加载文件类似,推荐使用 IOFactory::createWriter() 方法创建写入器,然后调用 save() 方法。

<?php // ... (修改或添加数据后的代码)

try {
    // 创建一个写入器对象,根据文件类型(例如 "Xlsx")
    // 注意:这里需要传入 $spreadsheet 对象
    $writer = IOFactory::createWriter($spreadsheet, "Xlsx");

    // 将修改后的 Spreadsheet 对象保存到文件,覆盖原有文件
    $writer->save($filePath);

    echo "文件 {$filePath} 保存成功。\n";

} catch (\PhpOffice\PhpSpreadsheet\Writer\Exception $e) {
    die('保存文件时发生错误: ' . $e->getMessage());
}
?>

重要提示:关于 TypeError 的解释

在用户最初的尝试中,遇到了 Uncaught TypeError: Argument 1 passed to PhpOffice\PhpSpreadsheet\Writer\Xlsx::__construct() must be an instance of PhpOffice\PhpSpreadsheet\Spreadsheet, null given 错误。这通常是因为直接实例化 new Xlsx($spreadsheet) 时,$spreadsheet 变量在某个时刻为 null,或者在某些 PHPSpreadsheet 版本或特定配置下,直接实例化 Xlsx 类可能存在问题。

正确且推荐的做法是使用 IOFactory::createWriter($spreadsheet, "Xlsx")。 IOFactory 会确保正确地创建并配置写入器实例,避免此类类型错误,并提供更强的兼容性和灵活性。

完整示例代码

以下是一个将加载、修改(包括追加新行)和保存操作整合在一起的完整示例:

<?php require 'vendor/autoload.php';

use PhpOffice\PhpSpreadsheet\IOFactory;
use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;

$filePath = 'yourspreadsheet.xlsx'; // 确保此文件存在或被创建

// --- 确保文件存在(如果不存在则创建空文件) ---
if (!file_exists($filePath)) {
    $spreadsheet = new Spreadsheet();
    $writer = new Xlsx($spreadsheet);
    $writer->save($filePath);
    echo "文件 {$filePath} 不存在,已创建空文件。\n";
    // 如果是新建的空文件,可以写入一个表头
    $sheet = $spreadsheet->getActiveSheet();
    $sheet->setCellValue('A1', 'ID');
    $sheet->setCellValue('B1', '姓名');
    $sheet->setCellValue('C1', '城市');
    $sheet->setCellValue('D1', '薪资');
    $sheet->setCellValue('E1', '状态');
    $writer->save($filePath); // 保存初始表头
    echo "已为新文件写入初始表头。\n";
}

// --- 1. 加载现有 Excel 文件 ---
try {
    $reader = IOFactory::createReader("Xlsx");
    $spreadsheet = $reader->load($filePath);
    echo "文件 {$filePath} 加载成功。\n";
} catch (\PhpOffice\PhpSpreadsheet\Reader\Exception $e) {
    die('加载文件时发生错误: ' . $e->getMessage());
}

// --- 2. 获取工作表并修改/添加数据 ---
$sheet = $spreadsheet->getActiveSheet();

// 示例1: 修改特定单元格
$sheet->setCellValue('A1', '用户ID'); // 假设A1是标题,这里修改它
echo "已修改 A1 单元格为 '用户ID'。\n";

// 示例2: 追加新行数据
$lastRow = (int) $sheet->getHighestRow();
$newRow = $lastRow + 1;

$sheet->setCellValue('A' . $newRow, '1001');
$sheet->setCellValue('B' . $newRow, '张三');
$sheet->setCellValue('C' . $newRow, '北京');
$sheet->setCellValue('D' . $newRow, '$5000');
$sheet->setCellValue('E' . $newRow, '已完成');

echo "已在第 {$newRow} 行追加新数据。\n";

// 示例3: 再次追加一行数据
$newRow++;
$sheet->setCellValue('A' . $newRow, '1002');
$sheet->setCellValue('B' . $newRow, '李四');
$sheet->setCellValue('C' . $newRow, '上海');
$sheet->setCellValue('D' . $newRow, '$6000');
$sheet->setCellValue('E' . $newRow, '待处理');
echo "已在第 {$newRow} 行追加第二条新数据。\n";


// --- 3. 保存修改后的 Excel 文件 ---
try {
    $writer = IOFactory::createWriter($spreadsheet, "Xlsx");
    $writer->save($filePath);
    echo "文件 {$filePath} 保存成功。\n";
} catch (\PhpOffice\PhpSpreadsheet\Writer\Exception $e) {
    die('保存文件时发生错误: ' . $e->getMessage());
}

?>

注意事项

  1. 文件路径与权限: 确保 PHP 脚本对目标 Excel 文件及其所在目录具有读写权限。如果文件不存在,您可能需要先创建它(如示例所示)。
  2. 文件锁定: 如果 Excel 文件正在被其他程序(如 Microsoft Excel)打开,PHPSpreadsheet 可能无法对其进行写入操作,导致保存失败。在生产环境中,应考虑文件锁定机制或告知用户关闭文件。
  3. 内存消耗: 对于非常大的 Excel 文件(例如包含数十万行数据),一次性加载整个文件到内存可能会消耗大量内存。对于此类场景,PHPSpreadsheet 提供了高级功能,如分块读取和写入,以优化内存使用。
  4. 错误处理: 在加载和保存文件时,务必使用 try-catch 块来捕获可能发生的异常,例如文件不存在、文件损坏或权限问题,并进行相应的错误处理。
  5. 文件格式兼容性: IOFactory 能够根据文件扩展名自动识别文件格式,但为了明确和避免潜在问题,建议在 createReader() 和 createWriter() 中明确指定文件类型(如 "Xlsx", "Xls", "Csv")。

总结

通过本教程,您应该已经掌握了使用 PHPSpreadsheet 库加载、修改和保存现有 Excel 文件的关键步骤。核心在于正确使用 IOFactory::createReader() 加载文件,操作 Spreadsheet 和 Worksheet 对象来修改数据,最后通过 IOFactory::createWriter() 将更改保存回文件。遵循这些指导和注意事项,将帮助您高效且稳定地进行 Excel 文件的程序化管理。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

php excel composer office

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
composer是什么插件
composer是什么插件

Composer是一个PHP的依赖管理工具,它可以帮助开发者在PHP项目中管理和安装依赖的库文件。Composer通过一个中央化的存储库来管理所有的依赖库文件,这个存储库包含了各种可用的依赖库的信息和版本信息。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.12.25

364

5

Composer 安装与快速入门指南
Composer 安装与快速入门指南

面向 PHP 开发新手,详细介绍 Composer 的下载安装方式(本地安装与全局安装)、国内镜像源(阿里云/腾讯云)加速配置、composer.json 与 composer.lock 文件的作用解析、require/install/update 等核心命令的使用方法,帮助开发者快速掌握 PHP 依赖管理的基本工作流。

2026.04.10

643

36

Composer 依赖管理与版本控制实战
Composer 依赖管理与版本控制实战

深入讲解 Composer 的依赖管理机制,涵盖语义化版本号规范、版本约束符(^、~、*、>=)的区别与最佳实践、composer.lock 在团队协作中的锁定策略、依赖冲突的排查与解决方法、require-dev 与生产依赖的分离管理、平台依赖检查(platform-check)等进阶内容,帮助开发者在项目中精准控制依赖版本、避免"依赖地狱"。

2026.04.10

387

29

Composer 自定义包开发与发布教程合集
Composer 自定义包开发与发布教程合集

以实际项目为导向,讲解如何从零创建一个符合规范的 Composer 包,涵盖 composer.json 元信息配置、PSR-4 自动加载规则设置、命名空间规划、单元测试集成、README 与 LICENSE 编写规范,以及将包提交到 Packagist 公共仓库或搭建 Satis/Private Packagist 私有仓库的完整发布流程,帮助开发者将可复用代码封装为标准化的 Composer 包。

2026.04.10

409

15

Composer 自动加载机制与性能优化
Composer 自动加载机制与性能优化

系统剖析 Composer 的自动加载体系,讲解 PSR-0 与 PSR-4 自动加载标准的区别与演进、classmap 与 files 加载方式的适用场景、autoload_real.php 源码级加载流程解析,同时介绍 composer dump-autoload -o 优化加载映射、APCu 缓存加速、authoritative-classmap 配置等生产环境性能优化手段,帮助开发者深入理解自动加载原理并提升项目启动速度。

2026.04.13

360

21

Composer 在主流 PHP 框架中的应用实践
Composer 在主流 PHP 框架中的应用实践

结合 Laravel、ThinkPHP、Symfony 等主流 PHP 框架的实际场景,讲解 Composer 在框架项目中的典型应用,包括通过 create-project 初始化框架项目、安装与管理第三方扩展包、scripts 钩子(post-install/post-update)自动执行部署任务、自定义 Installer 插件开发、多项目共享 vendor 依赖的 Monorepo 工作流管理,帮助开发者在真实框架项目中充分发

2026.04.13

583

14

Composer 镜像源配置与网络问题排查
Composer 镜像源配置与网络问题排查

针对国内开发者常遇到的 Composer 网络问题,详细讲解阿里云、腾讯云、华为云等国内镜像源的全局与项目级切换方法、多镜像源优先级配置策略、composer config 命令行快速设置技巧,同时涵盖 SSL 证书错误、连接超时、下载中断等常见网络报错的排查与修复方案,以及利用 artifact / path 仓库实现完全离线环境下的依赖安装。

2026.04.14

391

24

Composer Scripts 脚本与自动化工作流
Composer Scripts 脚本与自动化工作流

系统讲解 Composer Scripts 机制的完整用法,涵盖 pre-install、post-update、post-autoload-dump 等内置事件钩子的触发时机与应用场景、自定义脚本命令的定义与参数传递、调用外部 Shell 命令与 PHP 静态方法、多脚本串联执行与条件判断,以及结合代码检查(PHPStan/PHP-CS-Fixer)、数据库迁移、缓存清理等任务构建一键部署自动化工作流。

2026.04.14

470

18

Composer 私有仓库搭建与企业级管理
Composer 私有仓库搭建与企业级管理

面向团队与企业开发场景,讲解如何使用 Satis 搭建轻量级静态私有仓库、通过 Toran Proxy / Private Packagist 构建功能完善的企业级私有包管理平台,涵盖 Git/SVN 仓库类型接入、Token 鉴权与访问权限控制、Webhook 自动触发包更新、内网部署方案以及与 GitLab CI/CD 流水线的集成配置,帮助企业安全高效地管理内部 PHP 组件资产。

2026.04.14

500

26

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习