如何在請求間共享認證狀態與登錄會話

M66 2025-05-24

curl_share_init() 是 PHP cURL 扩展提供的一个函数，用于初始化一个 cURL 会话共享对象。通过此对象，我们可以在不同的 cURL 请求之间共享会话数据。特别是在进行需要身份验证的请求时，这种共享会话的数据可以显著减少重复的登录操作，提高程序的效率。

$ch_share = curl_share_init();

上面的代码初始化了一个共享资源对象 $ch_share，之后你可以将其与多个 cURL 会话进行关联，以共享一些信息。

2. 使用 curl_share_setopt() 设置共享选项

一旦你创建了共享对象，可以通过 curl_share_setopt() 设置哪些信息需要被共享。常见的共享数据包括：

CURL_SHARE_COOKIE: 共享 Cookie
CURL_SHARE_HEADER: 共享头部信息
CURL_SHARE_REQUEST: 共享请求信息

curl_share_setopt($ch_share, CURL_SHARE_COOKIE, true);

通过上面的设置，多个请求可以共享 Cookie 数据，这对于维持登录状态至关重要。

3. 在多个 cURL 请求中共享会话

一旦共享对象初始化并设置了相关选项，接下来我们可以在不同的 cURL 请求中使用这个共享资源。首先，创建多个 cURL 会话，并将共享资源对象与每个会话进行绑定。

$ch1 = curl_init();
$ch2 = curl_init();

// 將共享資源綁定到 cURL 會話
curl_setopt($ch1, CURLOPT_SHARE, $ch_share);
curl_setopt($ch2, CURLOPT_SHARE, $ch_share);

// 設置請求的 URL（此處替換成實際的請求）
curl_setopt($ch1, CURLOPT_URL, 'https://m66.net/api/login');
curl_setopt($ch2, CURLOPT_URL, 'https://m66.net/api/data');

// 執行請求
curl_exec($ch1);
curl_exec($ch2);

// 关闭會話
curl_close($ch1);
curl_close($ch2);

在上述示例中，$ch1 和 $ch2 会共享认证状态和 Cookie 信息，因此它们都可以使用相同的登录会话。

4. 释放共享资源

当所有的 cURL 会话都完成后，记得释放共享资源，以避免内存泄漏：

curl_share_close($ch_share);

5. 使用示例：共享认证状态

假设我们需要在登录后访问多个 API 端点并保持登录状态。我们可以通过 curl_share_init() 和 curl_share_setopt() 来共享认证状态和 Cookie 信息。以下是一个完整的示例：

<?php
// 初始化共享資源
$ch_share = curl_share_init();

// 設置共享選項（共享 Cookie）
curl_share_setopt($ch_share, CURL_SHARE_COOKIE, true);

// 創建第一個 cURL 會話（登錄請求）
$ch1 = curl_init();
curl_setopt($ch1, CURLOPT_SHARE, $ch_share);
curl_setopt($ch1, CURLOPT_URL, 'https://m66.net/api/login');
curl_setopt($ch1, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch1, CURLOPT_POST, true);
curl_setopt($ch1, CURLOPT_POSTFIELDS, [
    'username' => 'your_username',
    'password' => 'your_password'
]);

// 执行登錄請求
$response1 = curl_exec($ch1);

// 創建第二個 cURL 會話（獲取數據）
$ch2 = curl_init();
curl_setopt($ch2, CURLOPT_SHARE, $ch_share);
curl_setopt($ch2, CURLOPT_URL, 'https://m66.net/api/userdata');
curl_setopt($ch2, CURLOPT_RETURNTRANSFER, true);

// 執行數據請求
$response2 = curl_exec($ch2);

// 輸出結果
echo $response1;
echo $response2;

// 关闭會話
curl_close($ch1);
curl_close($ch2);

// 釋放共享資源
curl_share_close($ch_share);
?>

在这个例子中，登录请求和数据请求共享了认证状态与 Cookie，因此可以避免重复登录操作。

总结

通过 curl_share_init() 和 curl_share_setopt()，我们能够在多个 cURL 请求之间共享认证状态与会话信息，显著提高了多次请求时的效率。在进行复杂的 API 调用或需要保持登录状态的场景中，这种方法可以帮助开发者减少不必要的重复认证操作，节省时间与资源。