本文旨在解决在 laravel dompdf 生成 pdf 文件时，通过 public_path() 引用本地图片失败的问题。我们将详细介绍一种稳定可靠的解决方案：将图片文件转换为 base64 编码字符串，并直接嵌入到 blade 模板的 标签中。本教程将提供详细的实现步骤、示例代码以及相关的注意事项，帮助开发者确保图片在生成的 pdf 中正确显示。
在使用 Laravel 框架结合 Dompdf 服务提供者生成 PDF 文件时，开发者常常会遇到一个常见问题：在 Blade 模板中尝试使用 public_path() 或相对路径来引用本地图片时，图片无法正常显示在最终生成的 PDF 中。尽管 PDF 文件本身能够成功下载，但图片区域通常显示为空白或损坏图标。
这背后的主要原因在于 Dompdf 在渲染 HTML 到 PDF 的过程中，其运行环境与 Web 服务器环境有所不同。它可能无法正确解析或访问文件系统中的本地路径，尤其是在服务器部署环境下，路径权限、Web 服务器配置等因素都可能导致图片加载失败。为了克服这一限制，我们需要一种更直接、更可靠的图片嵌入方法。
Base64 编码是一种将二进制数据（如图片）转换为 ASCII 字符串的编码方式。这种编码后的字符串可以直接嵌入到 HTML 的 标签的 src 属性中，格式为 data:image/[图片类型];base64,[Base64编码字符串]。
这种方法的优势在于：
以下是将图片通过 Base64 编码嵌入到 Laravel Dompdf 生成的 PDF 中的具体步骤。
在 Laravel 控制器中，我们需要读取目标图片文件，将其内容转换为 Base64 编码字符串，然后将这个字符串传递给 Blade 视图。
假设您的图片文件位于 public/image.png。
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use App\Models\Order;
use App\Models\UserData;
use PDF; // 确保您已正确引入 Dompdf 服务提供者
use Illuminate\Support\Facades\File; // 用于文件操作
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('image.png'); // 假设图片在 public/image.png
$base64Image = '';
if (File::exists($imagePath)) {
$imageData = File::get($imagePath); // 读取图片二进制数据
$base64Image = base64_encode($imageData); // 编码为 Base64 字符串
} else {
// 图片不存在时的处理，例如记录日志或使用默认图片
\Log::warning("PDF generation: Image not found at " . $imagePath);
// 可以选择加载一个默认的 Base64 编码图片
// $defaultImagePath = public_path('default_image.png');
// if (File::exists($defaultImagePath)) {
// $base64Image = base64_encode(File::get($defaultImagePath));
// }
}
// --- 图片处理结束 ---
// 将 Base64 编码的图片字符串传递给视图
$pdf = PDF::loadView('front_end.invoice', compact('orderHistory', 'productDetails', 'marchantdetails', 'base64Image'))
->setOptions(['defaultFont' => 'sans-serif']);
// 下载 PDF 文件
return $pdf->download('pdf_file.pdf');
}
}
在 Blade 模板中，使用 data:image/[图片类型];base64, 格式的 src 属性来引用 Base64 编码的图片字符串。请确保 [图片类型] 与您实际的图片格式（如 png, jpeg, gif 等）相匹配。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>发票</title>
<style>
/* 可以在这里添加您的 CSS 样式 */
body { font-family: 'sans-serif'; }
.center-text { text-align: center; }
img { max-width: 100%; height: auto; } /* 确保图片不会溢出 */
</style>
</head>
<body>
<div class="center-text">
@if ($base64Image)
{{-- 确保 data:image/ 后面的类型与您的图片实际类型匹配 --}}
@@##@@
@else
<p>图片加载失败或不存在。</p>
@endif
</div>
<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>
<!-- 其他发票内容 -->
<p>订单历史: {{ $orderHistory->order_id }}</p>
<p>产品名称: {{ $productDetails['product_name'] ?? 'N/A' }}</p>
<p>商家名称: {{ $marchantdetails->name ?? 'N/A' }}</p>
</body>
</html>通过将图片 Base64 编码并直接嵌入到 HTML 中，我们提供了一种在 Laravel Dompdf 生成的 PDF 中可靠显示图片的方法。这种方法有效规避了 Dompdf 在处理本地文件路径时可能遇到的各种问题，确保了图片在生成的 PDF 中稳定且准确地呈现。开发者在实施时应注意图片文件大小对 PDF 性能和文件大小的影响，并做好相应的优化和错误处理。
以上就是在 Laravel Dompdf 生成的 PDF 中嵌入图片的高效方法的详细内容，更多请关注php中文网其它相关文章！
全网最新最细最实用WPS零基础入门到精通全套教程！带你真正掌握WPS办公！ 内含Excel基础操作、函数设计、数据透视表等
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
501
收藏
