在使用 Dompdf 生成 PDF 时，有时会遇到 PDF 文件为空，无法显示数据库数据的问题。这通常是由于 loadView()方法中视图路径配置不当或数据未正确传递到 Blade 模板所致。本文将深入探讨 Dompdf 的工作原理，提供详细的解决方案和代码示例，指导您正确加载视图并传递数据，从而生成包含动态内容的 PDF 文件。
理解 Dompdf 的工作原理
Dompdf 是一个 HTML 到 PDF 的转换库。它首先将您提供的 HTML 内容（通常是一个 Blade 视图）渲染成一个网页，然后将这个渲染结果转换成 PDF 格式。因此，生成动态 PDF 的关键在于：
- 准备数据： 从数据库或其他来源获取需要显示的数据。
- 创建 HTML 视图： 使用 Blade 模板引擎创建一个 HTML 文件，该文件将负责展示您的数据。
- 加载视图并传递数据： 使用 Dompdf 提供的 loadView()方法，指定正确的 Blade 视图路径，并将数据传递给该视图。
当 PDF 文件为空时，最常见的原因是 loadView()方法中的视图名称指定不正确，导致 Dompdf 无法找到或渲染预期的 HTML 模板。它期望的是一个 Blade 模板的相对路径（例如 ‘invoice.pdf’ 应该指向 resources/views/invoice/pdf.blade.php），而不是最终 PDF 文件的名称。
正确加载视图与传递数据
要解决 Dompdf 生成空 PDF 的问题，核心在于确保 PDF::loadView()方法能够正确地找到您的 Blade 模板，并且数据能够成功地传递到这个模板中。
1. 控制器中的数据准备与视图加载
首先，在您的控制器中，您需要从数据库中获取数据，然后使用 loadView()方法加载 Blade 模板，并将数据传递给它。
假设您有一个 Invoice 模型，并且希望在 PDF 中显示所有发票信息。
// app/Http/Controllers/InvoiceController.php namespace AppHttpControllers; use AppModelsInvoice; // 确保引入您的模型 use BarryvdhDomPDFFacadePdf; // 确保引入 Dompdf Facade use IlluminateHttpRequest; class InvoiceController extends Controller {/** * 生成并下载发票 PDF。* * @return IlluminateHttpResponse */ public function generateInvoicePdf() {// 1. 从数据库获取数据 $invoices = Invoice::all(); // 示例：获取所有发票 // 2. 加载 Blade 视图并传递数据 // 'invoice.pdf' 指向 resources/views/invoice/pdf.blade.php // compact('invoices') 将 $invoices 变量传递给视图 $pdf = Pdf::loadView('invoice.pdf', compact('invoices')); // 3. 返回 PDF 文件进行下载 return $pdf->download('invoices_list.pdf'); // 'invoices_list.pdf' 是下载时显示的文件名 } }关键点说明：
- Pdf::loadView(‘invoice.pdf’, compact(‘invoices’)):
- ‘invoice.pdf’：这是最重要的部分。它指定了您的 Blade 视图文件的路径，相对于 resources/views 目录。这意味着 Dompdf 会去寻找 resources/views/invoice/pdf.blade.php 文件。请注意，这里不应该包含。pdf 后缀，因为那不是一个 Blade 文件。
- compact(‘invoices’)：这是一个 PHP 函数，它会创建一个关联数组，其中键是变量名（’invoices’），值是变量的值（$invoices 数组）。这样，在 invoice/pdf.blade.php 视图中，您就可以直接使用 $invoices 变量来访问数据。
2. 创建 PDF 的 Blade 模板
接下来，您需要在 resources/views/invoice/ 目录下创建一个名为 pdf.blade.php 的文件。这个文件将包含 PDF 的 HTML 结构和动态数据。
{{-- resources/views/invoice/pdf.blade.php --}} <!DOCTYPE html> <html lang="zh-CN"> <head> <meta charset="UTF-8"> <title> 发票列表 </title> <style> /* PDF 的样式建议直接内联或放在 <style> 标签中，外部 CSS 可能加载失败 */ body {font-family: 'DejaVu Sans', sans-serif; /* 兼容中文的字体 */ margin: 20px;} h1 {color: #333; text-align: center;} table {width: 100%; border-collapse: collapse; margin-top: 20px;} th, td {border: 1px solid #ddd; padding: 8px; text-align: left;} th {background-color: #f2f2f2;} </style> </head> <body> <h1> 所有发票 </h1> @if($invoices->isEmpty()) <p> 目前没有发票数据。</p> @else <table> <thead> <tr> <th> 发票 ID</th> <th> 客户名称 </th> <th> 总金额 </th> <th> 创建日期 </th> </tr> </thead> <tbody> @foreach($invoices as $invoice) <tr> <td>{{$invoice->id}}</td> <td>{{$invoice->customer_name}}</td> <td>{{number_format($invoice->amount, 2) }}</td> <td>{{$invoice->created_at->format('Y-m-d') }}</td> </tr> @endforeach </tbody> </table> @endif </body> </html>Blade 模板说明：
- @foreach($invoices as $invoice)：这里我们遍历从控制器传递过来的 $invoices 集合，并显示每张发票的详细信息。
- font-family: ‘DejaVu Sans’, sans-serif;：Dompdf 对字体支持有限，特别是中文字体。为了确保中文显示正常，通常需要配置 Dompdf 使用支持中文的字体，如 DejaVu Sans（Dompdf 通常内置）或自定义字体。如果仍有问题，可能需要更复杂的字体配置。
- CSS 样式： 强烈建议将 CSS 样式直接嵌入到
完整实现步骤总结
-
安装 Dompdf 包： 如果您尚未安装，请通过 Composer 安装 Laravel Dompdf 包：
composer require barryvdh/laravel-dompdf对于 Laravel 5.5+，服务提供者和 Facad e 会自动注册。如果遇到问题，可以手动在 config/app.php 中添加：
// config/app.php 'providers' => [// …… BarryvdhDomPDFServiceProvider::class,], 'aliases' => [// …… 'Pdf' => BarryvdhDomPDFFacadePdf::class,], -
创建控制器： 如上所示，创建或修改您的控制器（例如 InvoiceController.php），负责获取数据并调用 Dompdf。
-
创建 Blade 视图： 在 resources/views 目录下创建相应的 Blade 模板文件（例如 resources/views/invoice/pdf.blade.php），用于定义 PDF 的 HTML 内容和展示数据。
-
定义路由： 在 routes/web.php 中定义一个路由，指向您的控制器方法：
// routes/web.php use AppHttpControllersInvoiceController; Route::get('/invoices/pdf', [InvoiceController::class, 'generateInvoicePdf'])->name('invoices.pdf');现在，当您访问 /invoices/pdf 这个 URL 时，浏览器 应该会提示下载一个包含发票数据的 PDF 文件。
常见问题与注意事项
- 视图文件不存在： 确保 loadView()中指定的视图路径与实际文件路径（例如 resources/views/invoice/pdf.blade.php）完全匹配。
- 数据未传递或访问错误： 检查 compact()函数是否正确使用了变量名，并在 Blade 模板中使用 {{ $variableName}} 或 @foreach 等方式正确访问传递的数据。可以使用 dd($invoices)在控制器中打印数据，或在 Blade 模板中临时添加 {{dd($invoices) }} 来检查数据是否到达视图。
- 中文乱码： Dompdf 默认字体可能不支持中文。您可以在 config/dompdf.php 中配置字体，或在 Blade 模板中使用支持中文的字体（如上述示例中的 DejaVu Sans），并确保您的 HTML 文件 编码 为 UTF-8。有时需要安装 dompdf/dompdf 包的 php-font-lib 和 php-svg-lib 依赖。
- 图片和外部资源： Dompdf 在处理图片和外部 CSS/JS 时可能存在限制。建议将图片转换为 Base64 编码嵌入 HTML，或确保图片路径是绝对的且 Dompdf 可以访问。CSS 最好内联或嵌入
- 调试： 如果 PDF 仍然为空或不符合预期，可以尝试使用 $pdf->stream(‘filename.pdf’)代替 $pdf->download()。stream()方法会在浏览器中直接显示 PDF，这有助于快速查看结果。如果 PDF 依然是空白，可以尝试在控制器中打印 Dompdf 将要渲染的 HTML 内容，例如：
$html = view('invoice.pdf', compact('invoices'))->render(); dd($html); // 查看渲染后的 HTML 内容这可以帮助您确定问题是出在数据传递、Blade 模板渲染，还是 Dompdf 的 PDF 转换过程。
通过遵循上述步骤和注意事项，您应该能够成功地使用 Dompdf 从数据库中获取数据并生成包含动态内容的 PDF 文件。关键在于理解 Dompdf 如何将 HTML 视图转换为 PDF，并确保视图路径和数据传递的准确性。
以上就是 Dompdf 生成动态 PDF：确保视图与数据正确加载的详细内容，更多请关注 php 中文网其它相关文章！
