萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 使用 TCPDF 生成加密 PDF 文件完整教學

前言

在 Web 開發中,動態生成 PDF 文件是常見需求,而當涉及機密資料時,加密保護就顯得尤為重要。本文將詳細介紹如何使用 PHP 強大的開源庫 TCPDF 來生成 PDF,並透過 SetProtection() 方法實現文件加密與密碼保護。

為什麼選擇 TCPDF?

TCPDF 是基於 PHP 的開源類庫,無需安裝額外擴展即可使用,支援完整的 PDF 1.7 規範,包含文字、圖形、條碼、二維碼、數位簽章等功能,且內建強大的加密機制。它已被廣泛應用於 Laravel、Symfony、CodeIgniter 等主流框架及眾多開源專案中。

核心方法:SetProtection() 詳解

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
)

參數說明

  • $permissions:允許的操作權限陣列,預設開放列印、修改、複製、註解、填表、提取、組裝、高解析度列印。
  • $user_pass:使用者密碼(開啟文件時需輸入),空字串表示無密碼。
  • $owner_pass:擁有者密碼(擁有完整權限),預設為 null 時自動生成隨機密碼。
  • $mode:加密模式,0 為標準加密(RC4 40-bit),1 為 AES 128-bit,2 為 AES 256-bit(建議使用 2)。
  • $pubkeys:公開金鑰陣列,用於憑證加密進階場景。

完整程式碼範例

<?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');
?>

權限控制最佳實踐

權限常數說明建議場景
print允許列印大多數文件預設開放
modify允許修改內容需協作編輯的文件
copy允許複製文字/圖片公開分享文件
annot-forms允許新增註解審核流程文件
fill-forms允許填寫表單欄位電子表單、申請單
extract允許提取文字/圖片資料分析需求
assemble允許組裝/插入/刪除頁面文件管理系統
print-high允許高解析度列印專業輸出需求

常見問題與解決方案

Q1:中文顯示亂碼怎麼辦?

TCPDF 內建支援 Unicode,需使用支援中文的字體(如 stsongstdlight、msungstdlight 或自訂 TTF 字體)。確保專案包含 tcpdf/fonts 目錄下的中文字體檔案。

Q2:忘記擁有者密碼如何移除加密?

若遺失擁有者密碼,無法透過程式移除加密(這正是加密的目的)。建議專案中妥善保存擁有者密碼,或使用密碼管理工具儲存。

Q3:加密後 PDF 體積變大?

加密會增加少量元資料,但影響極小。若檔案過大,可考慮啟用壓縮:$pdf->SetCompression(true);。

總結

透過 TCPDF 的 SetProtection() 方法,我們可以輕鬆實現 PDF 文件的多層級加密保護。結合 AES 256-bit 加密與細粒度權限控制,能有效滿足合規性、機密性等企業級需求。建議在正式環境中根據業務場景選擇適當的加密模式與權限組合,並妥善管理擁有者密碼。

copyright © 萬盛學電腦網 all rights reserved