php返回json时应只提供图片url和文字提示，而非二进制数据；图片须已保存至web可访问路径，url建议加时间戳防缓存，并设置header('content-type: application/json; charset=utf-8')，使用json_encode()配合json_unescaped_unicode确保中文正常。
PHP 输出 JSON 时如何同时返回图片地址和文字提示
直接输出 JSON 时不能嵌入二进制图片数据（如 file_get_contents() 得到的原始图片字节），否则 JSON 格式会损坏。正确做法是只返回图片的可访问 URL（不是文件路径），配合文字提示字段，由前端负责加载图片。
- 图片必须已保存在 Web 可访问目录下（如
./uploads/20241105_abc.jpg），然后拼出相对或绝对 URL（如https://example.com/uploads/20241105_abc.jpg） - 不要用
base64_encode(file_get_contents($path))塞进 JSON —— 体积膨胀约 33%，且 PHP 默认内存限制容易触发Fatal error: Allowed memory size exhausted - 文字提示字段名建议语义化，比如
"message"或"hint"，避免用"info"这类模糊命名
生成带时间戳的图片 URL 防止浏览器缓存
前端 JS 加载图片时，若 URL 不变，可能复用旧缓存导致“图片没刷新”。加时间戳参数是最轻量的强制刷新方式，PHP 侧只需在拼 URL 时追加 ?v= 参数。
- 推荐用
time()或microtime(true)，例如：$url = $base_url . '?v=' . time(); - 避免用
rand()或mt_rand()—— 无意义随机数不利于调试，且可能重复 - 如果图片由 GD/ImageMagick 动态生成并写入文件，确保写入完成后再构造 URL，否则前端可能请求到空文件或 404
完整 JSON 响应示例与 header 设置
不设正确的 Content-Type，前端 fetch().json() 会失败；不设 charset，中文提示可能乱码。
header('Content-Type: application/json; charset=utf-8');
echo json_encode([
'success' => true,
'message' => '图片已更新，请查看',
'image_url' => 'https://example.com/uploads/latest.jpg?v=' . time()
], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
- 务必用
JSON_UNESCAPED_UNICODE，否则中文提示变成\u4f60\u597d - 避免手动拼接 JSON 字符串 —— 容易漏转义引号或斜杠，引发前端解析错误
Unexpected token - 如果
json_encode()返回false，可用json_last_error_msg()查错，常见原因是数组含资源句柄或循环引用
为什么不用 PHP 直接输出图片 + JSON 混合响应
HTTP 响应体只能有一种主体类型。试图先输出 PNG 二进制再输出 JSON，结果是前端收到乱码或截断，fetch() 无法解析为有效 JSON。
立即学习“PHP免费学习笔记（深入）”；
- 个别教程用
Content-Type: multipart/mixed分隔多段 —— 浏览器原生 fetch / axios 不支持解析，需手动拆包，得不偿失 - 想“一步到位”返回图片和元数据，唯一可靠方式是：图片走独立 URL，JSON 只管描述（URL + 提示 + 状态等）
- 若真需服务端合成图文响应（如生成带水印的图+日志），应分两步：先调 API 得 JSON，再根据其中
image_url发起第二请求
