Yii2 mPDF显示韩元符号方法

本文深入解析了在 Yii2 项目中使用 mPDF 生成 PDF 时韩元符号（₩）显示为方块或问号的根本原因与实战解决方案——关键在于同步解决字体缺失（强制启用支持 Unicode 的 DejaVu Sans 字体）、HTML 实体双重转义（避免使用 ₩，改用原始 ₩ 或 html_entity_decode 安全解码）及编码配置三重问题，不仅彻底修复韩元渲染异常，更可无缝扩展至日元、人民币、印度卢比等各类 Unicode 货币符号，让财务报表、发票等本地化 PDF 文档真正“所见即所得”。

本文详解在 Yii2 项目中使用 mPDF 生成 PDF 时，解决韩元符号（₩，Unicode U+20A9，HTML 实体 ₩）显示为方块或问号图标的问题，核心在于字体配置与 HTML 实体转义的协同处理。

本文详解在 Yii2 项目中使用 mPDF 生成 PDF 时，解决韩元符号（₩，Unicode U+20A9，HTML 实体 `₩`）显示为方块或问号图标的问题，核心在于字体配置与 HTML 实体转义的协同处理。

在 Yii2 中集成 mPDF 生成财务报表、发票等含本地化货币符号的 PDF 文档时，韩元（₩）和印度卢比（₹）等非 ASCII 货币符号常因字体缺失或编码不兼容而渲染失败——典型表现为小方块（）、空白或系统默认 emoji 图标。根本原因在于：mPDF 默认使用的字体（如 courier, helvetica）不包含 CJK 或扩展货币符号字形，且 HTML 实体 ₩ 在双重转义后（& → &）未被正确解析。

✅ 正确解决方案：字体 + 实体 + 编码三重保障

1. 强制指定支持 Unicode 的字体
   mPDF 内置的 DejaVu Sans 字体完整覆盖 Unicode 基本多文种平面（BMP），包含 ₩（U+20A9）。必须通过 font-family 显式声明，并确保该字体已启用（Yii2-mPDF 扩展通常默认预加载）：

   <span style="font-family: 'DejaVu Sans', sans-serif; font-size: 250%; margin-right: 10px;">
       <?= html_entity_decode($currency_html_code, ENT_QUOTES, 'UTF-8') ?>
   </span>

2. 修复 HTML 实体转义问题
   你当前的 $currency_html_code = "&#8361" 是双重转义结果（& 被转义为 &），导致浏览器/mPDF 解析为字面字符串 ₩ 而非符号。应直接使用原始实体 ₩，或用 html_entity_decode() 安全解码：

   // ✅ 推荐：PHP 层直接定义原始实体
   $currency_html_code = '₩'; // 注意：此处是 & + #8361;，不是 &
   
   // ✅ 或动态解码（若来源不可控）
   $currency_html_code = html_entity_decode($currency_html_code, ENT_QUOTES, 'UTF-8');

3. 全局字体配置（推荐进阶实践）
   在 mPDF 初始化配置中统一设置默认字体，避免逐处写 font-family：

   // config/mpdf.php 或生成 PDF 的控制器中
   'pdf' => [
       'class' => '\kartik\mpdf\Pdf',
       'format' => 'A4',
       'options' => [
           'default_font' => 'dejavusans', // 关键：设为 dejavusans（小写）
       ],
       'methods' => [
           'SetHeader' => ['Generated on: ' . date("r")],
           'SetFooter' => ['{PAGENO}'],
       ]
   ]

⚠️ 注意事项

• 不要使用 ₩：这是 HTML 源码中的转义写法，仅适用于静态 HTML 页面；在 PHP 输出到 mPDF 时，需确保最终传入的是 ₩ 或 ₩ 字符本身。
• 验证字体加载：若仍显示异常，检查 mPDF 日志是否报 Font not found: dejavusans。可通过 vendor/kartik-v/yii2-mpdf/src/Pdf.php 确认 DejaVuSans 字体文件路径是否正确（通常位于 vendor/kartik-v/yii2-mpdf/src/fonts/）。
• KRW 文本建议组合使用：货币符号常与数字连用，推荐语义化结构：

  <span style="font-family: 'DejaVu Sans', sans-serif;">
      <?= '&#8361;' . number_format($amount, 0, ',', '.') ?> <!-- 如 ₩35,000 -->
  </span>

通过以上配置，韩元符号将稳定渲染为标准 ₩，而非占位图标。此方案同样适用于日元（¥）、人民币（¥）及印度卢比（₹）等 Unicode 货币符号，本质是确保 mPDF 渲染链路（PHP 字符串 → HTML 实体 → Unicode 字形 → DejaVu 字体映射）全程无损。

到这里，我们也就讲完了《Yii2 mPDF显示韩元符号方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！