PHP生成的Discord在线人数图片嵌入论坛后无法正常显示如何解决

头输出校验 #

• 必须在GD输出图片内容前发送对应格式的Content-Type头，且不能有任何提前输出（包括PHP文件开头/结尾的空格、换行、BOM头、报错信息）
  示例代码：

  <?php
  ob_clean(); // 清空所有之前的输出缓冲区，避免意外内容污染图片
  header('Content-Type: image/png'); // 对应你输出的图片格式，jpg则用image/jpeg
  // 此处写Discord接口请求、GD生成图片的逻辑
  imagepng($img);
  imagedestroy($img);
  exit; // 输出完图片直接终止，避免后续逻辑产生额外输出
  

跨域/防盗链处理 #

• 若论坛和PHP脚本不在同域名下，添加跨域头：
  header('Access-Control-Allow-Origin: 你的论坛实际域名');
  测试阶段可临时用*代替正式域名，上线后替换为实际域名即可。
• 若服务端配置了防盗链，放行论坛域名的请求，或者在PHP中判断Referer字段，允许来自论坛域名的访问。

请求适配调整 #

• 如果你的PHP脚本依赖Cookie、Session鉴权，跨域场景下需额外添加头：
  header('Access-Control-Allow-Credentials: true');
  同时论坛的img标签添加属性：
  <img src="你的PHP脚本地址" alt="Discord在线人数" crossorigin="use-credentials">
• 可添加随机参数避免缓存导致的异常：
  <img src="你的PHP脚本地址?t=<?php echo time(); ?>" alt="Discord在线人数">

排查方法 #

打开浏览器开发者工具的网络面板，找到对应img请求的条目：

• 状态码为4xx/5xx：排查脚本权限、代码运行报错、接口调用失败问题
• 状态码200但响应内容包含明文报错、空格/换行：修复提前输出问题
• 状态码200响应内容为二进制但图片不显示：检查Content-Type头是否和生成的图片格式一致

优化建议 #

• 对Discord接口的返回结果做1-5分钟的本地缓存，避免每次请求图片都调用第三方接口，降低被限流风险同时提升加载速度
• 脚本内移除所有调试类输出（echo、var_dump等）

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