Laravel DomPDF自定义字体显示方框

基础概念

Laravel DomPDF 是一个用于生成 PDF 文件的 Laravel 扩展包，它基于 PHP 的 DomPDF 库。DomPDF 可以将 HTML 和 CSS 转换为 PDF 文件。自定义字体在 PDF 中显示方框通常是由于字体未正确加载或配置导致的。

类型

内置字体：DomPDF 内置了一些常见的字体，如 Arial、Times New Roman 等。
自定义字体：用户可以加载和使用自定义字体。

应用场景

报告生成：生成各种报告和文档。
发票和收据：生成电子发票和收据。
电子书：生成电子书和其他阅读材料。

问题原因及解决方法

问题原因

自定义字体显示方框通常是由于以下原因之一：

字体文件未正确加载：字体文件路径不正确或文件损坏。
字体未注册：字体未在 DomPDF 中正确注册。
CSS 配置错误：CSS 中的字体配置不正确。

解决方法

确保字体文件路径正确：确保字体文件路径正确且文件存在。例如，如果字体文件位于 storage/fonts 目录下，可以使用以下代码加载字体：
确保字体文件路径正确：确保字体文件路径正确且文件存在。例如，如果字体文件位于 storage/fonts 目录下，可以使用以下代码加载字体：
确保字体已注册：确保在 DomPDF 中正确注册字体。例如：
确保字体已注册：确保在 DomPDF 中正确注册字体。例如：
检查 CSS 配置：确保 CSS 中的字体配置正确。例如：
检查 CSS 配置：确保 CSS 中的字体配置正确。例如：

示例代码

以下是一个完整的示例，展示了如何在 Laravel 中使用 DomPDF 加载自定义字体并生成 PDF：

use Dompdf\Dompdf;
use Dompdf\Options;

// 设置选项
$options = new Options();
$options->setCssOption('fontDir', storage_path('fonts/'));
$options->setCssOption('fontCache', storage_path('cache/'));

// 创建 DomPDF 实例
$dompdf = new Dompdf($options);

// 加载自定义字体
$dompdf->addFont(storage_path('fonts/your-font-file.ttf'), 'YourFontName', 'truetype');

// 加载 HTML
$html = '<html><body><p style="font-family: YourFontName;">Hello World</p></body></html>';
$dompdf->loadHtml($html);

// 渲染 PDF
$dompdf->render();

// 输出 PDF
return $dompdf->stream('document.pdf');