Организация загрузки файлов через PHP: от простого к сложному

$file = 'document.pdf';
$filename = basename($file);
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="' . $filename . '"');
header('Content-Length: ' . filesize($file));
readfile($file);
exit;

Пофрагментная отправка через fopen/fread

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

Файл открывается через fopen() и читается блоками фиксированного размера. Каждый блок сразу отправляется в вывод. Это экономит память сервера.

$file = 'bigfile.zip';
$size = filesize($file);
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="' . basename($file) . '"');
header('Content-Length: ' . $size);

$handle = fopen($file, 'rb');
while (!feof($handle)) {
    echo fread($handle, 8192);
    ob_flush();
    flush();
}
fclose($handle);
exit;

Php download file (скачивание файлов через php)

Размер блока (8 КБ) можно менять. Команды ob_flush() и flush() обеспечивают немедленную отправку данных клиенту.

Поддержка HTTP Range (докачка и частичная загрузка)

Как реализовать возможность докачать файл с прерванной загрузки или начать воспроизведение видео с произвольного места?

Многие менеджеры загрузок и видеоплееры отправляют запрос с заголовком Range. Скрипт должен обработать этот заголовок, установить статус 206 Partial Content и выдать только запрошенный диапазон.

$file = 'movie.mp4';
$size = filesize($file);
$etag = md5_file($file);
header('Accept-Ranges: bytes');
header('ETag: "' . $etag . '"');

if (isset($_SERVER['HTTP_RANGE'])) {
    preg_match('/bytes=(\d+)-(\d*)/', $_SERVER['HTTP_RANGE'], $matches);
    $start = intval($matches[1]);
    $end = $matches[2] === '' ? $size - 1 : intval($matches[2]);
    header('HTTP/1.1 206 Partial Content');
    header('Content-Range: bytes ' . $start . '-' . $end . '/' . $size);
    header('Content-Length: ' . ($end - $start + 1));
    $handle = fopen($file, 'rb');
    fseek($handle, $start);
    while ($pos = ftell($handle), $pos <= $end) {
        $length = min(8192, $end - $pos + 1);
        echo fread($handle, $length);
        ob_flush(); flush();
    }
    fclose($handle);
} else {
    header('Content-Length: ' . $size);
    readfile($file);
}
exit;

Проблемы: неправильный парсинг диапазона, ошибки с индексацией при пустом конце. Необходимо также поддерживать множественные диапазоны (multipart), что сложнее.

Скачивание удалённого файла через cURL

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

Можно использовать cURL для получения файла и одновременно отправлять его браузеру. Это называют «прозрачным проксированием».

$url = 'https://example.com/remote.zip';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, false);
curl_setopt($ch, CURLOPT_HEADER, false);
// передаём заголовки дальше? можно анализировать Content-Type
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="remote.zip"');
curl_exec($ch);
curl_close($ch);
exit;

Этот метод не использует дополнительную память на сервере, но зависит от скорости внешнего канала.

Ограничение скорости загрузки

Как отдавать файл с заранее заданной скоростью, чтобы не перегружать канал?

В цикле пофрагментной отправки вставляется пауза через usleep(). Размер блока и задержка определяют скорость.

$chunk = 1024;  // 1 КБ
$delay = 100000; // 0.1 сек
$file = 'file.bin';
$handle = fopen($file, 'rb');
header('...');
while (!feof($handle)) {
    echo fread($handle, $chunk);
    ob_flush(); flush();
    usleep($delay);
}
fclose($handle);
exit;

Скорость = $chunk / ($delay / 1 000 000) байт/с. При $chunk = 1024 и $delay = 100000 скорость ~10 КБ/с.

Использование X-Sendfile

Как передать файл через веб-сервер, минуя PHP, для максимальной производительности?

Модули mod_xsendfile (Apache) или X-Accel-Redirect (Nginx) позволяют PHP только указать путь к файлу, а сервер сам отдаёт его с правильными заголовками. Необходим соответствующий модуль и настройка.

header('X-Sendfile: /path/to/protected/file.zip');
header('Content-Type: application/zip');
header('Content-Disposition: attachment; filename="file.zip"');
exit;

Преимущества: скорость, низкая нагрузка на PHP. Проблемы: неправильная настройка разрешений (файл должен быть доступен для чтения веб-серверу), отсутствие поддержки на некоторых хостингах.

Скачивание с авторизацией

Как отдавать файл только после проверки прав пользователя?

Перед отправкой файла выполняется проверка сессии, cookies или токена. Если доступ запрещён, возвращается 403 ошибка.

session_start();
if (!isset($_SESSION['user'])) {
    http_response_code(403);
    echo 'Доступ запрещён';
    exit;
}
$file = 'secret.doc';
if (!file_exists($file)) {
    http_response_code(404);
    exit;
}
// далее стандартный readfile
header('Content-Type: ...');
header('Content-Disposition: ...');
readfile($file);
exit;

Сжатие перед отправкой

Как автоматически сжать файл (gzip) при скачивании для уменьшения трафика?

Текстовые файлы можно сжимать «на лету» с помощью ob_gzhandler или gzencode. Важно выставить заголовок Content-Encoding: gzip.

$file = 'large_log.txt';
$data = file_get_contents($file);
$compressed = gzencode($data, 9);
header('Content-Type: text/plain');
header('Content-Disposition: attachment; filename="large_log.txt.gz"');
header('Content-Encoding: gzip');
header('Content-Length: ' . strlen($compressed));
echo $compressed;
exit;

Не подходит для уже сжатых файлов (zip, jpg).

Создание временного архива и его скачивание

Как собрать несколько файлов в ZIP-архив и сразу отдать пользователю без сохранения на диске?

Используется класс ZipArchive с потоком вывода (php://output).

$zip = new ZipArchive();
$zipName = 'archive.zip';
if ($zip->open($zipName, ZipArchive::CREATE) !== true) {
    exit('Не удалось создать архив');
}
$zip->addFile('file1.txt');
$zip->addFile('file2.txt');
$zip->close();

header('Content-Type: application/zip');
header('Content-Disposition: attachment; filename="' . $zipName . '"');
header('Content-Length: ' . filesize($zipName));
readfile($zipName);
unlink($zipName);
exit;
// Альтернатива: создать временный файл и удалить после отправки