使用 init 函数结合 curl 初始化 HTTP 请求

gitbox 2025-05-19

PHP 提供了 curl 库，可以非常方便地通过 cURL 发送 HTTP 请求。curl 是一个强大的工具，广泛应用于进行 HTTP 请求、发送表单数据、抓取网页等操作。为了简化这些操作，PHP 提供了一些函数，其中最重要的一个函数就是 curl_init()。它用于初始化一个 cURL 会话，让我们能够开始发送请求。

在这篇文章中，我们将演示如何使用 curl_init() 来初始化一个 cURL 会话，并结合 curl_setopt()、curl_exec() 等函数来发送 HTTP 请求。

1. 初始化 cURL 会话

在使用 cURL 发送请求之前，我们首先需要初始化一个 cURL 会话。PHP 提供了 curl_init() 函数用于初始化一个新的 cURL 会话，它返回一个 cURL 句柄，我们可以使用该句柄来配置请求选项并最终执行请求。

<?php
// 初始化一个 cURL 会话
$ch = curl_init();
?>

此时，curl_init() 返回的 $ch 变量是一个 cURL 句柄，它代表了当前的 cURL 会话。接下来，我们可以通过该句柄配置请求的一些选项。

2. 设置 cURL 请求选项

使用 curl_setopt() 函数，我们可以为 cURL 会话设置各种选项。最常用的选项是设置请求的 URL、请求方法、请求头信息等。

设置 URL

要设置请求的目标 URL，可以使用 CURLOPT_URL 选项。

// 设置请求的 URL
curl_setopt($ch, CURLOPT_URL, "http://gitbox.net/example");

启用返回的内容

默认情况下，curl_exec() 函数会将请求的结果直接输出到浏览器。如果我们希望获取请求结果而不是直接输出它，可以通过 CURLOPT_RETURNTRANSFER 选项来控制。

// 设置返回内容而不直接输出
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

设置 HTTP 请求方法

cURL 支持多种 HTTP 方法，如 GET、POST、PUT 等。如果你想使用 POST 方法，可以通过 CURLOPT_POST 来设置：

// 设置请求方法为 POST
curl_setopt($ch, CURLOPT_POST, true);

// 设置 POST 数据
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'username' => 'testuser',
    'password' => 'testpassword'
]));

设置请求头

如果需要设置自定义的 HTTP 头信息，可以使用 CURLOPT_HTTPHEADER 选项：

// 设置自定义的 HTTP 头
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/x-www-form-urlencoded',
    'Authorization: Bearer token_value'
]);

3. 执行 cURL 请求并获取响应

配置完所有选项后，接下来可以使用 curl_exec() 函数来执行请求并获取响应。此函数会返回请求的结果，如果没有错误发生，返回的结果就是目标 URL 的响应内容。

// 执行请求并获取响应结果
$response = curl_exec($ch);

// 检查请求是否成功
if ($response === false) {
    echo "cURL 错误：" . curl_error($ch);
} else {
    echo "请求成功，响应内容：" . $response;
}

4. 关闭 cURL 会话

完成请求后，应该关闭 cURL 会话以释放资源。关闭 cURL 会话是一个好习惯，尤其是在处理大量请求时，它有助于提高系统性能。

// 关闭 cURL 会话
curl_close($ch);

5. 完整示例

以下是一个完整的例子，展示如何通过 PHP 使用 cURL 初始化、设置选项、发送请求，并获取响应结果。

<?php
// 初始化 cURL 会话
$ch = curl_init();

// 设置请求的 URL
curl_setopt($ch, CURLOPT_URL, "http://gitbox.net/example");

// 设置返回内容而不直接输出
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// 设置请求方法为 POST
curl_setopt($ch, CURLOPT_POST, true);

// 设置 POST 数据
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'username' => 'testuser',
    'password' => 'testpassword'
]));

// 设置自定义的 HTTP 头
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/x-www-form-urlencoded',
    'Authorization: Bearer token_value'
]);

// 执行请求并获取响应结果
$response = curl_exec($ch);

// 检查请求是否成功
if ($response === false) {
    echo "cURL 错误：" . curl_error($ch);
} else {
    echo "请求成功，响应内容：" . $response;
}

// 关闭 cURL 会话
curl_close($ch);
?>