Управление cURL ресурсами в PHP: правильное закрытие соединений

Расширенные примеры работы с curl_close в PHP

Ниже приведены подробные примеры, демонстрирующие различные сценарии использования закрытия cURL-дескриптора, включая неочевидные ситуации.

1. Закрытие нескольких дескрипторов в цикле (многопоточный cURL)

При использовании curl_multi закрытие отдельных дескрипторов выполняется после завершения всех запросов.

$urls = ['https://site1.com', 'https://site2.com', 'https://site3.com'];
$mh = curl_multi_init();
$handles = [];

foreach ($urls as $i => $url) {
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_multi_add_handle($mh, $ch);
    $handles[$i] = $ch;
}

$active = null;
do {
    curl_multi_exec($mh, $active);
} while ($active > 0);

// Закрытие: сначала удалить из мульти-дескриптора, потом закрыть каждый
foreach ($handles as $ch) {
    curl_multi_remove_handle($mh, $ch);
    curl_close($ch);
}
curl_multi_close($mh);
echo "Все запросы выполнены и дескрипторы закрыты.";

Результат: вывод строки "Все запросы выполнены и дескрипторы закрыты." без ошибок.

2. Закрытие при использовании пользовательских обработчиков (shorthand)

Создание вспомогательной функции, которая гарантирует закрытие, даже если содержимое не выбрано.

function safeCurlExec($url, callable $callback = null) {
    $ch = curl_init($url);
    if ($ch === false) {
        throw new RuntimeException('Не удалось инициализировать cURL');
    }
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    try {
        $result = curl_exec($ch);
        if ($result === false) {
            throw new RuntimeException(curl_error($ch));
        }
        if ($callback !== null) {
            $callback($ch); // возможность дополнительно манипулировать дескриптором до закрытия
        }
        return $result;
    } finally {
        curl_close($ch);
    }
}

$data = safeCurlExec('https://api.example.com');
echo "Данные получены: " . strlen($data) . " байт";

Результат: "Данные получены: 1240 байт" (без утечек).

3. Закрытие дескриптора в деструкторе объекта (ООП-подход)

class CurlClient {
    private $handle;
    
    public function __construct($url) {
        $this->handle = curl_init($url);
        if ($this->handle === false) {
            throw new InvalidArgumentException('cURL init failed');
        }
        curl_setopt($this->handle, CURLOPT_RETURNTRANSFER, true);
    }
    
    public function fetch() {
        return curl_exec($this->handle);
    }
    
    public function __destruct() {
        if (is_resource($this->handle)) {
            curl_close($this->handle);
        }
    }
}

$client = new CurlClient('https://example.com');
echo $client->fetch();
// При выходе из скрипта деструктор автоматически закроет cURL

Результат: страница https://example.com, дескриптор корректно закрыт.

4. Закрытие при ошибках в потоке вывода (CURLOPT_FILE)

Если ответ сохраняется в файл, ресурс файла нужно закрывать отдельно, а cURL - в любом случае.

$filename = '/tmp/download.pdf';
$fp = fopen($filename, 'w');
$ch = curl_init('https://example.com/file.pdf');
curl_setopt_array($ch, [
    CURLOPT_FILE => $fp,
    CURLOPT_HEADER => false
]);

$success = curl_exec($ch);
if ($success === false) {
    // ошибка, возможно, удалить частичный файл
    unlink($filename);
}
curl_close($ch);
fclose($fp);
echo $success ? "Файл скачан: $filename" : "Ошибка: " . curl_error($ch);

Результат: при успехе файл создаётся, при ошибке файл удаляется, cURL закрыт.

5. Закрытие дескриптора при использовании CURLOPT_WRITEFUNCTION

$data = '';
$ch = curl_init('https://example.com/stream');
curl_setopt($ch, CURLOPT_WRITEFUNCTION, function($ch, $chunk) use (&$data) {
    $data .= $chunk;
    return strlen($chunk);
});

curl_exec($ch);
curl_close($ch);
echo "Получено " . strlen($data) . " символов";

Результат: "Получено 0 символов", если поток пуст, или другое число.

6. Закрытие после передачи данных по FTP (не HTTP)

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => 'ftp://ftp.example.com/file.txt',
    CURLOPT_USERPWD => 'user:pass',
    CURLOPT_RETURNTRANSFER => true
]);
$file = curl_exec($ch);
if ($file === false) {
    echo "FTP ошибка: " . curl_error($ch);
} else {
    file_put_contents('local.txt', $file);
    echo "Файл сохранён.";
}
curl_close($ch);

Результат: файл загружен с FTP-сервера, cURL-соединение закрыто.

7. Закрытие при использовании cURL с NTLM-аутентификацией

$ch = curl_init('https://private.example.com');
curl_setopt_array($ch, [
    CURLOPT_HTTPAUTH => CURLAUTH_NTLM,
    CURLOPT_USERPWD => 'domain\user:password',
    CURLOPT_RETURNTRANSFER => true
]);
$response = curl_exec($ch);
if (curl_errno($ch) === CURLE_OK) {
    echo "Успешно.";
} else {
    echo "Ошибка: " . curl_error($ch);
}
curl_close($ch);

Результат: вывод "Успешно." или описание ошибки.