PHP и cURL: настройка таймаутов

Дополнительные практические примеры с более сложными сценариями использования таймаутов.

Пример 1: Комбинированный таймаут с обработкой ошибок и повторным запросом

function fetchUrlWithRetry($url, $timeout = 10, $retries = 3) {
    $attempt = 0;
    while ($attempt < $retries) {
        $ch = curl_init($url);
        curl_setopt_array($ch, [
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_CONNECTTIMEOUT => $timeout,
            CURLOPT_TIMEOUT        => $timeout,
            CURLOPT_FOLLOWLOCATION => true,
            CURLOPT_MAXREDIRS      => 5,
        ]);
        $result = curl_exec($ch);
        $errno = curl_errno($ch);
        $error = curl_error($ch);
        curl_close($ch);

        if ($errno === CURLE_OPERATION_TIMEDOUT) {
            $attempt++;
            if ($attempt < $retries) {
                sleep(1); // пауза перед повторной попыткой
                continue;
            }
            return ['error' => 'Таймаут после ' . $retries . ' попыток'];
        }
        if ($errno) {
            return ['error' => 'Ошибка cURL: ' . $error];
        }
        return ['data' => $result];
    }
}

$result = fetchUrlWithRetry('https://slow.example.com', 5, 3);
print_r($result);

Array
(
    [data] => (или [error] => Таймаут после 3 попыток)
)

Пример 2: Использование таймаута в миллисекундах и проверка поддержки

$ch = curl_init('https://httpbin.org/delay/3');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT_MS => 1000,
    CURLOPT_TIMEOUT_MS => 1500,
]);
$start = microtime(true);
$result = curl_exec($ch);
$time = (microtime(true) - $start) * 1000;
$errno = curl_errno($ch);
curl_close($ch);

echo 'Время выполнения: ' . round($time, 0) . ' ms\n';
echo 'Код ошибки: ' . $errno;
echo ($errno === CURLE_OPERATION_TIMEDOUT) ? ' - Таймаут' : ' - Успех';

Время выполнения: 1520 ms
Код ошибки: 28 - Таймаут

Пример 3: Таймаут в асинхронных запросах (curl_multi)

$urls = ['https://example.com', 'https://httpbin.org/delay/2', 'https://google.com'];
$mh = curl_multi_init();
$handles = [];
foreach ($urls as $i => $url) {
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 3,
        CURLOPT_CONNECTTIMEOUT => 2,
    ]);
    curl_multi_add_handle($mh, $ch);
    $handles[$i] = $ch;
}
$active = null;
do {
    $status = curl_multi_exec($mh, $active);
} while ($status === CURLM_CALL_MULTI_PERFORM || $active);

foreach ($handles as $i => $ch) {
    $error = curl_error($ch);
    $data = curl_multi_getcontent($ch);
    echo "$i: " . ($error ?: 'OK') . "\n";
    curl_multi_remove_handle($mh, $ch);
    curl_close($ch);
}
curl_multi_close($mh);

0: OK
1: Operation timed out after 3000 milliseconds with 0 bytes received
2: OK

Пример 4: Загрузка файла с таймаутом и прогрессом

$url = 'https://speed.hetzner.de/100MB.bin';
$ch = curl_init($url);
$fp = fopen('/dev/null', 'w');
curl_setopt_array($ch, [
    CURLOPT_FILE => $fp,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_CONNECTTIMEOUT => 5,
    CURLOPT_NOPROGRESS => false,
    CURLOPT_PROGRESSFUNCTION => function($ch, $dltotal, $dlnow) {
        static $last = 0;
        if (time() - $last > 2) {
            echo 'Progress: ' . round($dlnow / $dltotal * 100, 2) . "%\n";
            $last = time();
        }
    },
]);
$start = microtime(true);
curl_exec($ch);
$time = microtime(true) - $start;
$errno = curl_errno($ch);
curl_close($ch);
fclose($fp);
echo 'Завершено за ' . round($time, 2) . ' сек, код: ' . $errno;

Progress: 12.5%
Progress: 38.2%
Operation timed out after 10000 milliseconds with 0 bytes received
Завершено за 10.01 сек, код: 28