本文详解在 Yii2 项目中通过 mPDF 生成 PDF 时，正确渲染韩国韩元符号（₩，Unicode U+20A9，HTML 实体 ₩）的方法，重点解决因字体缺失导致的方块或问号等乱码问题。
本文详解在 yii2 项目中通过 mpdf 生成 pdf 时，正确渲染韩国韩元符号（₩，unicode u+20a9，html 实体 `₩`）的方法，重点解决因字体缺失导致的方块或问号等乱码问题。
在 Yii2 中集成 mPDF 生成多语言 PDF 时，韩国韩元符号（₩）常无法正常显示，取而代之的是空白方块、豆腐块（）或系统默认 emoji 图标。根本原因在于：mPDF 默认字体（如 courier, helvetica）不包含 CJK（中日韩）扩展字符集，无法渲染 Unicode 码位 U+20A9（₩）。即使 HTML 实体 ₩ 语法正确，若底层字体不支持，仍会降级为占位符。
✅ 正确解决方案：强制指定支持 Unicode 的嵌入字体
mPDF 官方推荐并内置了开源字体 DejaVu Sans，它完整覆盖 Latin、Greek、Cyrillic 及大部分 CJK 符号（包括 ₩），且已预配置于 Yii2-mPDF 扩展中。你只需在 HTML 片段中显式声明该字体：
<span style="font-family: 'DejaVu Sans', sans-serif; font-size: 250%; margin-right: 10px;">
<?= html_entity_decode($currency_html_code, ENT_NOQUOTES, 'UTF-8'); ?>
</span>? 注意：$currency_html_code 应为原始 HTML 实体字符串 ₩（而非双重转义的 ₩）。若当前变量值是 ₩，需先用 html_entity_decode() 解码，否则浏览器/mPDF 会将其视为纯文本而非实体。
? 完整实践示例（Yii2 视图中）
<?php
// 确保传入的是未转义的实体（推荐做法）
$currency_html_code = '₩'; // 直接赋值，非 '₩'
// 或从数据库/配置读取后安全处理
// $currency_html_code = htmlspecialchars_decode($rawCode, ENT_QUOTES);
?>
<div class="amount">
<span style="font-family: 'DejaVu Sans', sans-serif; font-size: 28px; vertical-align: middle;">
<?= $currency_html_code ?>
</span>
<span style="font-family: 'DejaVu Sans', sans-serif; font-size: 36px; font-weight: bold; margin-left: 8px;">
<?= number_format($amount, 2) ?> KRW
</span>
</div>⚠️ 关键注意事项
- 禁止使用 ₩：这是对 & 的二次 HTML 转义，会导致 mPDF 解析失败。务必确保 $currency_html_code 是 ₩（一个字符串）。
- 字体必须显式声明：仅靠 CSS @font-face 或全局 default_font 配置不足以保证内联 生效，每个含特殊符号的元素都应携带 font-family: 'DejaVu Sans'。
- 避免混用字体族：不要写成 font-family: DejaVu Sans, Noto Sans CJK KR, sans-serif —— mPDF 对多字体 fallback 支持有限，优先指定单一可靠字体。
-
验证 PDF 输出编码：确保 mPDF 实例以 UTF-8 初始化：
$mpdf = new \Mpdf\Mpdf(['mode' => 'utf-8', 'format' => 'A4']);
✅ 验证与调试技巧
- 在 PDF 模板中临时插入测试字符：
= '₩ ₩ ₩' ?> —— 三者应显示一致。 - 若仍异常，检查 mPDF 字体路径是否可读（vendor/mpdf/mpdf/ttfonts/ 下应有 dejavusans.ttf）。
- 使用 --debug 模式运行生成逻辑，查看 mPDF 日志中是否有 Font file not found 提示。
通过以上配置，韩国韩元符号 ₩ 将稳定、清晰地呈现在 Yii2 生成的 PDF 报表、发票或合同中，无需额外安装系统字体或修改服务器环境。核心原则始终是：语义正确的 HTML 实体 + 显式声明的 Unicode 友好字体。
