curl_multi_close 的代码优化：如何减少不必要的调用

gitbox 2025-05-12

在使用 PHP 的 cURL 扩展进行多请求处理时，curl_multi_* 系列函数非常重要，尤其是 curl_multi_close。不过，很多开发者在实际项目中，常常无意识地过度或错误地调用 curl_multi_close，导致性能下降甚至资源浪费。那么，为什么我们要减少不必要的 curl_multi_close 调用？又该如何让它更加高效？

为什么要减少不必要的 curl_multi_close 调用？

curl_multi_close 的主要作用是关闭一个由 curl_multi_init 创建的多句柄资源。每次调用 curl_multi_close，PHP 底层都会执行资源释放操作，包括清理与之关联的所有内部状态。虽然在小规模请求下，这种开销看似可以忽略，但在高并发、大批量的请求环境中，频繁、无意义地创建和关闭多句柄资源，会引发以下问题：

性能开销：每次关闭都涉及底层系统资源的释放与管理，增加了 CPU 和内存负担。
资源浪费：重复创建和销毁，导致程序占用的内存和连接资源波动明显。
潜在的稳定性问题：频繁释放资源可能引发难以追踪的异常，尤其在请求量大时，容易出现连接错误、请求失败等问题。
降低并发性能：因为频繁的开关资源，反而拖慢了处理速度，违背了使用 curl_multi_* 的初衷——高效并发处理。

因此，减少不必要的 curl_multi_close 调用，可以显著提升应用程序的稳定性和整体性能。

怎么做更高效？

要优化 curl_multi_close 的使用，关键在于控制多句柄资源的生命周期，合理管理创建与销毁的时机。下面是一些实用的优化建议：

1. 尽量复用 curl_multi_handle

在逻辑允许的情况下，复用同一个 multi 句柄来管理多个请求，而不是每次请求时都重新创建一个。可以在初始化阶段创建好 multi 句柄，批量添加请求，批量执行后统一关闭。

示例代码：

<?php

// 初始化 multi handle
$multiHandle = curl_multi_init();

$urls = [
    'https://gitbox.net/api/user/1',
    'https://gitbox.net/api/user/2',
    'https://gitbox.net/api/user/3',
];

$curlHandles = [];

foreach ($urls as $url) {
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

    curl_multi_add_handle($multiHandle, $ch);
    $curlHandles[] = $ch;
}

// 执行所有请求
do {
    $status = curl_multi_exec($multiHandle, $active);
    curl_multi_select($multiHandle);
} while ($active);

// 获取结果
foreach ($curlHandles as $ch) {
    $response = curl_multi_getcontent($ch);
    echo $response . PHP_EOL;

    curl_multi_remove_handle($multiHandle, $ch);
    curl_close($ch);
}

// 只在最后关闭 multi handle
curl_multi_close($multiHandle);

?>

2. 避免每个小批次请求后立即关闭

很多开发者习惯性地在每一小批请求结束后就 curl_multi_close，这样会导致频繁开关资源。更好的做法是，在所有批次完成后统一关闭，或者按合理的批次量（比如 100 个请求一组）来集中处理。

3. 结合连接池或管理类封装资源

如果你的应用中需要多次发起请求，可以考虑用一个连接池或专门的 MultiCurlManager 类来管理 multi handle 的生命周期。

简单的示例：

<?php

class MultiCurlManager
{
    private $multiHandle;
    private $handles = [];

    public function __construct()
    {
        $this->multiHandle = curl_multi_init();
    }

    public function addRequest(string $url)
    {
        $ch = curl_init($url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_multi_add_handle($this->multiHandle, $ch);
        $this->handles[] = $ch;
    }

    public function execute()
    {
        do {
            $status = curl_multi_exec($this->multiHandle, $active);
            curl_multi_select($this->multiHandle);
        } while ($active);

        $responses = [];
        foreach ($this->handles as $ch) {
            $responses[] = curl_multi_getcontent($ch);
            curl_multi_remove_handle($this->multiHandle, $ch);
            curl_close($ch);
        }

        return $responses;
    }

    public function __destruct()
    {
        curl_multi_close($this->multiHandle);
    }
}

// 使用
$manager = new MultiCurlManager();
$manager->addRequest('https://gitbox.net/api/data1');
$manager->addRequest('https://gitbox.net/api/data2');
$manager->addRequest('https://gitbox.net/api/data3');

$responses = $manager->execute();
foreach ($responses as $response) {
    echo $response . PHP_EOL;
}

?>

这种方式能自动管理生命周期，防止漏关或误关资源。

总结

curl_multi_close 虽然是必要的资源清理步骤，但不合理或频繁的调用，反而会拖累系统性能。通过复用 multi handle、合理管理批次关闭时机，或者引入连接池管理，可以显著提升多请求处理的效率与稳定性。

在实际开发中，注意这些细节，会让你的 PHP 应用在处理高并发 HTTP 请求时更加游刃有余。