opentbs 的 `ope=changepic` 不支持直接通过 http/https url 插入图片，因其底层依赖 `file_exists()` 和 `filesize()` —— 这两个函数对远程 url 始终返回 false，导致图片替换静默失败。需先下载为本地临时文件再注入。
在使用 OpenTBS 动态插入图片（尤其是来自本地 Web 服务器或公网 URL 的图片）时，常见现象是：文本内容（如 [imgs.txt]）正常渲染，但 [imgs.url;ope=changepic] 却始终显示原始占位图，且无报错（即使设置 $NoErr = false）。根本原因在于 OpenTBS 内部调用图片替换逻辑时，严格依赖三个本地文件系统函数：
- file_exists($url) → 判断资源是否存在
- filesize($url) → 获取文件大小（用于嵌入校验）
- file_get_contents($url) → 读取二进制数据
⚠️ 尽管 PHP 官方文档注明 file_exists() 和 filesize() 理论上 支持 http:// 流包装器，但在绝大多数生产环境（尤其是启用了 allow_url_fopen=Off、SELinux 限制、或某些 PHP SAPI 如 FPM 下），它们对远程 URL 实际返回 false，导致 OpenTBS 提前终止图片处理流程，不报错也不替换。
✅ 正确做法：预下载远程图片为临时文件，再传入本地路径
以下是推荐的健壮实现方式（含错误处理与清理）：
function downloadImageToTemp($url) {
$content = @file_get_contents($url);
if ($content === false) {
throw new Exception("Failed to fetch image from URL: $url");
}
$ext = pathinfo(parse_url($url, PHP_URL_PATH), PATHINFO_EXTENSION) ?: 'jpg';
$tempFile = tempnam(sys_get_temp_dir(), 'tbs_img_') . '.' . strtolower($ext);
if (file_put_contents($tempFile, $content) === false) {
throw new Exception("Failed to write temporary image file: $tempFile");
}
return $tempFile;
}
// 在合并数据前处理图片数组
$imgs = array();
foreach ([
['url' => 'http://192.168.0.100/img1.jpg', 'txt' => 'Sample 1'],
['url' => 'https://via.placeholder.com/150', 'txt' => 'Sample 2']
] as $item) {
try {
$localPath = downloadImageToTemp($item['url']);
$imgs[] = [
'url' => $localPath, // ✅ 传入本地临时路径，非 URL
'txt' => $item['txt'],
'_tbs_item_clean' => function($item) {
@unlink($item['url']); // 自动清理临时文件
}
];
} catch (Exception $e) {
error_log("Image download failed: " . $e->getMessage());
// 可选：跳过该条目或提供默认占位图路径
continue;
}
}
$OOo->MergeBlock('imgs', $imgs);
$OOo->Show(OPENTBS_DOWNLOAD, 'report.docx');? 关键要点：
- 模板中保持原写法：[imgs.url;ope=changepic]，但确保 imgs.url 是绝对本地路径（如 /tmp/tbs_img_xxx.jpg），而非 URL；
- 使用 _tbs_item_clean 回调（OpenTBS ≥ 1.9.9）可自动清理临时文件，避免磁盘堆积；
- 若无法启用 allow_url_fopen，此方案仍完全有效（因 file_get_contents() 对 URL 的支持比 file_exists() 更可靠）；
- 生产环境建议增加 MIME 类型校验（如 getimagesize()）和尺寸限制，防止恶意大文件上传风险。
总结：OpenTBS 的 changepic 本质是「本地文件嵌入」机制，不原生支持远程资源。将网络图片转为可信本地临时文件，是稳定、兼容且符合设计预期的标准实践。
