本文旨在解决 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。
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use App\Models\Order; // 假设您的Order模型
use App\Models\UserData; // 假设您的UserData模型
use PDF; // 确保已引入Dompdf门面
class InvoiceController extends Controller
{
public function invoicepdf($productid, $orderId)
{
// 原始业务逻辑，用于获取订单、产品和商家详情
$orderHistory = Order::where('order_id', $orderId)->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 编码的图片直接嵌入到 标签中。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>发票</title>
<style>
/* 可以在这里添加一些基本的样式 */
body {
font-family: 'sans-serif'; /* 确保字体与Dompdf设置一致 */
}
.center-image {
text-align: center;
margin-bottom: 20px;
}
</style>
</head>
<body>
<div class="center-image">
@if ($imageData && $imageMime)
<!-- 使用 Base64 编码的图片数据 -->
<img src="data:{{ $imageMime }};base64,{{ $imageData }}" style="max-width:90%" alt="Laravel Dompdf PDF 生成中图片嵌入的最佳实践与常见问题解决" >
@else
<!-- 图片不存在时的占位符或提示 -->
<p>图片未找到或无法加载。</p>
@endif
</div>
<h1>发票详情</h1>
<p>订单号: {{ $orderHistory->order_id }}</p>
<p>产品名称: {{ $productDetails['product_name'] ?? 'N/A' }}</p>
<p>商家: {{ $marchantdetails->name ?? 'N/A' }}</p>
<p>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.</p>
<!-- 更多发票内容 -->
</body>
</html>代码说明：
- 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 文档而言，这是最可靠和推荐的解决方案。
