PHP为Docx添加自定义属性后Word不显示，求问题原因

你的代码已经正确生成了docProps/custom.xml，但Word看不到属性，大概率是OXML部件未注册或者PID处理不当，下面是具体修复方案：

1. 必须在[Content_Types].xml中声明自定义属性文件 #

Docx是严格的OXML格式，所有新增的部件都得在根目录的[Content_Types].xml里注册内容类型，否则Word会直接忽略这个文件。

给代码加一段处理这个文件的逻辑：

// 读取并更新内容类型配置
$contentTypes = $zip->getFromName('[Content_Types].xml');
if (strpos($contentTypes, '/docProps/custom.xml') === false) {
    // 在Types标签末尾添加自定义属性的声明
    $contentTypes = str_replace('</Types>', '  <Override PartName="/docProps/custom.xml" ContentType="application/vnd.openxmlformats-officedocument.custom-properties+xml"/>' . PHP_EOL . '</Types>', $contentTypes);
    $zip->addFromString('[Content_Types].xml', $contentTypes);
}

2. 确保PID的唯一性 #

你固定从2开始分配PID，但如果原模板本身已经有自定义属性，新PID会冲突。最好先读取原文件的最大PID再递增：

$id_num = 2;
// 检查原文件是否已有custom.xml，获取现有PID最大值
$existingCustomXml = $zip->getFromName('docProps/custom.xml');
if ($existingCustomXml) {
    preg_match_all('/pid="(\d+)"/', $existingCustomXml, $matches);
    if (!empty($matches[1])) {
        $id_num = max($matches[1]) + 1;
    }
}

3. 修正ZipArchive的打开模式 #

默认打开模式可能存在写入权限问题，改用RDWR模式确保读写权限：

if ($zip->open($blank_DOCX_template, \ZipArchive::RDWR) == true) {
    // 后续逻辑
}

完整修复后的代码 #

$blank_DOCX_template = DATAPATH . "formletter_blank_templates/blank.docx";
        
$zip = new \ZipArchive;

if ($zip->open($blank_DOCX_template, \ZipArchive::RDWR) == true) {
    // 处理内容类型注册
    $contentTypes = $zip->getFromName('[Content_Types].xml');
    if (strpos($contentTypes, '/docProps/custom.xml') === false) {
        $contentTypes = str_replace('</Types>', '  <Override PartName="/docProps/custom.xml" ContentType="application/vnd.openxmlformats-officedocument.custom-properties+xml"/>' . PHP_EOL . '</Types>', $contentTypes);
        $zip->addFromString('[Content_Types].xml', $contentTypes);
    }

    // 确定起始PID
    $id_num = 2;
    $existingCustomXml = $zip->getFromName('docProps/custom.xml');
    if ($existingCustomXml) {
        preg_match_all('/pid="(\d+)"/', $existingCustomXml, $matches);
        if (!empty($matches[1])) {
            $id_num = max($matches[1]) + 1;
        }
    }

    // 构建自定义属性XML
    $updatedXmlContent = '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Properties xmlns="http://schemas.openxmlformats.org/officeDocument/2006/custom-properties" xmlns:vt="http://schemas.openxmlformats.org/officeDocument/2006/docPropsVTypes">';
    foreach($properties as $prop_name=>$prop_val){
         $updatedXmlContent .= '<property fmtid="{D5CDD505-2E9C-101B-9397-08002B2CF9AE}" pid="'.$id_num.'" name="'.$prop_name.'"><vt:lpwstr>'.$prop_val.'</vt:lpwstr></property>';
         $id_num++;
    }
    $updatedXmlContent .= '</Properties>';

    $zip->addFromString('docProps/custom.xml', $updatedXmlContent);
    $zip->close();

}else{
    echo "could not open file";
}

验证方法 #

修改后打开Word，通过文件>信息>属性>高级属性>自定义标签查看属性是否显示。如果还是不行，把手动添加属性后的custom.xml替换掉生成的文件，再打开Word，排除XML内容本身的问题。

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