PHP后端用PDFTK填充PDF表单特殊字符显示异常求助

核心问题分析 #

手动拼接FDF文件时未正确处理UTF-8编码的转义规则，同时PDF表单字段的字体可能未配置为支持€、ä、ü、ß、ö这类字符，导致PDFTK填充后显示异常。

方案1：修复手动生成FDF的编码与转义 #

FDF 1.2规范支持UTF-8，但需要对字段值中的特殊字符（如括号、反斜杠）进行转义，同时确保整个FDF文件以UTF-8编码保存。修改你的createFDF函数如下：

private function createFDF($certificate): string
{
    // 转义FDF字符串中的特殊字符：\ ( )
    $escapeFdfString = function($str) {
        return str_replace(['\\', '(', ')'], ['\\\\', '\\(', '\\)'], $str);
    };

    $fdf = "%FDF-1.2\n";
    $fdf .= "1 0 obj << /FDF << /Fields[\n";
    foreach ($certificate as $key => $value) {
        if (empty($value)) {
            continue;
        }
        // 转义字段名和值，确保UTF-8编码
        $escapedKey = $escapeFdfString($key);
        $escapedValue = $escapeFdfString($value);
        $fdf .= "<< /V ($escapedValue) /T ($escapedKey) >>\n";
    }
    $fdf .= "] >> >>\n";
    $fdf .= "endobj\n";
    $fdf .= "trailer\n";
    $fdf .= "<< /Root 1 0 R >>\n";
    $fdf .= "%%EOF\n";
    
    return $fdf;
}

额外配置：确保PDF表单字段字体支持特殊字符 #

用Adobe Acrobat Pro打开你的PDF模板：

• 编辑表单字段，选中每个字段
• 在「属性」→「外观」中，将字体设置为Arial Unicode MS或其他支持德语变音符号和欧元符号的字体
• 保存模板后再用PDFTK填充

方案2：使用PHP专业FDF生成库 #

手动拼接FDF容易出错，推荐使用成熟的库来生成标准FDF文件，比如setasign/fpdi-fdf：

1. 安装库：

composer require setasign/fpdi-fdf

2. 替换你的createFDF和createCertificate逻辑：

use setasign\FpdiFdf\FdfWriter;

private function createCertificate($certificate, $template): array
{
    $pathOutput = $this->basePathOutput.'certificate.pdf';
    $pathFdf = $this->basePathFdf.'certificate.fdf';

    // 生成标准FDF文件
    $fdfWriter = new FdfWriter();
    foreach ($certificate as $key => $value) {
        if (!empty($value)) {
            $fdfWriter->setField($key, $value);
        }
    }
    file_put_contents($pathFdf, $fdfWriter->saveToString());

    // 执行PDFTK命令
    $command = "pdftk $template fill_form $pathFdf output $pathOutput need_appearances flatten";
    exec($command, $output, $exitStatus);
    
    return [
        "exitstatus" => $exitStatus,
        "pathOutput" => $pathOutput,
    ];
}

这个库会自动处理编码和转义，避免手动拼接的错误。

方案3：替代PDFTK的工具 #

如果PDFTK的编码问题无法彻底解决，可以考虑使用qpdf作为替代工具，它对UTF-8的支持更完善：

1. 安装qpdf（服务器端）：

# Debian/Ubuntu
apt-get install qpdf

# CentOS/RHEL
yum install qpdf

2. 修改填充命令：

$command = "qpdf --fill-form $pathFdf --output $pathOutput $template";

方案4：直接生成PDF表单（无需模板） #

如果后续需要频繁修改样式，可以用TCPDF或mPDF直接生成带表单的PDF，完全控制字体和内容：

示例用TCPDF生成带字段的PDF：

require_once('tcpdf/tcpdf.php');

$pdf = new TCPDF(PDF_PAGE_ORIENTATION, PDF_UNIT, PDF_PAGE_FORMAT, true, 'UTF-8', false);
$pdf->AddPage();

// 设置支持特殊字符的字体
$pdf->SetFont('dejavusans', '', 12);

// 添加表单字段
$pdf->TextField('name', 50, 10, ['value' => 'Müller']);
$pdf->TextField('amount', 50, 10, ['value' => '100 €']);

// 保存PDF
$pdf->Output($pathOutput, 'F');

这种方式完全避免了模板转换和第三方工具的编码问题，样式修改也更灵活。

内容的提问来源于stack exchange，提问作者Akarik