0

0

Laravel Excel 条件化插入图片的正确实现方式

花韻仙語

花韻仙語

发布时间:2026-01-25 12:37:29

|

424人浏览过

|

来源于php中文网

原创

Laravel Excel 条件化插入图片的正确实现方式

laravel excel 导出中,可通过 `withdrawings` 接口动态控制图片是否插入:关键是在 `drawings()` 方法中根据条件返回 `drawing` 实例或 `null`,而非无条件创建对象,从而避免“file not found”等异常。

在使用 laravel-excel 进行导出时,若需按业务逻辑条件性插入图片(例如仅当 $this->semnat === 1 且图片路径有效时才渲染签名图),直接在 drawings() 方法中构造 Drawing 对象但未校验前置条件,会导致 Excel Writer 尝试加载空或不存在的路径,最终抛出 File not found! 错误。

正确的做法是:将图片实例的创建与返回完全包裹在条件判断内,并确保路径存在、可读。以下是推荐实现:

use PhpOffice\PhpSpreadsheet\Worksheet\Drawing;

public function drawings()
{
    // ✅ 双重校验:开关开启 + 图片路径非空 + 文件实际存在
    if ($this->semnat === 1 
        && $this->imgPath 
        && file_exists(storage_path('app/public/' . $this->imgPath))) {

        $drawing = new Drawing();
        $drawing->setName('Semnatura');
        $drawing->setDescription('This is my logo');
        $drawing->setHeight(100);
        $drawing->setCoordinates('F3'); // 插入到 F3 单元格
        $drawing->setPath(storage_path('app/public/' . $this->imgPath));

        return $drawing;
    }

    // ❌ 必须显式返回 null;返回空数组、false 或不返回均会触发异常
    return null;
}

⚠️ 重要注意事项

网趣网上购物系统HTML静态版
网趣网上购物系统HTML静态版

网趣购物系统静态版支持网站一键静态生成,采用动态进度条模式生成静态,生成过程更加清晰明确,商品管理上增加淘宝数据包导入功能,与淘宝数据同步更新!采用领先的AJAX+XML相融技术,速度更快更高效!系统进行了大量的实用性更新,如优化核心算法、增加商品图片批量上传、谷歌地图浏览插入等,静态版独特的生成算法技术使静态生成过程可随意掌控,从而可以大大减轻服务器的负担,结合多种强大的SEO优化方式于一体,使

下载
  • drawings() 方法必须返回 null 或单个 Drawing 实例(不支持返回数组);
  • 若返回非 null 非 Drawing 类型值(如 [], false, ''),laravel-excel 内部会尝试调用 getPath() 导致报错;
  • 建议增加 file_exists() 检查,避免因文件被删除或路径错误导致导出中断;
  • WithDrawings 接口本身不提供“禁用”机制,因此条件逻辑必须在 drawings() 方法内完成,无需拆分多个导出类,彻底避免代码重复。

通过该方式,你可在同一导出类中灵活控制图片渲染,兼顾可维护性与健壮性。

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

319

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

277

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

370

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

371

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

81

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

65

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

68

2025.08.05

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

234

2023.09.22

c++ 根号
c++ 根号

本专题整合了c++根号相关教程,阅读专题下面的文章了解更多详细内容。

41

2026.01.23

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 9.3万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 10.8万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号