在 Web 開發中,動態生成 PDF 文件是常見需求,而當涉及機密資料時,加密保護就顯得尤為重要。本文將詳細介紹如何使用 PHP 強大的開源庫 TCPDF 來生成 PDF,並透過 SetProtection() 方法實現文件加密與密碼保護。
TCPDF 是基於 PHP 的開源類庫,無需安裝額外擴展即可使用,支援完整的 PDF 1.7 規範,包含文字、圖形、條碼、二維碼、數位簽章等功能,且內建強大的加密機制。它已被廣泛應用於 Laravel、Symfony、CodeIgniter 等主流框架及眾多開源專案中。
TCPDF 提供的 SetProtection() 方法原型如下:
TCPDF::SetProtection(
$permissions = array('print', 'modify', 'copy', 'annot-forms', 'fill-forms', 'extract', 'assemble', 'print-high'),
$user_pass = '',
$owner_pass = null,
$mode = 0,
$pubkeys = null
)
<?php
require_once('tcpdf/tcpdf.php');
// 建立 PDF 物件
$pdf = new TCPDF(PDF_PAGE_ORIENTATION, PDF_UNIT, PDF_PAGE_FORMAT, true, 'UTF-8', false);
// 設定文件資訊
$pdf->SetCreator('My Application');
$pdf->SetAuthor('Developer Name');
$pdf->SetTitle('機密報表');
$pdf->SetSubject('加密 PDF 範例');
// 關鍵:設定加密保護
// 使用 AES 256-bit 加密,設定使用者密碼為 "user123",擁有者密碼為 "owner456"
// 僅允許列印與填寫表單,禁止修改、複製、提取內容
$pdf->SetProtection(
array('print', 'fill-forms'), // 僅允許的權限
'user123', // 使用者開啟密碼
'owner456', // 擁有者完全控制密碼
2 // AES 256-bit 加密
);
// 新增頁面並寫入內容
$pdf->AddPage();
$pdf->SetFont('stsongstdlight', '', 16);
$pdf->Write(0, '這是一份加密的 PDF 文件', '', 0, 'C', true, 0, false, false, 0);
$pdf->Ln(10);
$pdf->SetFont('stsongstdlight', '', 12);
$pdf->Write(0, '開啟此文件需要輸入使用者密碼:user123', '', 0, 'L', true, 0, false, false, 0);
// 輸出 PDF
$pdf->Output('encrypted_document.pdf', 'D');
?>
| 權限常數 | 說明 | 建議場景 |
|---|---|---|
| 允許列印 | 大多數文件預設開放 | |
| modify | 允許修改內容 | 需協作編輯的文件 |
| copy | 允許複製文字/圖片 | 公開分享文件 |
| annot-forms | 允許新增註解 | 審核流程文件 |
| fill-forms | 允許填寫表單欄位 | 電子表單、申請單 |
| extract | 允許提取文字/圖片 | 資料分析需求 |
| assemble | 允許組裝/插入/刪除頁面 | 文件管理系統 |
| print-high | 允許高解析度列印 | 專業輸出需求 |
TCPDF 內建支援 Unicode,需使用支援中文的字體(如 stsongstdlight、msungstdlight 或自訂 TTF 字體)。確保專案包含 tcpdf/fonts 目錄下的中文字體檔案。
若遺失擁有者密碼,無法透過程式移除加密(這正是加密的目的)。建議專案中妥善保存擁有者密碼,或使用密碼管理工具儲存。
加密會增加少量元資料,但影響極小。若檔案過大,可考慮啟用壓縮:$pdf->SetCompression(true);。
透過 TCPDF 的 SetProtection() 方法,我們可以輕鬆實現 PDF 文件的多層級加密保護。結合 AES 256-bit 加密與細粒度權限控制,能有效滿足合規性、機密性等企業級需求。建議在正式環境中根據業務場景選擇適當的加密模式與權限組合,並妥善管理擁有者密碼。