curl_exec

(PHP 4 >= 4.0.2, PHP 5, PHP 7, PHP 8)

curl_exec — 执行 cURL 会话

说明

curl_exec(CurlHandle $handle): string|bool

执行指定 cURL 会话。

这个函数应该在初始化 cURL 会话并且设置所有选项后调用。

参数

handle: 由 curl_init() 返回的 cURL 句柄。

返回值

成功时，函数会将结果直接冲刷到 stdout 并返回 true，或者在失败时返回 false。然而，如果设置了 CURLOPT_RETURNTRANSFER 选项，将会在成功时返回结果，失败时返回 false。

警告

此函数可能返回布尔值 false，但也可能返回等同于 false 的非布尔值。请阅读布尔类型章节以获取更多信息。应使用 === 运算符来测试此函数的返回值。

注意:
注意：指示错误的响应状态码（例如 404 Not found）不会视为失败。这种情况可以使用 curl_getinfo() 来检查。

更新日志

版本	说明
8.0.0	`handle` 现在接受 CurlHandle 实例；之前接受 resource。

示例

示例 #1 获取网页

<?php
// 创建新的 cURL 资源
$ch = curl_init();

// 设置 URL 和相应的选项
curl_setopt($ch, CURLOPT_URL, "http://www.example.com/");
curl_setopt($ch, CURLOPT_HEADER, 0);

// 抓取 URL 并把它传递给浏览器
curl_exec($ch);
?>

参见

curl_multi_exec() - 运行当前 cURL 句柄的子连接