opentbs 的 `ope=changepic` 不支持直接通过 http/https url 插入图片，因其底层依赖 `file_exists()` 和 `filesize()` 函数校验文件——而这二者在 php 中对远程 url 始终返回 false，导致图片替换静默失败。正确做法是先下载图片为本地临时文件，再交由 opentbs 处理。
OpenTBS 在执行 [field; ope=changepic] 指令时，并非直接将 URL 写入文档，而是尝试以「本地文件」方式加载图片资源。其内部调用链严格遵循以下三步：
- file_exists($url) → 判断路径是否存在
- filesize($url) → 获取文件大小（用于嵌入校验）
- file_get_contents($url) → 读取二进制内容并嵌入
⚠️ 关键问题在于：尽管 PHP 官方文档注明 file_exists() 和 filesize() 理论上 支持 HTTP 流包装器（需 allow_url_fopen=On），但实际行为中两者对任何 URL 均返回 false（这是 PHP 的已知限制，与 cURL 或 stream context 无关）。因此 OpenTBS 在第一步即判定“文件不存在”，后续流程被跳过，图片保持模板中的占位图，且无错误提示（尤其当 $NoErr = false 时更易被忽略）。
✅ 正确解决方案：预下载图片为临时文件，再传入 OpenTBS
以下是推荐的健壮实现方式（含错误处理与资源清理）：
function downloadImageToTemp($url) {
$tmpFile = tempnam(sys_get_temp_dir(), 'tbs_img_');
if (!$tmpFile) {
throw new Exception("Failed to create temporary file for image: $url");
}
$content = file_get_contents($url);
if ($content === false) {
unlink($tmpFile);
throw new Exception("Failed to download image from URL: $url");
}
if (file_put_contents($tmpFile, $content) === false) {
unlink($tmpFile);
throw new Exception("Failed to write image content to temporary file.");
}
return $tmpFile;
}
// 使用示例
$imgs = array();
foreach ([
['url' => 'http://192.168.0.100/photo1.jpg', 'txt' => 'Sample 1'],
['url' => 'https://example.com/photo2.png', 'txt' => 'Sample 2']
] as $item) {
try {
$tempPath = downloadImageToTemp($item['url']);
$imgs[] = [
'url' => $tempPath, // ✅ 传入本地临时路径
'txt' => $item['txt'],
'temp' => $tempPath // 保留路径以便后续清理
];
} catch (Exception $e) {
error_log("Image load failed: " . $e->getMessage());
// 可选择跳过或提供默认占位图路径
continue;
}
}
// 合并数据块
$OOo->MergeBlock('imgs', $imgs);
// ⚠️ 注意：务必在 Show() 之后、脚本结束前清理临时文件
register_shutdown_function(function() use ($imgs) {
foreach ($imgs as $img) {
if (!empty($img['temp']) && file_exists($img['temp'])) {
@unlink($img['temp']);
}
}
});
$OOo->Show(OPENTBS_DOWNLOAD, 'report.docx');? 关键注意事项：
- 模板中无需修改：仍使用 [imgs.url; ope=changepic]，OpenTBS 会自动识别本地路径并嵌入；
- 确保 PHP 有写入系统临时目录权限（sys_get_temp_dir() 可查）；
- 生产环境建议添加图片尺寸/格式校验（如 getimagesize()）及超时控制（改用 curl 替代 file_get_contents 可更好控制）；
- 若需支持大量图片，可复用临时目录 + 哈希命名避免冲突，而非每次 tempnam()。
该方案完全兼容 OpenTBS 默认行为，无需修改库源码，同时保障了可靠性与可维护性。
