PHPExcel：PHP操作Excel的完全指南

大家好，欢迎来到IT知识分享网。

本文还有配套的精品资源，点击获取

简介： phpexcel 库让PHP开发者可以轻松读写Excel文件，无需外部软件转换。本文详细介绍了如何安装、创建、读取、写入以及处理复杂Excel数据，包括合并单元格、工作表管理、数据验证和性能优化。该库支持 .xls 和 .xlsx 格式，提供丰富的API以及内存和性能优化技巧，是数据导入导出的高效工具。

1. PHP操作Excel的基础

在本章中，我们将探讨使用PHP操作Excel文件的基础知识。首先，我们需要了解什么是PHP，它是一个广泛使用的开源服务器端脚本语言，非常适合开发动态网页内容。它常用于Web开发，并可以与HTML结合使用来创建各种类型的应用程序。然而，当涉及到Excel文件时，PHP本身并没有直接支持文件操作，这就需要借助第三方库来实现，其中最著名的就是PHPExcel。

PHPExcel是一个用于读写Excel文件的PHP库，它能够处理Excel 97到Excel 2007格式的文件。它不仅可以生成新的Excel文件，还可以读取、修改现有文件，并将内容导出到多种格式。该库的主要优点是无需安装Microsoft Excel即可在服务器端操作Excel文件。这对于那些需要通过Web应用程序批量处理电子表格数据的开发者来说，是一个非常强大的工具。

让我们开始本章的学习，为之后更深入的内容打下坚实的基础。我们将从了解PHPExcel库的基本概念和它的类结构开始，逐步过渡到实际代码的编写和示例分析。通过这一过程，你将掌握PHP操作Excel的核心技能，并为进一步学习打下良好的基础。

2. Composer安装phpexcel库

2.1 Composer的介绍和安装

2.1.1 Composer的定义和作用

Composer是一个依赖管理工具，它为PHP提供了类似node.js的npm或Ruby的bundler的依赖管理和项目自动加载机制。开发者可以通过定义依赖关系文件（通常是 composer.json ），来声明项目所需的库。Composer能够自动处理下载、更新依赖和自动加载，使得项目依赖更加清晰和易于管理。

2.1.2 Composer的安装方法

安装Composer非常简单，以下是安装步骤：

下载安装脚本。您可以通过访问Composer的官方网站或使用如下命令行下载安装脚本： bash php -r "copy('*', 'composer-setup.php');"
执行安装脚本。使用下面的命令来检查安装脚本的哈希，并执行： bash php -r "if (hash_file('sha384', 'composer-setup.php') === 'a4488ce9024fc62c*f7c85e76ea54c*db91d5ab5884') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;" 执行后，如果安装脚本有效，会打印“Installer verified”。
安装Composer。使用下面的命令来运行安装脚本，并在 --install-dir 指定目录下安装Composer。默认情况下，它会安装到 /usr/local/bin/composer ，这个位置通常需要在环境变量中： bash php composer-setup.php --install-dir=/usr/local/bin --filename=composer
检查安装。安装完成后，您可以通过在命令行运行 composer 来检查是否正确安装。

2.2 使用Composer安装phpexcel库

2.2.1 Composer安装phpexcel的步骤

打开命令行工具，进入您的项目目录。
如果您还没有 composer.json 文件，可以通过运行以下命令生成： bash composer init 按照提示填写项目信息，完成后将会在项目目录生成一个 composer.json 文件。
接下来，运行以下命令来安装phpexcel库： bash composer require phpoffice/phpexcel 此命令会自动添加 phpoffice/phpexcel 到 composer.json 的 require 部分，并安装库到 vendor 目录。

2.2.2 验证phpexcel库安装成功

验证安装是否成功，可以通过以下两种方式：

检查项目中的 vendor 目录，确保有 phpoffice 的子目录，这表明phpexcel库已经安装。
使用Composer的 status 命令来查看项目依赖： bash composer status 如果 phpoffice/phpexcel 显示在列表中，并且状态为 [OK] ，则表示库已经正确安装。

现在，您已经通过Composer安装了phpexcel库，并且可以开始在项目中使用它来操作Excel文件了。

3. 创建新的Excel文件

使用phpexcel创建Excel文件

phpexcel的基本类和方法

PEAR是一个PHP扩展和应用库仓库，而PHPExcel是基于PEAR库的一个扩展，用于在PHP中操作Excel文件。它允许开发者创建和修改Excel文件（包括 .xls 和 .xlsx 格式），并且提供了丰富的接口来操作工作表、单元格、样式等。

PEAR和PHPExcel的关系：PEAR是PHP的一个扩展库，它提供了一个框架来开发、部署和使用PHP代码。PHPExcel是利用PEAR库的面向对象的编程特性开发的一个库，专门用于操作Excel文件。

PEAR的安装方式如下（基于Linux环境，建议在Ubuntu或CentOS系统上安装）：

sudo apt-get install php-pear

或者

sudo yum install php-pear

安装完成后，你可以通过以下命令来安装PHPExcel：

“`* pear install phpexcel/PHPExcel

 PEAR和PHPExcel库安装好之后，就可以开始使用PHPExcel来创建Excel文件了。 接下来，我们可以介绍PHPExcel的几个核心类和它们的作用： - PHPExcel: 这是操作Excel文件的主要类，可以用来创建新的Excel文档和读取现有文档。 - PHPExcel_IOFactory: 这个类提供了一个静态方法`createWriter()`, 它可以用来创建一个针对特定格式的写入器。 - PHPExcel_Writer: 这个类的实例被用来将PHPExcel对象模型写入到文件系统。它包含了多种格式的实现，如`PHPExcel_Writer_Excel2007`。 - PHPExcel看书: 这个类提供了对Excel工作簿的抽象，包含工作表（Worksheet）、格式（Style）、单元格（Cell）等。 - PHPExcel_STYLE: 这个类用于设置单元格样式，例如字体、对齐和边框。 创建Excel文件的示例代码 现在，让我们来创建一个简单的Excel文件。以下是使用PHPExcel创建一个Excel文件的基本示例代码： ```php <?php // 引入PHPExcel类文件 require_once 'PHPExcel.php'; // 创建一个新的工作簿对象 $excel = new PHPExcel(); // 设置活动工作表索引为0，因为一个工作簿可以有多个工作表 $sheet = $excel->setActiveSheetIndex(0); // 设置A*单元格的值为"Hello, PHPExcel!" $sheet->getCell('A1')->setValue('Hello, PHPExcel!'); // 保存Excel文件 $writer = PHPExcel_IOFactory::createWriter($excel, 'Excel2007'); $writer->save('php-excels.xlsx');

代码分析：

我们首先引入了PHPExcel类文件，这样我们才能使用PHPExcel类及其相关方法。
使用 PHPExcel 类创建一个新的工作簿对象。
我们通过 getActiveSheetIndex() 方法获取活动工作表，然后使用 getCell() 方法指定要操作的单元格（这里是”A1″）。
接着我们使用 setValue() 方法设置单元格的值为”Hello, PHPExcel!”。
最后，我们使用 PHPExcel_IOFactory 创建了一个写入器实例，并通过 save() 方法将Excel文档保存到磁盘上。

以上代码执行后，会在同一目录下生成一个名为 php-excels.xlsx 的新Excel文件，其中包含一行文本”Hello, PHPExcel!”。

接下来，我们将介绍如何设置Excel文件的基本属性，包括文件的标题、作者以及视图和样式等。

4. 读取Excel文件内容

4.1 读取Excel文件的基本操作

4.1.1 读取Excel文件的类和方法

在使用PHP读取Excel文件时，有几种主要的类和方法可以使用，它们分别是：

PHPExcel_Reader_IExcel2007 ：用于读取Excel 2007及更高版本的文件（.xlsx格式）。
PHPExcel_Reader_IExcel5 ：用于读取Excel 5-2003版本的文件（.xls格式）。
PHPExcel_Reader_I2003XML ：用于读取Excel 2003 XML格式的文件（.xml格式）。

要读取一个Excel文件，首先需要实例化上述类之一。例如，如果要读取一个 .xlsx 文件，可以使用 PHPExcel_Reader_IExcel2007 类。

<?php require_once 'vendor/autoload.php'; // 实例化读取器 $reader = PHPExcel_IOFactory::createReader('Excel2007'); // 加载Excel文件 $objPhpExcel = $reader->load('path/to/your/excel/file.xlsx'); ?>

4.1.2 读取Excel文件内容的示例代码

下面是一个简单的示例代码，展示如何加载并读取一个Excel文件中的内容：

<?php require_once 'vendor/autoload.php'; // 实例化读取器 $reader = PHPExcel_IOFactory::createReader('Excel2007'); // 加载Excel文件 $objPhpExcel = $reader->load('path/to/your/excel/file.xlsx'); // 获取活动工作表 $sheet = $objPhpExcel->getActiveSheet(); // 遍历活动工作表中的所有行 foreach ($sheet->getRowIterator() as $row) { // 获取当前行的单元格迭代器 $cellIterator = $row->getCellIterator(); $cellIterator->setIterateOnlyExistingCells(false); // 遍历所有单元格，即使它们为空 // 遍历当前行的所有单元格 foreach ($cellIterator as $cell) { // 输出单元格的值 echo $cell->getValue() . ' '; } echo PHP_EOL; // 输出换行符 } ?>

4.1.3 代码逻辑的逐行解读分析

在上面的示例代码中，我们首先引入了Composer自动加载文件，确保了我们能够使用 PHPExcel_IOFactory 类。

require_once 'vendor/autoload.php';

接着，我们实例化了一个针对Excel 2007文件的读取器。

$reader = PHPExcel_IOFactory::createReader('Excel2007');

然后，我们使用这个读取器加载了位于指定路径的Excel文件。

$objPhpExcel = $reader->load('path/to/your/excel/file.xlsx');

通过调用 getActiveSheet() 方法，我们获取了活动工作表的引用。

$sheet = $objPhpExcel->getActiveSheet();

接下来，我们遍历活动工作表中的所有行。使用 getRowIterator() 方法，我们可以得到一个迭代器，它允许我们遍历工作表中的每一行。

foreach ($sheet->getRowIterator() as $row) { ... }

对于每一行，我们又得到了一个单元格迭代器。这里需要注意的是，我们通过 setIterateOnlyExistingCells(false) 方法设置迭代器，让它也遍历那些原本是空的单元格。

$cellIterator = $row->getCellIterator(); $cellIterator->setIterateOnlyExistingCells(false);

随后，我们遍历每一行中的所有单元格，并输出它们的值。

foreach ($cellIterator as $cell) { echo $cell->getValue() . ' '; }

最后，我们在每一行输出完毕后输出一个换行符，这样在控制台中查看结果时会更易于阅读。

echo PHP_EOL;

4.1.4 代码块中使用的参数说明

在上面的代码中，我们使用了以下参数：

$reader ：代表一个特定格式的Excel文件读取器实例。
$objPhpExcel ：代表加载的Excel文件对象。
$sheet ：代表工作表对象。
$row ：代表当前遍历到的行对象。
$cell ：代表当前行中的单元格对象。

通过使用这些对象和方法，我们可以逐行逐列地读取Excel文件中的数据，并进行相应的处理。

5. 写入数据到Excel文件

5.1 写入数据的基本操作

5.1.1 写入数据的类和方法

要将数据写入到Excel文件中，我们需要使用到 PHPExcel_Writer_IWriter 接口。该接口有多种实现，比如 PHPExcel_Writer_Excel2007 （用于写入 .xlsx 格式文件）， PHPExcel_Writer_Excel5 （用于写入 .xls 格式文件）。在这个例子中，我们将使用 PHPExcel_Writer_Excel2007 类。

5.1.2 写入数据到Excel文件的示例代码

<?php require 'vendor/autoload.php'; // 创建一个 PHPExcel 对象 $excel = new PHPExcel(); $sheet = $excel->getActiveSheet(); // 写入数据示例 $sheet->getCell('A1')->setValue('Hello'); $sheet->getCell('B1')->setValue(12345); // 获取写入器实例 $objWriter = PHPExcel_IOFactory::createWriter($excel, 'Excel2007'); // 设置文件名 $objWriter->save('sample.xlsx'); ?>

在以上示例代码中，首先我们创建了一个 PHPExcel 对象，并获取其活动工作表。然后，我们对工作表中的A1和B*单元格写入了文本和数字。之后，我们创建了一个 PHPExcel_Writer_Excel2007 对象，并调用 save 方法将数据写入到一个名为 “sample.xlsx” 的文件中。

5.2 设置写入数据的格式和样式

5.2.1 设置单元格的格式和样式

要改变写入数据的格式和样式，我们可以在写入数据之后，设置单元格的样式。

<?php // ...之前的代码保持不变... // 设置单元格A1的格式 $cellStyle = $sheet->getStyle('A1'); $font = $cellStyle->getFont(); $font->setName('Arial'); $font->setSize(20); $cellStyle->applyFromArray(array( 'font' => array( 'bold' => true ), 'fill' => array( 'type' => PHPExcel_Style_Fill::FILL_SOLID, 'color' => array('rgb' => 'FFFF0000'), // 红色填充 ), )); // 设置单元格B1的样式 $sheet->getStyle('B1')->getNumberFormat()->setFormatCode(PHPExcel_Style_NumberFormat::FORMAT_NUMBER_COMMA_SEPARATED1); // 保存文件 $objWriter->save('sample_styled.xlsx'); ?>

上述代码中，首先为单元格A1设置了字体类型、字体大小和加粗，以及填充样式。然后为单元格B1设置了数字格式，这样数字将以逗号分隔的形式显示。最后保存了具有这些样式的Excel文件。

5.2.2 设置数据的对齐和颜色

接下来，我们会演示如何设置单元格数据的对齐方式和边框颜色。

<?php // ...之前的代码保持不变... // 设置对齐方式 $cellStyle = $sheet->getStyle('A1:B1'); $cellStyle->getAlignment()->setHorizontal(PHPExcel_Style_Alignment::HORIZONTAL_CENTER); // 设置边框 $border = $cellStyle->getBorders(); $border->getBottom()->set样式('solid'); // 设置下边框为实线 $border->getBottom()->set样式('thin'); // 设置下边框为细线 $border->getBottom()->getColor()->setARGB('FF000000'); // 设置下边框颜色为黑色 // 保存文件 $objWriter->save('sample_styled_alignment.xlsx'); ?>

在这段代码中，我们设置了A1到B 单元格的水平对齐方式为中心对齐，并给B 单元格的下边框添加了黑色的细实线。通过 PHPExcel_Style_Border 类，我们定义了边框样式和颜色。

这个章节展示了在PHP中使用PHPExcel库写入数据到Excel文件，并对写入的数据进行格式化和样式设置的详细步骤。通过上述示例，可以按照需要对Excel文件中的单元格进行细致的格式化，实现数据的美化展示。