使用TBS/openTBS替换DOCX图片遇错误及Word修复提示问题

环境 #

• TBS 3.14.0
• OpenTBS 1.10.0
• PHP 7.2.5
• MS Word 2021

问题症状 #

• 替换图片后生成的DOCX可正常下载，但用Word打开时弹出「Word在filename.docx中发现不可读内容，是否恢复文档内容」提示
• 确认恢复后图片已成功替换，但每次打开都需执行修复操作
• 移除图片替换逻辑后，文件可正常打开但无法完成图片替换
• 调试时触发以下错误：

  
  TinyButStrong Error with PlugIn() method: '1' is an invalid plug-in key, the type of the value is 'boolean'.
  
  TinyButStrong Error Show() Method: The output is cancelled by the OpenTBS plugin because at least one error has occured.
  

已尝试的方案 #

1. 使用带name标记的OPENTBS_CHANGE_PICTURE调用：

   $TBS->PlugIn(OPENTBS_CHANGE_PICTURE, 'Picture 1', $Image);
   

2. 使用onshow.x结合changepic的方式：

   $TBS->VarRef['x'] = $signatureImageDocxTmp;
   

解决方案 #

1. 修复PlugIn参数类型错误 #

错误提示中的布尔值1说明OPENTBS_CHANGE_PICTURE常量未被正确定义，PHP将其解析为布尔true（对应数值1）。需确保：

• 正确引入OpenTBS类文件：

  require_once('tbs_class.php');
  require_once('opentbs_class.php');
  

• 若常量仍未定义，可手动指定对应数值（OpenTBS中OPENTBS_CHANGE_PICTURE的对应值为3）：

  if (!defined('OPENTBS_CHANGE_PICTURE')) {
      define('OPENTBS_CHANGE_PICTURE', 3);
  }
  $TBS->PlugIn(OPENTBS_CHANGE_PICTURE, 'Picture 1', $Image);
  

2. 避免DOCX文档结构损坏 #

Word提示不可读内容，多因图片替换时破坏了DOCX的XML结构或属性不匹配：

• 匹配图片格式：替换的图片格式需与模板中原图片一致（如原模板是PNG则替换PNG，原是JPG则替换JPG）
• 匹配尺寸或主动指定：尽量让替换图片尺寸与原图片一致，或通过参数指定尺寸避免Word自动修复：

  // 单位为厘米，指定宽5cm、高3cm
  $TBS->PlugIn(OPENTBS_CHANGE_PICTURE, 'Picture 1', $Image, array('w' => 5, 'h' => 3));
  

• 确认图片名称正确性：将DOCX解压后查看word/media/下的文件，或在Word中查看图片属性，确保'Picture 1'是模板中图片的真实名称
• 清理临时文件：处理完成后清理OpenTBS生成的临时文件，避免残留数据干扰：

  $TBS->PlugIn(OPENTBS_CLEAN_TEMP);
  

3. 开启调试模式定位细节 #

开启OpenTBS调试模式，获取更详细的错误日志：

$TBS = new clsTinyButStrong;
$TBS->Plugin(TBS_INSTALL, OPENTBS_PLUGIN);
$TBS->SetOption(OPENTBS_DEBUG, true);

4. 检查模板文件有效性 #

使用无损坏的干净DOCX模板重新测试，避免模板本身的隐藏错误在替换后被放大。

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