本教程详细介绍了在 laravel 框架中如何将图片转换为 pdf 文档。我们将重点利用 `barryvdh/laravel-dompdf` 包，通过将图片嵌入 blade 模板，然后使用 dompdf 生成并下载 pdf。内容涵盖了 dompdf 的安装、配置、图片引用方式以及核心的 pdf 生成逻辑，旨在提供一个清晰、专业的实践指南，帮助开发者高效地实现图片到 pdf 的转换。
在现代 Web 应用开发中，将动态生成或上传的图片转换为 PDF 格式是一种常见的需求，例如生成带有图片的企业证书、报告或发票等。对于 Laravel 开发者而言，实现这一功能有多种途径，其中最常用且推荐的方式是利用强大的 HTML 到 PDF 转换库——DomPDF。本文将详细指导您如何在 Laravel 项目中集成并使用 DomPDF 来高效地完成图片到 PDF 的转换。
DomPDF 是一个基于 PHP 的库，能够将 HTML 和 CSS 渲染成 PDF。barryvdh/laravel-dompdf 是 DomPDF 在 Laravel 框架下的一个封装，提供了更便捷的集成方式和友好的 API。
首先，通过 Composer 将 barryvdh/laravel-dompdf 包安装到您的 Laravel 项目中：
composer require barryvdh/laravel-dompdf
对于 Laravel 5.5 及更高版本，包的 Service Provider 和 Facade 会自动发现。如果您的 Laravel 版本较低，或者自动发现未能生效，您需要在 config/app.php 文件中手动添加 Service Provider 和 Facade：
// config/app.php
'providers' => [
// ...
Barryvdh\DomPDF\ServiceProvider::class,
],
'aliases' => [
// ...
'PDF' => Barryvdh\DomPDF\Facade::class,
],在将图片嵌入 PDF 之前，您需要确保图片是可访问的。图片可以是预先存在的静态文件，也可以是动态生成的（例如使用 PHP 的 GD 库，如 imagettftext() 函数生成）。
如果您使用 GD 库生成图片，通常会将其保存到服务器的某个可访问路径下，或者直接输出图片流。为了在 DomPDF 中使用，我们建议将图片保存为文件，然后通过文件路径引用。
示例： 假设您有一个通过 GD 库生成的图片，并已保存到 public/images/certificate.jpg。
// 示例：动态生成图片并保存（这部分代码通常在图片生成逻辑中）
// 假设 $image 是通过 imagecreate() 等函数创建的图像资源
// imagettftext($image, $font_size, $angle, $x_axis, $y_axis, $temp, $color, $font, $description);
// imagejpeg($image, public_path('images/certificate.jpg')); // 保存图片
// imagedestroy($image);DomPDF 的核心工作方式是将 HTML 渲染为 PDF。因此，我们需要创建一个 Blade 视图文件，其中包含 <img> 标签来引用您的图片。
在 resources/views 目录下创建一个新的 Blade 文件，例如 myPDF.blade.php：
<!DOCTYPE html>
<html>
<head>
<title>图片转PDF示例</title>
<style>
body {
font-family: 'DejaVu Sans', sans-serif; /* 确保支持中文 */
}
.container {
text-align: center;
margin-top: 50px;
}
img {
max-width: 100%;
height: auto;
border: 1px solid #ccc;
padding: 5px;
}
h1 {
color: #333;
}
</style>
</head>
<body>
<div class="container">
<h1>{{ $title }}</h1>
{{-- 引用本地图片 --}}
<img src="{{ public_path('images/certificate.jpg') }}" alt="生成的证书">
{{-- 如果图片在 storage 目录且已链接到 public --}}
{{-- <img src="{{ asset('storage/certificates/my_certificate.jpg') }}" alt="生成的证书"> --}}
{{-- 或者通过 base64 编码嵌入图片（适合小图片） --}}
{{-- <img src="data:image/jpeg;base64,{{ base64_encode(file_get_contents(public_path('images/certificate.jpg'))) }}" alt="生成的证书"> --}}
</div>
</body>
</html>重要提示：
现在，我们将在控制器中编写逻辑来加载 Blade 视图，并使用 DomPDF 生成并下载 PDF 文件。
在您的控制器中（例如 App\Http\Controllers\PdfController.php），添加一个方法：
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use PDF; // 确保已导入 DomPDF Facade
class PdfController extends Controller
{
/**
* 生成并下载包含图片的 PDF。
*
* @return \Illuminate\Http\Response
*/
public function generateImagePdf()
{
// 准备传递给 Blade 视图的数据
$data = [
'title' => 'Laravel 图片转 PDF 示例',
// 您可以根据需要传递其他数据
];
// 加载 Blade 视图并生成 PDF
$pdf = PDF::loadView('myPDF', $data);
// 返回 PDF 文件供下载
// 'image_document.pdf' 是下载的文件名
return $pdf->download('image_document.pdf');
// 如果您想在浏览器中直接预览而不是下载，可以使用 stream() 方法
// return $pdf->stream('image_document.pdf');
}
}最后，为您的 PDF 生成方法定义一个路由，以便通过 URL 访问：
// routes/web.php
use App\Http\Controllers\PdfController;
Route::get('/generate-image-pdf', [PdfController::class, 'generateImagePdf'])->name('generate.image.pdf');现在，当您访问 http://your-app-url/generate-image-pdf 时，浏览器将下载一个名为 image_document.pdf 的文件，其中包含您在 Blade 模板中引用的图片。
通过 barryvdh/laravel-dompdf 包，在 Laravel 中将图片转换为 PDF 变得非常简单和高效。核心思路是将图片作为 HTML 元素嵌入到 Blade 模板中，然后利用 DomPDF 将该 HTML 渲染为 PDF。遵循本文提供的步骤和最佳实践，您将能够轻松地在您的 Laravel 应用中实现强大的 PDF 生成功能。
以上就是在 Laravel 中利用 DomPDF 将图片转换为 PDF 的完整指南的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
广告Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
416
收藏
