Laravel怎么生成PDF文档_Laravel使用dompdf扩展包HTML转PDF【教程】

Dompdf在Laravel中核心限制是不支持flex/grid、JavaScript、外部字体加载失败率高，且易内存溢出；须用barryvdh/laravel-dompdf封装包，中文字体需手动嵌入并配置，HTML须语义化、避免复杂表格与CSS陷阱。

Dompdf 在 Laravel 中生成 PDF 的核心限制是：它不支持现代 CSS 布局（如 flex、grid）、JavaScript、外部字体加载失败率高，且对大表格或长页面容易内存溢出。直接套用浏览器渲染逻辑会失败。

安装 dompdf 及适配 Laravel 的封装包

别直接装原生 dompdf/dompdf，它和 Laravel 不兼容。必须用社区维护的 Laravel 封装版：

• 推荐安装 barryvdh/laravel-dompdf（Laravel 9–10 兼容至 v2.0+）
• 执行 composer require barryvdh/laravel-dompdf
• Laravel 10+ 无需手动注册服务提供者，但需确认 config/app.php 中未禁用自动发现
• 如需自定义配置（比如中文字体），发布配置：php artisan vendor:publish --provider="Barryvdh\DomPDF\ServiceProvider"

生成 PDF 时中文乱码/字体缺失的修复方法

Dompdf 默认不支持中文字体，simhei.ttf 或 msyh.ttc 直接引用会报错 Font not found。必须手动嵌入并注册：

DreamStudio

SD兄弟产品！AI 图像生成器

下载

• 把中文字体文件（如 simhei.ttf）放到 resources/fonts/ 目录下
• 编辑 config/dompdf.php，在 'font' => [] 中添加：

  "simhei" => base_path('resources/fonts/simhei.ttf')

• 在 Blade 模板中用 @font-face 声明（注意路径必须为绝对 URL 或 base64）：

  @font-face {
    font-family: 'SimHei';
    src: url('{{ public_path('fonts/simhei.ttf') }}') format('truetype');
  }
  body { font-family: 'SimHei', sans-serif; }

• 调用时显式设置字体：$pdf->setOption('defaultFont', 'simhei');

用 view() 渲染 HTML 再转 PDF 的典型流程

不要在控制器里拼接 HTML 字符串，必须走 Laravel 视图系统，否则 CSS 和路径解析全乱：

立即学习“前端免费学习笔记（深入）”；

• 新建视图 resources/views/pdf/invoice.blade.php，写纯语义化 HTML（避免 position: fixed、transform）
• 控制器中用 PDF::loadView() 加载视图：

  use Barryvdh\DomPDF\Facade as PDF;
  
  public function exportPdf()
  {
      $data = ['order' => Order::find(1)];
      $pdf = PDF::loadView('pdf.invoice', $data)
          ->setOption('isRemoteEnabled', true) // 允许加载远程图片
          ->setPaper('a4', 'portrait');
      return $pdf->stream('invoice.pdf');
  }

• setOption('isRemoteEnabled', true) 是关键，否则 table { page-break-inside: avoid; } tr { page-break-inside: avoid; page-break-after: auto; }
%0A
• %E9%81%BF%E5%85%8D%E7%94%A8%20colspan/rowspan%20%E8%BF%87%E5%A4%9A%E7%9A%84%E5%A4%8D%E6%9D%82%E8%A1%A8%EF%BC%8C%E6%8B%86%E6%88%90%E5%A4%9A%E4%B8%AA%E5%B0%8F%E8%A1%A8%E6%9B%B4%E7%A8%B3
%0A
• %E5%86%85%E5%AD%98%E4%B8%8D%E8%B6%B3%E6%8A%A5%E9%94%99%20Allowed%20memory%20size%20exhausted%20%E6%97%B6%EF%BC%8C%E5%9C%A8%E7%94%9F%E6%88%90%E5%89%8D%E4%B8%B4%E6%97%B6%E6%89%A9%E5%A4%A7%E9%99%90%E5%88%B6%EF%BC%9A

  ini_set('memory_limit', '512M');

%0A
• %E8%B6%85%E9%95%BF%E5%86%85%E5%AE%B9%E5%BB%BA%E8%AE%AE%E5%85%88%E7%94%A8%20chunk()%20%E5%88%86%E6%89%B9%E5%AF%BC%E5%87%BA%EF%BC%8C%E8%80%8C%E4%B8%8D%E6%98%AF%E5%8D%95%E6%AC%A1%E6%B8%B2%E6%9F%93%E4%B8%87%E8%A1%8C%E6%95%B0%E6%8D%AE
%0A