Как загружать файлы с помощью cURL в PHP: от новичка до продвинутых техник

Загрузка файла с указанием пользовательского MIME-типа

Как явно задать MIME-тип, если автоматическое определение неверно?

Передайте второй параметр в конструктор CURLFile или в curl_file_create. MIME-тип будет отправлен в заголовке Content-Type соответствующей части multipart.

<?php
$cfile = new CURLFile('/tmp/archive.bin', 'application/octet-stream', 'archive.bin');
?>
  

Загрузка файла через PUT-запрос

Как отправить файл методом PUT, а не POST?

Используйте CURLOPT_PUT или установите CURLOPT_CUSTOMREQUEST = 'PUT' вместе с опциями для чтения из файла.

<?php
$url = 'https://example.com/upload/archive.zip';
$filePath = '/tmp/archive.zip';
$fp = fopen($filePath, 'rb');

$curl = curl_init($url);
curl_setopt_array($curl, [
    CURLOPT_PUT => true,
    CURLOPT_INFILE => $fp,
    CURLOPT_INFILESIZE => filesize($filePath),
    CURLOPT_RETURNTRANSFER => true
]);
$response = curl_exec($curl);
fclose($fp);
curl_close($curl);
echo $response;
?>
  

Этот метод передаёт файл в теле запроса без multipart-обрамления. Удобно, когда сервер ожидает прямой поток байтов.

Потоковая загрузка большого файла с использованием CURLOPT_READFUNCTION

Как загрузить очень большой файл без загрузки его целиком в память?

Установите пользовательскую функцию чтения через CURLOPT_READFUNCTION. Она будет вызываться cURL для получения данных кусками. Это эффективно для файлов, превышающих лимит памяти.

<?php
$filePath = '/tmp/huge_file.iso';
$fp = fopen($filePath, 'rb');

$curl = curl_init('https://example.com/upload/huge_file.iso');
curl_setopt_array($curl, [
    CURLOPT_PUT => true,
    CURLOPT_INFILESIZE => filesize($filePath),
    CURLOPT_READFUNCTION => function ($ch, $fd, $length) use ($fp) {
        return fread($fp, $length);
    },
    CURLOPT_RETURNTRANSFER => true
]);
$response = curl_exec($curl);
fclose($fp);
curl_close($curl);
?>
  

Важно: не забудьте закрыть файловый дескриптор после завершения.

Параллельная загрузка нескольких файлов через curl_multi

Как ускорить отправку многих файлов, используя параллельные запросы?

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

<?php
$url = 'https://example.com/upload.php';
$files = ['photo1.jpg', 'photo2.jpg', 'photo3.jpg']; // пути к файлам

$multiHandle = curl_multi_init();
$curlHandles = [];

foreach ($files as $index => $filePath) {
    $ch = curl_init($url);
    $cfile = new CURLFile($filePath);
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => ['file_' . $index => $cfile],
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 30
    ]);
    curl_multi_add_handle($multiHandle, $ch);
    $curlHandles[] = $ch;
}

$running = null;
do {
    $status = curl_multi_exec($multiHandle, $running);
    curl_multi_select($multiHandle); // ожидание активности
} while ($running > 0);

foreach ($curlHandles as $ch) {
    $response = curl_multi_getcontent($ch);
    $error = curl_error($ch);
    // обработка результата
    curl_multi_remove_handle($multiHandle, $ch);
    curl_close($ch);
}
curl_multi_close($multiHandle);
?>
  

Загрузка файла с авторизацией через заголовки

Как отправить файл на защищённый эндпоинт, требующий Bearer токен или Basic Auth?

Добавьте заголовки через CURLOPT_HTTPHEADER. Для Bearer токена:

<?php
$curl = curl_init('https://api.example.com/upload');
$cfile = new CURLFile('/tmp/report.pdf', 'application/pdf', 'report.pdf');
curl_setopt_array($curl, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => ['file' => $cfile],
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_ACCESS_TOKEN',
        'X-Requested-With: XMLHttpRequest'
    ],
    CURLOPT_RETURNTRANSFER => true
]);
$response = curl_exec($curl);
curl_close($curl);
?>
  

Для Basic Auth используйте CURLOPT_USERPWD:

curl_setopt($curl, CURLOPT_USERPWD, 'username:password');
  

Обработка ответа сервера и чтение заголовков

Как получить не только тело ответа, но и заголовки?

Включите опцию CURLOPT_HEADER = true и разделите полученный ответ по границе "\r\n\r\n". Альтернативно используйте CURLOPT_HEADERFUNCTION для построчной обработки.

<?php
$curl = curl_init('https://example.com/upload.php');
$cfile = new CURLFile('/tmp/test.txt');
curl_setopt_array($curl, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => ['file' => $cfile],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HEADER => true
]);
$response = curl_exec($curl);
$headerSize = curl_getinfo($curl, CURLINFO_HEADER_SIZE);
$header = substr($response, 0, $headerSize);
$body = substr($response, $headerSize);
echo 'Header: ' . $header;
echo 'Body: ' . $body;
?>
  

Загрузка файла с использованием прокси

Как отправить файл через HTTP/HTTPS прокси?

Укажите опции CURLOPT_PROXY, CURLOPT_PROXYPORT и при необходимости CURLOPT_PROXYUSERPWD.

<?php
$curl = curl_init('https://example.com/upload.php');
$cfile = new CURLFile('/tmp/file.zip');
curl_setopt_array($curl, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => ['file' => $cfile],
    CURLOPT_PROXY => '192.168.1.100',
    CURLOPT_PROXYPORT => 3128,
    CURLOPT_PROXYUSERPWD => 'user:pass',
    CURLOPT_RETURNTRANSFER => true
]);
$response = curl_exec($curl);
curl_close($curl);
?>