本文旨在解决 Laravel Dompdf 在生成 PDF 时图片无法正确显示的问题。传统上使用 `public_path()` 引用图片路径在 Dompdf 环境中常失效，本教程将详细介绍如何通过将图片内容进行 Base64 编码，并直接嵌入到 HTML `` 标签中，从而确保图片在生成的 PDF 文件中稳定、可靠地显示。此方法适用于 Laravel 8 及更高版本，是处理此类图像嵌入挑战的有效策略。
在使用 Laravel 的 Dompdf 服务提供者生成 PDF 文件时，开发者经常会遇到图片无法正确显示的问题，即使使用了 public_path() 等辅助函数来指定图片路径。这主要是因为 Dompdf 在渲染 HTML 到 PDF 时，其内部渲染引擎对文件系统路径的解析方式与浏览器直接访问 URL 不同。Dompdf 无法直接通过服务器的公共路径（例如 public/image.png 对应的 URL）来获取图片资源。最可靠的解决方案是将图片数据直接嵌入到 HTML 中，而不是依赖外部链接。
核心解决方案：Base64 编码图片
将图片内容进行 Base64 编码，然后将编码后的字符串直接嵌入到 HTML 的 标签的 src 属性中，是一种通用且高度可靠的方法。这种方式将图片数据作为文本内容直接包含在 HTML 中，使得 PDF 渲染器无需进行额外的网络请求或文件系统查找，确保图片能够稳定显示。
步骤一：在控制器中获取图片内容并进行 Base64 编码
在将数据传递给 Blade 视图之前，您需要在控制器中读取图片文件，将其内容编码为 Base64 字符串，并获取图片的 MIME 类型。
假设您的图片位于 public/images/logo.png。
orderBy('id', 'DESC')->first(); $orderProductDetails = json_decode($orderHistory->product_details, true); $productDetails = []; $marchantdetails = null; foreach ($orderProductDetails as $orderdata) { foreach ($orderdata as $orderDetail) { if ($orderDetail['product_id'] == $productid) { $productDetails = $orderDetail; $marchantdetails = UserData::where('user_id', $orderDetail['marchent_id'])->first(); break 2; // 找到匹配项后跳出两层循环 } } } // --- 图片处理开始 --- $imagePath = public_path('images/logo.png'); // 指定您的图片路径 $imageData = null; $imageMime = null; if (file_exists($imagePath)) { // 读取图片内容并进行 Base64 编码 $imageData = base64_encode(file_get_contents($imagePath)); // 获取图片的 MIME 类型，例如 'image/png', 'image/jpeg' $imageMime = mime_content_type($imagePath); } // --- 图片处理结束 --- // 将编码后的图片数据和MIME类型传递给视图 $pdf = PDF::loadView('front_end.invoice', compact('orderHistory', 'productDetails', 'marchantdetails', 'imageData', 'imageMime')) ->setOptions(['defaultFont' => 'sans-serif']); // 可选：设置默认字体以支持中文等 // 下载 PDF 文件 return $pdf->download('invoice_' . $orderId . '.pdf'); }}
代码说明：
public_path(‘images/logo.png’)：用于获取图片在文件系统中的绝对路径。请根据您的实际图片位置调整。file_exists($imagePath)：检查图片文件是否存在，避免因文件不存在而报错。file_get_contents($imagePath)：读取图片文件的二进制内容。base64_encode()：将二进制内容编码为 Base64 字符串。mime_content_type($imagePath)：动态获取图片的 MIME 类型，这对于构建 data: URI 非常重要。
步骤二：在 Blade 模板中嵌入 Base64 编码图片
在您的 Blade 视图文件 (front_end/invoice.blade.php) 中，使用 data: URI 方案将 Base64 编码的图片直接嵌入到 标签中。
发票 /* 可以在这里添加一些基本的样式 */ body { font-family: 'sans-serif'; /* 确保字体与Dompdf设置一致 */ } .center-image { text-align: center; margin-bottom: 20px; }@if ($imageData && $imageMime) @@##@@ @else图片未找到或无法加载。
@endif发票详情
订单号: {{ $orderHistory->order_id }}
产品名称: {{ $productDetails['product_name'] ?? 'N/A' }}
商家: {{ $marchantdetails->name ?? 'N/A' }}
ut aliquip ex ea commodoconsequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidata.
代码说明：
src=”data:{{ $imageMime }};base64,{{ $imageData }}”：这是关键部分。data: URI 允许直接在 HTML 中嵌入文件内容。{{ $imageMime }}：由控制器传递的图片 MIME 类型（例如 image/png）。base64,：指示后面的数据是 Base64 编码的。{{ $imageData }}：由控制器传递的 Base64 编码的图片字符串。通过 标签的 style 属性可以控制图片的大小和样式。
注意事项
图片大小与性能： Base64 编码会使图片文件大小增加约 33%。对于小型图标或 Logo 来说，这是可接受的。但如果需要嵌入大量或非常大的图片，这可能会显著增加 PDF 文件的大小，延长生成时间，并消耗更多的服务器内存。在这种情况下，可能需要重新评估方案或优化图片。MIME 类型准确性： 确保 data: URI 中的 MIME 类型（例如 image/png、image/jpeg）与实际图片类型匹配。错误的 MIME 类型可能导致图片无法显示。使用 mime_content_type() 函数可以动态获取正确的 MIME 类型。字体问题： Dompdf 在处理中文等非拉丁字符时，可能需要额外的字体配置。如果 PDF 中包含中文，请确保在 Dompdf 配置中设置了支持中文的字体（如 setOptions([‘defaultFont’ => ‘sans-serif’])，并确保服务器上安装了该字体或在 Dompdf 中注册了自定义字体）。图片路径： 在控制器中读取图片时，请确保图片路径是正确的，并且 PHP 进程有权限读取该文件。public_path() 是获取公共目录下的文件路径的便捷方法。
总结
通过将图片内容 Base64 编码并直接嵌入到 HTML 的 标签中，可以有效解决 Laravel Dompdf 在生成 PDF 时图片无法显示的问题。这种方法确保了图片数据的自包含性，避免了 Dompdf 渲染引擎在解析外部图片路径时可能遇到的各种兼容性问题。尽管需要注意大图片可能带来的性能开销，但对于大多数包含 Logo 或小图标的 PDF 文档而言，这是最可靠和推荐的解决方案。
以上就是Laravel Dompdf PDF 生成中图片嵌入的最佳实践与常见问题解决的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1341331.html
微信扫一扫 
支付宝扫一扫 
