使用PHP为Word文档添加编辑保护后文档变形的问题求助

你的问题核心在于PhpWord对复杂Word文档的解析和重写能力有限。docx本质是包含多个XML文件的压缩包，PhpWord加载现有文档时，无法完整识别所有高级格式（比如自定义背景、精准布局、特殊样式），保存时会重新生成文档结构，导致原有排版被破坏。修改保存版本无法解决，因为问题根源是PhpWord的文档处理逻辑，而非版本兼容性。

可行的无付费方案：直接修改docx的XML配置 #

绕过PhpWord的全文档重写，直接操作docx压缩包内的settings.xml文件添加密码保护，完全保留原文档格式。

具体实现代码

$sourceDocx = 'sample.docx';
$targetDocx = 'protected_sample.docx';
$password = '123456';

// 生成Word要求的密码哈希与盐值（符合Office Open XML标准）
function generateWordPasswordInfo($password) {
    $salt = random_bytes(16);
    $spinCount = 100000;
    // 使用PBKDF2-SHA1生成哈希，匹配Word的加密规则
    $hash = hash_pbkdf2('sha1', $password, $salt, $spinCount, 20, true);
    
    return [
        'salt' => base64_encode($salt),
        'hash' => base64_encode($hash),
        'spinCount' => $spinCount
    ];
}

$passwordData = generateWordPasswordInfo($password);

// 操作docx压缩包
$zip = new ZipArchive();
if ($zip->open($sourceDocx) === true) {
    // 读取并解析settings.xml
    $settingsXml = $zip->getFromName('word/settings.xml');
    $dom = new DOMDocument();
    $dom->loadXML($settingsXml);
    $xpath = new DOMXPath($dom);
    $xpath->registerNamespace('w', 'http://schemas.openxmlformats.org/wordprocessingml/2006/main');

    // 查找或创建文档保护节点
    $protectNode = $xpath->query('//w:documentProtection')->item(0);
    if (!$protectNode) {
        $settingsRoot = $xpath->query('//w:settings')->item(0);
        $protectNode = $dom->createElementNS('http://schemas.openxmlformats.org/wordprocessingml/2006/main', 'w:documentProtection');
        $settingsRoot->appendChild($protectNode);
    }

    // 设置保护属性
    $protectNode->setAttribute('w:edit', 'readOnly');
    $protectNode->setAttribute('w:enforcement', '1'); // 启用保护
    $protectNode->setAttribute('w:cryptProviderType', 'rsaFull');
    $protectNode->setAttribute('w:cryptAlgorithmClass', 'hash');
    $protectNode->setAttribute('w:cryptAlgorithmType', 'typeAny');
    $protectNode->setAttribute('w:cryptAlgorithmSid', '4'); // 对应SHA1算法
    $protectNode->setAttribute('w:cryptSpinCount', $passwordData['spinCount']);
    $protectNode->setAttribute('w:salt', $passwordData['salt']);
    $protectNode->setAttribute('w:hash', $passwordData['hash']);

    // 保存修改后的settings.xml到目标文档
    copy($sourceDocx, $targetDocx);
    if ($zip->open($targetDocx, ZIPARCHIVE::OVERWRITE) === true) {
        // 复制原文档所有文件，替换settings.xml
        for ($i = 0; $i < $zip->numFiles; $i++) {
            $filename = $zip->getNameIndex($i);
            if ($filename !== 'word/settings.xml') {
                $zip->addFromString($filename, $zip->getFromIndex($i));
            }
        }
        $zip->addFromString('word/settings.xml', $dom->saveXML());
        $zip->close();
        echo "加密文档已生成：{$targetDocx}";
    }
    $zip->close();
} else {
    echo "无法打开源文档";
}

其他排查建议 #

1. 升级PhpWord版本：旧版本对文档解析的bug较多，升级到最新稳定版可能修复部分格式兼容问题，但对复杂文档仍不保证完美支持。
2. 简化原文档格式：如果必须用PhpWord，先移除原文档中的复杂元素（比如浮动背景、特殊文本框、自定义样式），逐步排查是哪种格式导致的错乱。

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