Отправка и получение файлов с помощью cURL в PHP

Расширенные примеры работы с файлами через cURL

Пример 1. Загрузка файла с индикатором прогресса

Функция CURLOPT_PROGRESSFUNCTION позволяет отслеживать передачу данных. Пример для отправки большого файла:

$file = new CURLFile('video.mp4', 'video/mp4');
$ch = curl_init('https://upload.endpoint');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, ['file' => $file]);
curl_setopt($ch, CURLOPT_NOPROGRESS, false);
curl_setopt($ch, CURLOPT_PROGRESSFUNCTION, function($ch, $downloadSize, $downloaded, $uploadSize, $uploaded) {
    if ($uploadSize > 0) {
        echo "Передано: " . round($uploaded / $uploadSize * 100, 2) . "%\n";
    }
});
curl_exec($ch);
curl_close($ch);

Результат: в консоли выводятся проценты загрузки. Важно: функция вызываеться часто, не рекомендуется использовать ресурсоёмкие операции.

Пример 2. Множественная загрузка файлов с помощью curl_multi

Асинхронная отправка нескольких файлов повышает скорость. Используем curl_multi_init():

$files = [
    'doc1.pdf' => ['path' => '/tmp/doc1.pdf', 'mime' => 'application/pdf'],
    'img.png'  => ['path' => '/tmp/img.png', 'mime' => 'image/png'],
];
$mh = curl_multi_init();
$handles = [];
foreach ($files as $name => $info) {
    $ch = curl_init('https://api.example.com/upload');
    $file = new CURLFile($info['path'], $info['mime'], $name);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, ['file' => $file]);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_multi_add_handle($mh, $ch);
    $handles[] = $ch;
}
$running = null;
do {
    curl_multi_exec($mh, $running);
    curl_multi_select($mh);
} while ($running > 0);
foreach ($handles as $ch) {
    echo curl_multi_getcontent($ch) . "\n";
    curl_multi_remove_handle($mh, $ch);
    curl_close($ch);
}
curl_multi_close($mh);

Результат: ответ сервера для каждого файла выводится на экран. curl_multi работает асинхронно, но блокируется на curl_multi_select.

Пример 3. Отправка файла через FTP с cURL

cURL поддерживает протокол FTP. Загрузка файла на FTP-сервер:

$ch = curl_init('ftp://user:password@ftp.example.com/remote/file.pdf');
$fp = fopen('/local/file.pdf', 'rb');
curl_setopt($ch, CURLOPT_UPLOAD, true);
curl_setopt($ch, CURLOPT_INFILE, $fp);
curl_setopt($ch, CURLOPT_INFILESIZE, filesize('/local/file.pdf'));
curl_exec($ch);
fclose($fp);
curl_close($ch);

Для пассивного режима добавить CURLOPT_FTP_USE_EPSV, true. При ошибке авторизации проверить логин/пароль в URL.

Пример 4. Получение файла с сервера и сохранение с именем из заголовков

Некоторые серверы возвращают имя файла в заголовке Content-Disposition. Извлечение:

$ch = curl_init('https://example.com/download.php?id=123');
curl_setopt($ch, CURLOPT_HEADER, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$headerSize = curl_getinfo($ch, CURLINFO_HEADER_SIZE);
$header = substr($response, 0, $headerSize);
$body = substr($response, $headerSize);
// Парсим Content-Disposition
preg_match('/Content-Disposition:.*?filename="(.+?)"/', $header, $matches);
$filename = $matches[1] ?? 'downloaded_file';
file_put_contents($filename, $body);
curl_close($ch);

Результат: файл сохраняется с оригинальным именем. Обратите внимание на экранирование кавычек в регулярном выражении.

Пример 5. Отправка файла через PUT-запрос (простой)

PUT-метод часто используется для обновления ресурса. Пример с чтением потока:

$ch = curl_init('https://api.example.com/files/123');
$fp = fopen('new_data.bin', 'rb');
curl_setopt($ch, CURLOPT_PUT, true);
curl_setopt($ch, CURLOPT_INFILE, $fp);
curl_setopt($ch, CURLOPT_INFILESIZE, filesize('new_data.bin'));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
fclose($fp);
curl_close($ch);
echo $response;

Результат – ответ сервера (например, статус 200/201).

Пример 6. Скачивание файла с игнорированием SSL-ошибок (не рекомендуется)

Для тестовых серверов можно отключить проверку SSL:

curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);

Результат: соединение происходит без проверки сертификата. В продукции обязательно настроить CURLOPT_CAINFO.

Пример 7. Отправка файла с использованием CURLOPT_READFUNCTION

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

$ch = curl_init('https://api.example.com/upload');
$data = 'some binary content'; // допустим, 1 МБ
$size = strlen($data);
$offset = 0;
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_READFUNCTION, function($ch, $stream, &$maxlen) use ($data, $size, &$offset) {
    $remaining = $size - $offset;
    $chunk = min($remaining, $maxlen);
    $result = substr($data, $offset, $chunk);
    $offset += $chunk;
    return $result;
});
curl_setopt($ch, CURLOPT_INFILESIZE, $size);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Результат: данные передаются без копирования в файл. Полезно для больших объёмов, когда содержимое генерируется на лету.