MPDF文档元数据设置指南：打造专业PDF文件属性

2025-06-03 18:15:17作者：俞予舒Fleming

什么是PDF文档元数据

PDF文档元数据是指嵌入在PDF文件中的描述性信息，这些信息不会直接显示在文档内容中，但可以通过PDF阅读器的"文档属性"查看。常见的元数据包括：

标题(Title)：通常显示在PDF阅读器的窗口标题栏
作者(Author)：文档的创建者或作者
主题(Subject)：文档的主要内容概述
关键词(Keywords)：描述文档内容的关键词
创建者(Creator)：生成PDF文件的应用程序

为什么需要设置文档元数据

专业形象：完整的元数据使文档看起来更专业
可搜索性：搜索引擎和文档管理系统可以利用元数据进行索引
组织管理：便于文档的分类和归档
版权信息：明确文档的作者和版权信息

MPDF中设置元数据的方法

MPDF提供了多种方式来设置PDF文档的元数据：

1. 使用专用方法设置

MPDF提供了一系列方法来直接设置元数据：

$mpdf = new \Mpdf\Mpdf();

// 设置文档标题
$mpdf->SetTitle("MPDF文档元数据设置指南");

// 设置文档作者
$mpdf->SetAuthor("技术文档团队");

// 设置文档创建者
$mpdf->SetCreator("MPDF生成器");

// 设置文档主题
$mpdf->SetSubject("PDF元数据设置技术指南");

// 设置文档关键词
$mpdf->SetKeywords("MPDF, PDF, 元数据, PHP");

2. 通过HTML自动设置

当使用WriteHTML()方法写入完整的HTML代码时，MPDF会自动从HTML中提取元数据：

从<title>标签获取文档标题
从<meta>标签获取作者、主题和关键词

$html = '
<!DOCTYPE html>
<html>
<head>
    <title>自动设置的文档标题</title>
    <meta name="author" content="HTML作者">
    <meta name="keywords" content="HTML, 自动, 关键词">
    <meta name="subject" content="HTML元数据测试">
</head>
<body>
    <p>文档内容...</p>
</body>
</html>';

$mpdf->WriteHTML($html);

注意：如果同时使用两种方法设置元数据，后设置的值会覆盖先前的设置。

处理特殊字符和编码

MPDF要求元数据文本使用UTF-8编码，但不支持HTML标签。如果需要在元数据中使用特殊字符，可以使用strcode2utf()函数将HTML实体转换为UTF-8字符串：

$mpdf = new \Mpdf\Mpdf();

// 将HTML实体转换为UTF-8字符串
$arabicTitle = strcode2utf("&#1575;&#1610;&#1604;&#1575;&#1578; &#1601;&#1610;&#1605;&#1575;");

$mpdf->SetTitle($arabicTitle);
$mpdf->WriteHTML('文档内容...');
$mpdf->Output();