PHP调用COM(word.application)转HTML为DOCX时SaveAs报参数类型不匹配

问题原因与修复方案 #

• 路径分隔符不兼容
  代码中的示例路径同时混用了Windows标准反斜杠\和Linux标准正斜杠/，Word COM组件只能识别纯反斜杠格式的Windows本地路径，混合分隔符会导致路径识别失败触发类型错误。修复时统一将路径中的正斜杠替换为反斜杠：
  $new = str_replace('/', '\\', $new);
• 路径编码不匹配
  如果路径中包含中文、空格或其他特殊字符，PHP默认UTF-8编码的字符串传入GBK编码的Word COM组件时会出现乱码，无法被识别为合法路径。修复时提前将路径转为GBK编码：
  $new = iconv('UTF-8', 'GBK//IGNORE', $new);
• 保存格式参数类型不符合COM要求
  部分Office版本要求SaveAs的第二个参数为COM变体整数类型，直接传入PHP整数可能出现类型校验失败。修复时将格式参数强制转为VT_I4类型的COM变体：
  $newSaveFormat = variant_cast($newSaveFormat, VT_I4);
• 变量未初始化或活动文档不存在
  先确认$new变量已经提前赋值为合法的保存路径，另外要确保调用SaveAs前已经通过$word->Documents->Open($源HTML路径)打开了待转换的文件，保证ActiveDocument对象真实存在。

修复后完整代码示例 #

static $wdSaveFormats = array(
    'docx' => 16,
    'html' => 10,
    'rtf'  => 6,
    'txt'  => 2,
    'doc'  => 0,
    'pdf'  => 17,
);
$newSaveFormat = 16;
// 提前给$new赋值合法保存路径
$new = 'Z:\data\reportPdf\1636634123sampl_test_2019programreport.docx';
if (preg_match('@\.(.{3,4})$@', $new, $arr)) {
    if (isset($wdSaveFormats[$arr[1]])) {
        $newSaveFormat = $wdSaveFormats[$arr[1]];
    }
}
// 修复路径分隔符
$new = str_replace('/', '\\', $new);
// 修复路径编码
$new = iconv('UTF-8', 'GBK//IGNORE', $new);
// 转换参数为COM要求的整数类型
$newSaveFormat = variant_cast($newSaveFormat, VT_I4);

$rethrow = NULL;
try {
    // 不要漏打开源HTML文件的逻辑
    // $word->Documents->Open('你的源HTML文件绝对路径');
    $word->ActiveDocument->WebOptions->UseLongFileNames = true;
    $word->ActiveDocument->SaveAs($new, $newSaveFormat);
} catch (Exception $rethrow) {
    // 自定义异常处理逻辑
} finally {
    // 建议添加资源释放逻辑，避免残留WINWORD后台进程
    if (isset($word->ActiveDocument)) {
        $word->ActiveDocument->Close(false);
    }
    $word->Quit();
    $word = null;
}

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