PHP CURL设置CURLOPT_RETURNTRANSFER获取返回值

问题背景：默认行为与返回值需求

在使用 cURL 发起请求时，如果未对 CURLOPT_RETURNTRANSFER 进行特殊设置，cURL 会将抓取到的网页内容直接输出到浏览器标准输出（即页面显示）。此时，程序无法通过简单的赋值语句获取该字符串内容。

相关代码默认值如下：

// 默认为 0，表示直接输出，不返回值
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 0);

这种方式仅适用于需要直接将结果打印出来的场景。如果需要拿返回值做判断或者其他用途，则需要改变这一行为。

解决方案：设置 CURLOPT_RETURNTRANSFER

为了实现获取返回值的目的，需要将 CURLOPT_RETURNTRANSFER 设置为 1。设置后，curl_exec() 函数的执行结果将不再直接输出，而是作为一个字符串类型的数据返回，保存在变量中。

核心操作代码如下：

// 设置为 1，表示以字符串形式返回获取的输出文本流
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

第1步：初始化 cURL 会话并配置选项

• 目的：建立网络连接准备，并确保响应以字符串形式接收。
• 操作：调用 curl_init() 创建句柄，并使用 curl_setopt() 设置目标 URL 和返回模式。

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://example.com/api");
// 关键参数：开启返回值功能
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);

第2步：执行请求并捕获返回值

• 目的：发送请求并将结果存入变量。
• 操作：调用 curl_exec() 执行请求，将其返回值赋给一个变量（例如 $response）。

$response = curl_exec($ch);
// 此时 $response 是一个包含服务器响应内容的字符串

补充说明：关于 curl_multi_getcontent

原文提到在没有关闭 cURL 会话前使用 curl_multi_getcontent($ch) 取回值。需要注意的是，curl_multi_getcontent() 通常用于 cURL 批处理句柄（multi handle）中，用于从特定的 easy handle 获取内容。

如果是单句柄（easy handle）的标准用法，直接使用 curl_exec() 的返回值即可。如果在 multi 模式下使用，且为句柄设置了 CURLOPT_RETURNTRANSFER，则可以通过该函数获取字符串形式的返回内容。

PHP 手册描述：

• 如果 CURLOPT_RETURNTRANSFER 作为选项被设置到一个具体的句柄，那么 curl_multi_getcontent() 将会以字符串的形式返回那个 cURL 句柄获取的内容。

// Multi 模式下的示例
$content = curl_multi_getcontent($easy_handle);
if ($content !== false) {
    echo "获取到的内容：" . $content;
}

完成判断与收尾

• 成功状态：变量中存储了非空的字符串响应内容，且未触发错误或网络异常。
• 清理工作：无论是否使用了 multi 函数，执行完毕后都应调用 curl_close($ch) 释放资源，避免内存泄漏。

curl_close($ch);

以上就是PHP CURL通过设置CURLOPT_RETURNTRANSFER获取返回值的详细内容，更多关于PHP CURL技巧的资料请关注本站其它相关文章！