本文旨在解决在使用TCPDF库添加自定义字体时出现乱码的问题。通过排查字体文件本身的问题，并提供了一种有效的解决方案，即更换字体来源并清理旧字体缓存，确保自定义字体在TCPDF中正确显示。本文还提供了添加和使用自定义字体的代码示例，帮助开发者快速解决类似问题。
在使用TCPDF生成PDF文档时，自定义字体能够显著提升文档的美观性和专业性。然而，有时在添加自定义字体后，PDF文档中却出现乱码，影响了用户体验。 这个问题通常与字体文件本身或TCPDF的字体处理机制有关。
问题分析
当TCPDF使用addTTFfont()函数添加自定义字体时，如果字体文件存在问题（例如，字体文件损坏、编码不正确等），或者TCPDF无法正确解析字体文件，就会导致生成的PDF文档中出现乱码。
解决方案
-
更换字体来源
字体文件本身的问题是导致乱码最常见的原因之一。不同的字体来源提供的字体文件质量可能存在差异。如果从一个来源下载的字体文件导致乱码，可以尝试从其他可靠的来源下载相同的字体文件。
例如，如果从google Fonts Helper下载的字体文件出现问题，可以尝试从Fontmirror等其他网站下载。
-
清理旧字体缓存
TCPDF会将已添加的字体信息缓存在vendor/tecnickcom/tcpdf/fonts目录下。如果之前添加的字体文件存在问题，即使更换了新的字体文件，TCPDF仍然可能使用旧的缓存数据，导致乱码问题仍然存在。
因此，在更换字体文件后，需要手动删除vendor/tecnickcom/tcpdf/fonts目录下与该字体相关的文件，以清除旧的字体缓存。
代码示例
以下代码示例演示了如何添加和使用自定义字体：
添加字体（仅需执行一次）
<?php require_once('tcpdf_include.php'); // 引入TCPDF相关文件 $fontnames = []; $fontnames[] = TCPDF_FONTS::addTTFfont('fonts/Quicksand Bold.ttf'); $fontnames[] = TCPDF_FONTS::addTTFfont('fonts/Quicksand Regular.ttf'); // 确保使用真实的字体名称。不同的文件名可能会（也可能不会）产生不同的字体名称。 die(print_r($fontnames, 1)); ?>
生成PDF文档
<?php require_once('tcpdf_include.php'); // 引入TCPDF相关文件 // 创建新的PDF文档 $pdf = new TCPDF('P', 'mm', 'A4'); // 设置字体 $pdf->SetFont('quicksand'); // 使用上面添加的字体名称 // 添加页面 $pdf->AddPage(); // 文本内容 $txt = '0123456789 ABCDEFGHIJKLMNOPQRSTUVQXYZ'; // 写入文本 $pdf->Write(0, $txt, '', 0, 'C', true, 0, false, false, 0); // 输出PDF文档 $pdf->Output('test.pdf', 'I'); exit(1); ?>
注意事项
- 确保fonts目录存在，并且包含正确的字体文件。
- addTTFfont()函数只需要执行一次，用于将字体添加到TCPDF的字体库中。
- 使用SetFont()函数时，需要使用addTTFfont()函数返回的字体名称，而不是字体文件名。
- 在生产环境中，应避免使用die(print_r($fontnames, 1))语句，因为它会中断程序的执行。
总结
通过更换字体来源和清理旧字体缓存，可以有效解决TCPDF自定义字体显示乱码的问题。在添加自定义字体时，务必确保字体文件质量可靠，并注意清理旧的字体缓存，以确保TCPDF能够正确解析和使用自定义字体。 此外，仔细检查代码中的字体名称是否正确，也是解决问题的关键步骤。