使用 PHP 和 PhpSpreadsheet 在 Excel 中插入图片（附完整代码）

在现代 Web 开发中，经常需要生成包含数据和图片的 Excel 报表。本文将介绍如何使用 PHP 和 PhpOfficePhpSpreadsheet 库创建一个包含图片的 Excel 文件。

准备工作

首先需要安装 PhpSpreadsheet 库：

composer require phpoffice/phpspreadsheet

核心实现

1. 创建图片插入函数

function addImageToCell($worksheet, $imagePath, $cell, $name)
{
    $drawing = new Drawing();
    $drawing->setName($name);
    $drawing->setDescription($name);
    $drawing->setPath($imagePath);
    $drawing->setHeight(80);
    $drawing->setWidth(100);
    $drawing->setCoordinates($cell);
    $drawing->setOffsetX(5);
    $drawing->setOffsetY(5);
    $drawing->setWorksheet($worksheet);
}

这个函数使用 PhpOfficePhpSpreadsheetWorksheetDrawing 类来处理图片插入，设置了图片的尺寸、位置和偏移量。

2. 准备数据

$header = [\'课程名称\', \'图片\'];
$list = [
    [
        \'name\' => \'thinkphp\',
        \'image\' => \'images/thinkphp.png\'
    ],
    [
        \'name\' => \'npm\',
        \'image\' => \'images/npm.png\'
    ],
    [
        \'name\' => \'uni-app\',
        \'image\' => \'images/uni-app.jpg\'
    ]
];

3. 创建 Excel 并填充数据

$spreadsheet = new Spreadsheet();
$worksheet = $spreadsheet->getActiveSheet();
​
// 填充标题行
$worksheet->setCellValue(\'A1\', $header[0]);
$worksheet->setCellValue(\'B1\', $header[1]);
$worksheet->getColumnDimension(\'B\')->setWidth(15);
​
$line = 1;
foreach ($list as $k => $v) {
    $line++;
    $worksheet->getRowDimension($line)->setRowHeight(100);
    $worksheet->getCell(\'A\' . $line)->setValue($v[\'name\']);
    addImageToCell($worksheet, $v[\'image\'], \'B\' . $line, $v[\'name\']);
}

4. 保存文件

通过命令行保存文件：php index.php

$writer = new Xlsx($spreadsheet);
$filename = \'course_list.xlsx\';
$writer->save($filename);

通过站点保存文件：php -S 127.0.0.1:8888，访问127.0.0.1:8888可直接触发下载。也可以通过Ngnix等部署成站点，访问下载

header(\'Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\');
header(\'Content-Disposition: attachment;filename=\"course_list.xlsx\"\');
header(\'Cache-Control: max-age=0\');
​
$writer = new Xlsx($spreadsheet);
$writer->save(\'php://output\');

关键要点

• 使用 Drawing 类处理图片插入
• 设置合适的行高和列宽以适应图片
• 使用 setOffsetX 和 setOffsetY 调整图片在单元格中的位置
• 确保图片路径正确且文件存在

实际效果

生成的 Excel 文件将包含两列：课程名称和对应的图片，每张图片都会整齐地显示在单元格中，具有良好的视觉效果。

这种方法非常适合生成产品目录、员工信息表、课程列表等需要同时展示文本信息和图片的报表。

完整代码

<?php
require __DIR__ . \'/vendor/autoload.php\';
​
use PhpOfficePhpSpreadsheetSpreadsheet;
use PhpOfficePhpSpreadsheetWorksheetDrawing;
use PhpOfficePhpSpreadsheetWriterXlsx;
​
function addImageToCell($worksheet, $imagePath, $cell, $name)
{
    $drawing = new Drawing();
    $drawing->setName($name);
    $drawing->setDescription($name);
    $drawing->setPath($imagePath);
    $drawing->setHeight(80);
    $drawing->setWidth(100);
    $drawing->setCoordinates($cell);
    $drawing->setOffsetX(5);
    $drawing->setOffsetY(5);
    $drawing->setWorksheet($worksheet);
}
​
// 示例数据
$header = [\'课程名称\', \'图片\'];
$list = [
    [
        \'name\' => \'thinkphp\',
        \'image\' => \'images/thinkphp.png\'
    ],
    [
        \'name\' => \'npm\',
        \'image\' => \'images/npm.png\'
    ],
    [
        \'name\' => \'uni-app\',
        \'image\' => \'images/uni-app.jpg\'
    ]
];
​
$spreadsheet = new Spreadsheet();
$worksheet = $spreadsheet->getActiveSheet();
​
// 填充标题行
$worksheet->setCellValue(\'A1\', $header[0]);
$worksheet->setCellValue(\'B1\', $header[1]);
$worksheet->getColumnDimension(\'B\')->setWidth(15);
$line = 1;
foreach ($list as $k => $v) {
    $line++;
    $worksheet->getRowDimension($line)->setRowHeight(100);
    $worksheet->getCell(\'A\' . $line)->setValue($v[\'name\']);
    addImageToCell($worksheet, $v[\'image\'], \'B\' . $line, $v[\'name\']);
}
​
// 保存为 Excel 文件
$writer = new Xlsx($spreadsheet);
$filename = \'course_list.xlsx\';
$writer->save($filename);
​
// 下载 Excel 文件
// header(\'Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\');
// header(\'Content-Disposition: attachment;filename=\"course_list.xlsx\"\');
// header(\'Cache-Control: max-age=0\');
// $writer = new Xlsx($spreadsheet);
// $writer->save(\'php://output\');