如何用 curl_init 快速发起一个简单的 GET 请求？适合 PHP 新手入门参考

gitbox 2025-09-19

在 PHP 中，curl 扩展是用于发起 HTTP 请求的强大工具。无论你需要与外部 API 通信，还是抓取网页内容，curl 都能提供灵活且高效的解决方案。对于新手而言，了解如何使用 curl_init() 来发起一个简单的 GET 请求是一个非常重要的起点。

什么是 curl_init？

curl_init() 是 PHP 中用于初始化一个 cURL 会话的函数。它会返回一个 cURL 资源句柄，你可以使用这个句柄配置请求的详细选项，最终发起 HTTP 请求。

如何用 curl_init 发起简单的 GET 请求？

以下是一个使用 curl_init() 发起简单 GET 请求的基本步骤：

初始化 cURL 会话
首先，使用 curl_init() 初始化一个 cURL 会话。
设置 cURL 选项
使用 curl_setopt() 来配置请求的参数，比如请求的 URL、请求方式等。
执行 cURL 请求
使用 curl_exec() 执行设置好的请求，并获取响应内容。
关闭 cURL 会话
最后，使用 curl_close() 来关闭 cURL 会话并释放资源。

示例代码

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 初始化 cURL 会话</span></span><span>
</span><span><span class="hljs-variable">$ch</span></span><span> = </span><span><span class="hljs-title function_ invoke__">curl_init</span></span><span>();

</span><span><span class="hljs-comment">// 设置请求 URL</span></span><span>
</span><span><span class="hljs-title function_ invoke__">curl_setopt</span></span><span>(</span><span><span class="hljs-variable">$ch</span></span><span>, CURLOPT_URL, </span><span><span class="hljs-string">"https://api.example.com/data"</span></span><span>);

</span><span><span class="hljs-comment">// 设置返回内容作为字符串</span></span><span>
</span><span><span class="hljs-title function_ invoke__">curl_setopt</span></span><span>(</span><span><span class="hljs-variable">$ch</span></span><span>, CURLOPT_RETURNTRANSFER, </span><span><span class="hljs-literal">true</span></span><span>);

</span><span><span class="hljs-comment">// 发起请求并获取响应</span></span><span>
</span><span><span class="hljs-variable">$response</span></span><span> = </span><span><span class="hljs-title function_ invoke__">curl_exec</span></span><span>(</span><span><span class="hljs-variable">$ch</span></span><span>);

</span><span><span class="hljs-comment">// 检查请求是否成功</span></span><span>
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$response</span></span><span> === </span><span><span class="hljs-literal">false</span></span><span>) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"cURL 错误: "</span></span><span> . </span><span><span class="hljs-title function_ invoke__">curl_error</span></span><span>(</span><span><span class="hljs-variable">$ch</span></span><span>);
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"请求成功，返回数据: "</span></span><span> . </span><span><span class="hljs-variable">$response</span></span><span>;
}

</span><span><span class="hljs-comment">// 关闭 cURL 会话</span></span><span>
</span><span><span class="hljs-title function_ invoke__">curl_close</span></span><span>(</span><span><span class="hljs-variable">$ch</span></span><span>);
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

代码解释

curl_init()：初始化一个 cURL 会话。
curl_setopt($ch, CURLOPT_URL, "https://api.example.com/data")：设置请求的 URL，表示我们要向 https://api.example.com/data 发起 GET 请求。
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true)：设置此选项为 true，使得返回的响应不会直接输出，而是作为字符串返回。
curl_exec($ch)：执行 cURL 会话，发起请求并获取响应内容。
curl_error($ch)：如果请求失败，curl_error() 可以帮助你获取错误信息，方便调试。
curl_close($ch)：关闭 cURL 会话，释放资源。

返回的响应

当请求成功时，$response 变量将包含来自目标服务器的响应内容。对于一个简单的 GET 请求，服务器通常会返回一个字符串、JSON 数据，或者 HTML 内容。你可以根据需要对响应数据进行进一步处理。

错误处理

cURL 提供了错误处理机制。当请求失败时，curl_exec() 将返回 false，此时你可以使用 curl_error() 获取详细的错误信息。此外，curl_getinfo() 也能提供一些关于请求的详细信息，比如响应码等。

<span><span><span class="hljs-comment">// 检查请求是否成功</span></span><span>
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$response</span></span><span> === </span><span><span class="hljs-literal">false</span></span><span>) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"请求失败，错误信息："</span></span><span> . </span><span><span class="hljs-title function_ invoke__">curl_error</span></span><span>(</span><span><span class="hljs-variable">$ch</span></span><span>);
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"HTTP 状态码："</span></span><span> . </span><span><span class="hljs-title function_ invoke__">curl_getinfo</span></span><span>(</span><span><span class="hljs-variable">$ch</span></span><span>, CURLINFO_HTTP_CODE);
}
</span></span>

总结

使用 curl_init() 发起 GET 请求是非常直接和简单的。通过上面的步骤，你可以轻松地在 PHP 中发起网络请求，无论是从外部 API 获取数据，还是抓取网页内容，curl 都能为你提供强大的功能。只要你掌握了基础的 curl 用法，后续可以根据具体需求添加更多的设置，如请求头、超时限制、代理等。

希望这篇文章能帮助你更好地理解和使用 cURL，快速进行 PHP 网络请求！