PHP文生图生成失败？网络排查法-php教程-PHP中文网

php“文生图失败”实为调用第三方ai api出错，问题在http请求链路而非gd函数；需检查api地址、认证头、提示词合规性及响应内容，而非本地图像处理。

php文生图生成失败？网络排查法

PHP 本身不“文生图”，所谓“PHP 文生图失败”实际是误判——你调用的不是本地模型，而是通过 curl 或 file_get_contents 请求第三方 AI 绘图 API（如文心一格、WHEE、LiblibAI 等）时出错。问题不在 PHP 图像函数，而在网络请求链路。

确认你真在调用远程 API，而不是想用 GD 生成文字图

很多人把「用 PHP 输出带文字的 PNG」（比如水印、按钮）和「用 PHP 调 AI 画图」混为一谈。imagestring()、imagepng() 属于本地绘图，不涉及网络；而「文生图」必须发 HTTP 请求到 AI 服务端。先看你的代码里有没有：

以 https:// 开头的 $url 变量
显式调用 curl_init()、file_get_contents() 或 guzzlehttp/guzzle
传了 prompt 字段且值是中文描述（如 "一只柴犬戴墨镜"）

如果没有以上任一特征，那你根本没走「文生图」流程，别查网络——回去检查 GD 扩展或输出头。

curl 请求返回空或 4xx/5xx，优先看响应头和 body

不要只盯着浏览器里 <img src="gen.php?prompt=..."> 显示空白。直接在 PHP 脚本里打印原始响应：

php
$ch = curl_init($api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADER, true); // 关键：带上响应头
$response = curl_exec($ch);
$header_size = curl_getinfo($ch, CURLINFO_HEADER_SIZE);
$header = substr($response, 0, $header_size);
$body = substr($response, $header_size);
echo "Header:\n" . $header . "\nBody:\n" . $body;

常见线索：

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

HTTP/1.1 401 Unauthorized → API key 过期或未传 Authorization 头
HTTP/1.1 403 Forbidden → 提示词被风控（如文心一格没加 画一幅画: 前缀）
HTTP/1.1 429 Too Many Requests → 免费额度用完，或未加 sleep(1) 限频
响应体含 "error": "prompt contains banned words" → 不是网络问题，是提示词触发内容策略

file_get_contents() 超时或返回 false，检查 PHP 网络基础配置

file_get_contents() 看似简单，但默认禁用 URL 封装器或超时过短会导致静默失败：

运行 php -r "var_dump(ini_get('allow_url_fopen'));"，输出必须是 string(1) "1"；若为 ""，需在 php.ini 中设 allow_url_fopen = On
超时默认仅 60 秒，大图生成常超时：改用 stream_context_create() 显式设 timeout
某些主机屏蔽了出站 HTTPS 请求，可临时用 curl -v https://api.whee.ai/v1/text2img 在服务器终端验证连通性

示例安全调用：

php
$options = [
    'http' => [
        'method' => 'POST',
        'header' => "Content-Type: application/json\r\nAuthorization: Bearer {$token}\r\n",
        'content' => json_encode(['prompt' => $prompt]),
        'timeout' => 120,
    ]
];
$ctx = stream_context_create($options);
$result = file_get_contents($url, false, $ctx);
if ($result === false) {
    $err = error_get_last();
    error_log("API request failed: " . $err['message']);
}