PHP cURL句柄资源被替换为整数的问题求助

你遇到的这个问题本质是PHP资源类型无法被序列化——cURL句柄$ch属于PHP的资源类型，它指向的是当前进程中的底层资源连接，当你把SoapCli实例存入$_SESSION时，PHP会自动对实例进行序列化操作，但资源类型在序列化过程中会丢失实际的句柄引用，被转换成整数0。当你从Session中取出实例后，$ch已经不是有效的cURL资源，自然无法继续发起请求。

针对这个问题，有两种可行的修复思路，你可以根据自己的场景选择：

思路1：手动管理会话Cookie（无需修改类结构） #

既然不能保存cURL句柄，那我们只保存维持会话需要的Cookie数据，每次请求时重新初始化cURL并加载Cookie：

登录逻辑（index.php）： #

session_start();
$soapCli = new SoapCli();
// 执行登录请求
$loginResp = $soapCli->Request('POST', '你的登录URL', $loginHeaders, $loginPostData);
// 将登录后获取的Cookie存入Session
if (!empty($loginResp->info['cookie'])) {
    $_SESSION['soap_session_cookie'] = $loginResp->info['cookie'];
}

后续请求逻辑（ajax.php）： #

session_start();
$soapCli = new SoapCli();
// 从Session中取出Cookie，设置到cURL句柄中
if (isset($_SESSION['soap_session_cookie'])) {
    curl_setopt($soapCli->ch, CURLOPT_COOKIE, $_SESSION['soap_session_cookie']);
}
// 执行目标请求
$apiResp = $soapCli->Request('GET', '你的API URL', $apiHeaders);
// 更新Session中的Cookie（如果请求返回了新的Cookie）
if (!empty($apiResp->info['cookie'])) {
    $_SESSION['soap_session_cookie'] = $apiResp->info['cookie'];
}

这种方式简单直接，不需要修改现有的SoapCli类，只需要手动维护Cookie的保存与恢复。

思路2：改造SoapCli类，实现Serializable接口 #

通过实现PHP的Serializable接口，手动控制实例的序列化和反序列化过程，只保存必要的会话数据，反序列化时重新创建cURL句柄并恢复会话状态：

修改后的SoapCli类： #

class SoapCli implements Serializable {
    private $ch;
    private $id;
    private $rc;
    // 新增：用于保存会话Cookie，支持序列化
    private $cookieData = '';

    function __construct() {
        $this->rc = 0;
        $this->id = bin2hex(random_bytes(8));
        $this->initCurl();
        $time = microtime(true);
        error_log(PHP_EOL.PHP_EOL."Instance id $this->id created ($time): \$this->ch = ".print_r($this->ch,true).PHP_EOL,3,"log.txt");
    }

    // 抽离cURL初始化逻辑，方便构造和反序列化时复用
    private function initCurl() {
        $this->ch = curl_init();
        // 保留你原来的cURL配置
        curl_setopt($this->ch, CURLOPT_AUTOREFERER, 1);
        curl_setopt($this->ch, CURLOPT_SSL_VERIFYPEER, false);
        curl_setopt($this->ch, CURLOPT_CONNECTTIMEOUT, 120);
        curl_setopt($this->ch, CURLOPT_COOKIEFILE, "");
        curl_setopt($this->ch, CURLOPT_ENCODING, "");
        curl_setopt($this->ch, CURLOPT_FOLLOWLOCATION, 1);
        curl_setopt($this->ch, CURLOPT_MAXREDIRS, 10);
        curl_setopt($this->ch, CURLOPT_RETURNTRANSFER, 1);
        curl_setopt($this->ch, CURLOPT_VERBOSE, 1);
        
        // 如果有保存的Cookie，恢复到cURL句柄中
        if (!empty($this->cookieData)) {
            curl_setopt($this->ch, CURLOPT_COOKIE, $this->cookieData);
        }
    }

    function Request(string $method, string $url, array $headers = array(), $postdata = "", $referer = null) {
        $resp = new stdClass();
        $resp->id = $this->id;
        $this->rc++;
        $time = microtime(true);
        error_log("Instance id $this->id before request $this->rc ($time): \$this->ch = ".print_r($this->ch,true).PHP_EOL,3,"log.txt");
        try {
            curl_setopt($this->ch, CURLOPT_CUSTOMREQUEST, $method);
            curl_setopt($this->ch, CURLOPT_URL, $url);
            curl_setopt($this->ch, CURLOPT_HTTPHEADER, $headers);
            if (isset($referer)) curl_setopt($this->ch, CURLOPT_REFERER, $referer);
            if (preg_match("/^POST$/i",$method)===1) curl_setopt($this->ch, CURLOPT_POSTFIELDS, $postdata);
            $resp->body = curl_exec($this->ch);
            $resp->err_message = curl_error($this->ch);
            $resp->err_number = curl_errno($this->ch);
            $resp->info = curl_getinfo($this->ch);
            
            // 每次请求后更新Cookie数据
            if (!empty($resp->info['cookie'])) {
                $this->cookieData = $resp->info['cookie'];
            }
        } catch (Exception $exception) {
            $resp->err_message = $exception->getMessage();
            $resp->err_number = $exception->getCode();
            $resp->info = $exception->getTrace();
        }
        $time = microtime(true);
        error_log("Instance id $this->id after request $this->rc ($time): \$this->ch = ".print_r($this->ch,true).PHP_EOL,3,"log.txt");
        return $resp;
    }

    // 实现Serializable接口：定义序列化时保存的数据
    public function serialize() {
        return serialize([
            'id' => $this->id,
            'rc' => $this->rc,
            'cookieData' => $this->cookieData
        ]);
    }

    // 实现Serializable接口：定义反序列化时的恢复逻辑
    public function unserialize($data) {
        $data = unserialize($data);
        $this->id = $data['id'];
        $this->rc = $data['rc'];
        $this->cookieData = $data['cookieData'];
        // 重新初始化cURL句柄并恢复Cookie
        $this->initCurl();
        $time = microtime(true);
        error_log(PHP_EOL.PHP_EOL."Instance id $this->id unserialized ($time): \$this->ch = ".print_r($this->ch,true).PHP_EOL,3,"log.txt");
    }
}

修改要点说明： #

1. 实现Serializable接口，手动控制序列化过程，只保存id、rc和cookieData（会话Cookie），跳过无法序列化的$ch资源。
2. 抽离initCurl()方法，在构造函数和反序列化时都调用它，重新创建cURL句柄并恢复之前保存的Cookie，维持会话状态。
3. 每次请求后更新$cookieData，确保会话的Cookie始终是最新的。

PHP的资源类型（比如cURL句柄、数据库连接）是与当前请求进程绑定的，绝对不能跨请求序列化保存——这是PHP的设计特性，不是Bug。所以不管用哪种方案，核心都是通过保存会话相关的业务数据（比如Cookie）来维持第三方服务器的会话，而不是保存底层的资源句柄。

内容的提问来源于stack exchange，提问作者VBobCat