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

 更新时间:2025年11月07日 10:29:13   作者:技术小丁  
本文介绍了使用PHP和PhpSpreadsheet库生成带图片Excel报表的方法,重点讲解了图片插入函数实现、数据准备、Excel文件创建和保存等关键步骤,需要的朋友可以参考下

在现代 Web 开发中,经常需要生成包含数据和图片的 Excel 报表。本文将介绍如何使用 PHP 和 PhpOffice\PhpSpreadsheet 库创建一个包含图片的 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);
}

这个函数使用 PhpOffice\PhpSpreadsheet\Worksheet\Drawing 类来处理图片插入,设置了图片的尺寸、位置和偏移量。

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 类处理图片插入
  • 设置合适的行高和列宽以适应图片
  • 使用 setOffsetXsetOffsetY 调整图片在单元格中的位置
  • 确保图片路径正确且文件存在

实际效果

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

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

完整代码

<?php
require __DIR__ . '/vendor/autoload.php';
​
use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Worksheet\Drawing;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
​
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');

到此这篇关于使用PHP和PhpSpreadsheet在Excel中插入图片的完整代码的文章就介绍到这了,更多相关PHP在Excel中插入图片内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • PHP判断一个字符串是否是回文字符串的方法

    PHP判断一个字符串是否是回文字符串的方法

    这篇文章主要介绍了PHP判断一个字符串是否是回文字符串的方法,实例分析了php操作字符串判断回文的技巧,具有一定参考借鉴价值,需要的朋友可以参考下
    2015-03-03
  • 详解如何在PHP代码里面调用Go程序

    详解如何在PHP代码里面调用Go程序

    PHP和Go都是广泛使用的编程语言,但各自具有其独特的优势和特性,那么如何在PHP代码里面调用Go程序呢,下面小编就来为大家介绍一下常用的两种方法
    2023-11-11
  • php中base64_decode与base64_encode加密解密函数实例

    php中base64_decode与base64_encode加密解密函数实例

    这篇文章主要介绍了php中base64_decode与base64_encode加密解密函数,实例分析了base64加密解密函数的具体用法,具有一定的实用价值,需要的朋友可以参考下
    2014-11-11
  • 浅谈Laravel中使用Slack进行异常通知

    浅谈Laravel中使用Slack进行异常通知

    异常处理是软件开发过程中无法逃避的问题。对于一套设计良好代码高效的程序,出现异常的可能性会比较低,但这并不意味着不会出现异常,有些异常甚至会引起严重的后果,所以如何及时的发现程序中的异常并处理它便显得十分重要了。
    2021-05-05
  • PHP常见错误提示含义解释(实用!值得收藏)

    PHP常见错误提示含义解释(实用!值得收藏)

    这篇文章主要介绍了PHP常见错误提示含义解释,包含了各种常见的PHP错误提示及具体含义,便于查询参考,需要的朋友可以参考下
    2016-04-04
  • jQuery+php简单实现全选删除的方法

    jQuery+php简单实现全选删除的方法

    这篇文章主要介绍了jQuery+php简单实现全选删除的方法,涉及php结合jQuery操作表单的全选及ajax交互实现删除的相关技巧,需要的朋友可以参考下
    2016-11-11
  • PHP行为设计模式之策略模式

    PHP行为设计模式之策略模式

    这篇文章主要介绍了PHP行为设计模式之策略模式,策略模式(Strategy pattern)是行为类模式中的一个类型。行为类模式用来说明一个应用是如何运作的
    2023-04-04
  • PHP获取QQ达人QQ信息的方法

    PHP获取QQ达人QQ信息的方法

    这篇文章主要介绍了PHP获取QQ达人QQ信息的方法,实例分析了php获取QQ信息的原理与对应的实现技巧,具有一定参考借鉴价值,需要的朋友可以参考下
    2015-03-03
  • php安全开发 添加随机字符串验证,防止伪造跨站请求

    php安全开发 添加随机字符串验证,防止伪造跨站请求

    伪造跨站请求比较难以防范,而且危害巨大,攻击者可以通过这种方式恶作剧,发spam信息,删除数据等等。那怎么防范伪造跨站攻击呢
    2013-02-02
  • PHP return语句的另一个作用

    PHP return语句的另一个作用

    这篇文章主要介绍了PHP return语句的另一个作用,在bbPress的代码中看到的一个奇葩使用方法,需要的朋友可以参考下
    2014-07-07

最新评论