php怎么读取excel

PHP读取Excel文件的完整指南：从入门到实践

在Web开发中，处理Excel文件是常见需求，比如批量导入用户数据、导出订单报表等，PHP作为主流的服务端语言，提供了多种方式读取Excel文件，本文将详细介绍PHP读取Excel的常用方法、具体实现步骤及注意事项,帮助开发者快速这一技能。

PHP读取Excel的常用方案

PHP读取Excel文件的主流库包括：

1. PhpSpreadsheet（推荐）：PhpOffice团队维护的 successor，功能全面，支持.xls和.xlsx格式，是目前最活跃的Excel处理库。
2. PHPExcel（已停止维护）：PhpSpreadsheet的前身，虽仍被使用，但不再更新，新项目不建议采用。
3. SimpleXLSX：轻量级库，仅支持.xlsx格式，适合简单场景。
4. 原生方法：通过fgetcsv解析CSV格式（Excel可另存为CSV），适合基础需求。

PhpSpreadsheet因兼容性强、功能丰富（支持读取、写入、格式设置等），成为开发者的首选,本文将以PhpSpreadsheet为例展开讲解。

环境准备：安装PhpSpreadsheet

PhpSpreadsheet通过Composer（PHP依赖管理工具）安装，确保项目中已安装Composer。

安装Composer

若未安装Composer，可从官网下载并按提示安装（Windows下下载composer-setup.exe，Linux/Mac通过命令行安装）。

引入PhpSpreadsheet

在项目根目录下执行以下命令：

composer require phpoffice/phpspreadsheet

安装完成后，项目会自动生成vendor目录，并通过autoload.php自动加载类。

核心步骤：使用PhpSpreadsheet读取Excel

假设有一个Excel文件data.xlsx，存放在./uploads/目录下，内容如下：

引入Composer自动加载文件

在PHP脚本开头引入autoload.php：

require 'vendor/autoload.php';

加载Excel文件

使用IOFactory的createReaderForFile方法自动识别文件格式（支持.xls和.xlsx），或直接指定格式：

use PhpOffice\PhpSpreadsheet\IOFactory;
// 文件路径
$filePath = './uploads/data.xlsx';
try {
    // 自动识别文件类型并加载
    $spreadsheet = IOFactory::load($filePath);
    // 若明确知道是xlsx格式，可直接用：
    // $reader = IOFactory::createReaderForFile($filePath);
    // $spreadsheet = $reader->load($filePath);
} catch (\Exception $e) {
    die("无法加载文件: " . $e->getMessage());
}

获取活动工作表（Sheet）

Excel文件可能包含多个工作表，通过getActiveSheet()获取当前活动的工作表（默认第一个）：

$sheet = $spreadsheet->getActiveSheet();

读取单元格数据

PhpSpreadsheet提供了多种方式读取单元格数据，常用方法包括：

（1）按单元格坐标读取（如A1、B2）

// 获取A1单元格的值（姓名列标题）
$nameHeader = $sheet->getCell('A1')->getValue();
echo "列标题: " . $nameHeader . "<br>";
// 获取B2单元格的值（张三的年龄）
$age = $sheet->getCell('B2')->getValue();
echo "张三的年龄: " . $age . "<br>";

（2）按行和列索引读取（从1开始）

// 获取第2行第1列的值（姓名列第一个数据）
$name1 = $sheet->getCellByColumnAndRow(1, 2)->getValue();
echo "第2行姓名: " . $name1 . "<br>";
// 获取第3行第3列的值（邮件列第二个数据）
$email2 = $sheet->getCellByColumnAndRow(3, 3)->getValue();
echo "第3行邮件: " . $email2 . "<br>";

（3）批量读取整行或整列

// 读取第2行所有数据（数组形式，索引从0开始）
$rowData = $sheet->getRowIterator(2)->current()->toArray();
print_r($rowData); // 输出: ["张三", 25, "zhangsan@.com"]
// 读取A列所有数据（从第1行到最后一行）
$columnData = $sheet->getColumnIterator('A')->toArray();
foreach ($columnData as $cell) {
    echo $cell->getValue() . "<br>"; // 输出: 姓名、张三、李四、王五
}

（4）遍历所有数据（常用方式）

通过getRowIterator和getColumnIterator循环遍历所有行和列：

$data = [];
foreach ($sheet->getRowIterator() as $row) {
    $rowData = [];
    foreach ($row->getCellIterator() as $cell) {
        $rowData[] = $cell->getValue();
    }
    $data[] = $rowData;
}
// 输出所有数据（二维数组）
print_r($data);

输出结果：

Array
(
    [0] => Array ( [0] => 姓名 [1] => 年龄 [2] => 邮件 )
    [1] => Array ( [0] => 张三 [1] => 25 [2] => zhangsan@.com )
    [2] => Array ( [0] => 李四 [1] => 30 [2] => lisi@.com )
    [3] => Array ( [0] => 王五 [1] => 28 [2] => wangwu@.com )
)

处理大数据量（优化内存）

Excel文件较大时（如超过1万行），直接加载整个文件到内存可能导致内存溢出，PhpSpreadsheet提供setReadDataOnly和setReadEmptyCells方法优化：

$reader = IOFactory::createReaderForFile($filePath);
// 仅读取数据，不读取格式（减少内存）
$reader->setReadDataOnly(true);
// 不读取空单元格
$reader->setReadEmptyCells(false);
$spreadsheet = $reader->load($filePath);

更彻底的方式是使用“只读”模式（适用于.xlsx）：

$reader = IOFactory::createReader('Xlsx');
$reader->setReadDataOnly(true);
$spreadsheet = $reader->load($filePath);

处理常见问题

文件编码问题

若Excel中的中文内容乱码，可能是编码不匹配，确保Excel文件保存为UTF-8格式，或在读取时指定编码：

// 若数据是GBK编码，需转换
$value = $cell->getValue();
$utf8Value = mb_convert_encoding($value, 'UTF-8', 'GBK');

读取公式结果

Excel单元格可能包含公式（如=A1+B1），默认读取的是公式本身，若需读取计算结果，需启用setReadDataOnly(false)（默认关闭）：

$reader = IOFactory::createReaderForFile($filePath);
$reader->setReadDataOnly(false); // 读取公式结果
$spreadsheet = $reader->load($filePath);

处理合并单元格

合并单元格的值仅存储在左上角单元格，其他单元格为空，需先判断单元格是否为合并单元格，再获取值：

$cell = $sheet->getCell('A2');
if ($sheet->mergeCellsExists($cell->getCoordinate())) {
    $value = $cell->getValue();
} else {
    $value = $cell->getValue();
}

完整代码示例

以下是一个完整的PHP脚本，读取data.xlsx并输出为HTML表格：

<?php
require 'vendor/autoload.php';
use PhpOffice\PhpSpreadsheet\IOFactory;
$filePath = './uploads/data.xlsx';
try {
    // 加载Excel文件
    $spreadsheet = IOFactory::load($filePath);
    $sheet = $spreadsheet->getActiveSheet();
    // 获取总行数和列数
    $highestRow = $sheet->getHighestRow(); // 最大行数
    $highestColumn = $sheet->getHighestColumn(); // 最大列数（字母，如'A'）
    // 输出HTML表格
    echo "<table border='1' cellpadding='5' cellspacing='0'>";
    foreach ($sheet->getRowIterator() as $row) {
        echo "<tr>";
        foreach ($row->getCellIterator() as $cell) {
            echo "<td>" . htmlspecialchars($cell