必须使用cURL而非file_get_contents,设置CURLOPT_RETURNTRANSFER和CURLOPT_BINARYTRANSFER为true,用getimagesizefromstring校验二进制数据后再保存为.png文件。
PHP 用 cURL 发起 POST 请求并接收二进制截图数据
PHP 本身不生成截图,所谓“获取截图数据”,实际是调用外部服务(如 Puppeteer API、Browshot、或你自建的截图服务)提交 URL,对方渲染后返回 PNG/JPEG
字节
流。关键在于:你得把
设对,否则收到的是 HTML 或空响应。
常见错误是没设
或忽略
,导致截图数据被截断、乱码或直接输出到页面。
必须设置
,否则
直接输出二进制流,无法保存
务必加上
(尤其 PHP 5.6+),避免 cURL 自动转换换行符破坏图片头
若目标接口要求 JSON body,用
封装,并显式设置
检查响应头:
应为
或类似,不是
接收截图后怎么安全保存为文件
拿到
返回的原始字节后,不能直接
就完事——得先验证是否真为图片,否则可能写入错误内容甚至执行恶意 payload(尤其当请求参数可控时)。
用
检查二进制数据是否为合法图像,返回 false 就别存
强制指定扩展名,比如统一用
,不要依赖响应头里的
保存路径避开 Web 可访问目录,或至少加
禁止执行(Apache)或
(Nginx)
示例:
为什么 file_get_contents +
stream
_context_create 不适合截图请求
很多人想用更简洁的
替代 cURL,但它在处理二进制 POST 响应时非常脆弱——默认以文本模式读取,会悄悄过滤
替代 cURL,但它在处理二进制 POST 响应时非常脆弱——默认以文本模式读取,会悄悄过滤
字节,而 PNG 文件头部就有
,结果就是生成损坏的图片。
字节,而 PNG 文件头部就有
替代 cURL,但它在处理二进制 POST 响应时非常脆弱——默认以文本模式读取,会悄悄过滤
字节,而 PNG 文件头部就有
,结果就是生成损坏的图片。,结果就是生成损坏的图片。
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑,通过深度错误修复、底层性能微调以及安全加固,旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范,不包含破坏性变更。
下载
立即学习
“
PHP免费学习笔记(深入)
”;
的
很难精确控制二进制行为,比如无法等效
它不支持连接超时与读取超时分别设置,截图服务渲染常需 5–15 秒,容易卡死进程
出错时只返回
,没有详细错误码(如
),调试困难
结论:截图这类高延迟、强二进制依赖的场景,坚持用 cURL,别图省事
调试时
curl
_error 和响应
状态码
缺一不可
截图请求失败,光看
不够——比如服务返回 HTTP 200 但 body 是
,cURL 认为成功,你却当成图片存了。
必须检查
,预期是 200;4xx/5xx 要单独处理
即使 HTTP 状态码 OK,也要用
尝试解析响应体,看是否含
或
字段
开启
临时抓全响应头,确认
合理(比如小于 10KB 很可能不是图)
最简调试组合:
真正卡住人的,往往不是怎么发 POST,而是没意识到返回的“截图”可能是 base64 字符串、可能是重定向 URL、也可能是带签名的临时链接——得先看清文档里那个接口到底返回什么格式,再决定用
还是
再取一次。
curl_setoptCURLOPT_BINARYTRANSFERCURLOPT_RETURNTRANSFERCURLOPT_RETURNTRANSFER => truecurl_execCURLOPT_BINARYTRANSFER => truejson_encodeContent-Type: application/jsoncurl_getinfo($ch, CURLINFO_CONTENT_TYPE)image/pngtext/htmlcurl_execfile_put_contentsgetimagesizefromstring.pngContent-Disposition.htaccesslocation ~ \.php$ { deny all; }$imgData = curl_exec($ch);
if ($imgData && getimagesizefromstring($imgData)) {
file_put_contents('/tmp/screenshot_' . uniqid() . '.png', $imgData);
}file_get_contents很多人想用更简洁的 file_get_contents
\0\0很多人想用更简洁的 file_get_contents
\0\0file_get_contentsstream_context_createCURLOPT_BINARYTRANSFERfalseCURLE_COULDNT_CONNECTcurl_error($ch){"error":"timeout"}curl_getinfo($ch, CURLINFO_HTTP_CODE)json_decode($response, true)image_urldataCURLOPT_HEADER => trueContent-Lengthcurl_setopt($ch, CURLOPT_HEADER, true);
curl_setopt($ch, CURLOPT_NOBODY, false);
// 执行后用 explode("\r\n\r\n", $output, 2) 分离 header/bodybase64_decodefile_get_contents