Передача файлов из PHP: подходы и реализация

Расширенные примеры передачи файлов в PHP

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

Пример 1. Защищённое скачивание только для авторизованных пользователей

<?php
session_start();
if (!isset($_SESSION['user'])) {
    http_response_code(403);
    die('Доступ запрещён');
}
$file = 'private_data.zip';
if (!file_exists($file)) {
    http_response_code(404);
    die('Файл не найден');
}
header('Content-Type: application/zip');
header('Content-Disposition: attachment; filename="private_data.zip"');
header('Content-Length: ' . filesize($file));
readfile($file);
exit;
?>

Результат: скрипт проверяет сессию, и только при наличии авторизации отдаёт файл. В противном случае возвращается код 403.

Пример 2. Отдача файла из базы данных (BLOB)

Иногда файлы хранятся непосредственно в базе (например, в MySQL). Извлечение и отправка потребует чтения всего содержимого в память, что ограничивает размер.

<?php
$id = (int)$_GET['id'];
$pdo = new PDO('mysql:host=localhost;dbname=files', 'user', 'pass');
$stmt = $pdo->prepare('SELECT name, type, size, data FROM files WHERE id = ?');
$stmt->execute([$id]);
$file = $stmt->fetch(PDO::FETCH_ASSOC);
if (!$file) {
    http_response_code(404);
    exit;
}
header('Content-Type: ' . $file['type']);
header('Content-Disposition: attachment; filename="' . $file['name'] . '"');
header('Content-Length: ' . $file['size']);
echo $file['data'];    // данные из BLOB
?>

Для больших BLOB-полей лучше использовать потоки (например, PDO::ATTR_STRINGIFY_FETCHES не поможет). В таких случаях файл лучше хранить на диске, а в БД - путь.

Пример 3. Передача файла с использованием потокового фильтра

Можно передавать не исходный файл, а его обработанную версию, например, сжатый gzip на лету или с заменой строк.

<?php
$file = 'log.txt';
header('Content-Type: application/gzip');
header('Content-Disposition: attachment; filename="log.txt.gz"');

$handle = fopen($file, 'rb');
$gz = gzopen('php://output', 'wb9');
stream_copy_to_stream($handle, $gz);
gzclose($gz);
fclose($handle);
?>

В этом примере данные из файла log.txt сжимаются с помощью gzopen и сразу отправляются клиенту как gzip-архив без создания промежуточного файла.

Пример 4. Использование cURL для проксирования скачивания с удалённого сервера

Если файл находится на другом сервере, можно передавать его через PHP как посредника, не сохраняя локально.

<?php
$url = 'https://example.com/remote_file.mp4';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 0);    // сразу выводим
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);
// Можно передать заголовки от PHP (Content-Type, Content-Disposition) вручную
header('Content-Type: video/mp4');
header('Content-Disposition: attachment; filename="remote.mp4"');
curl_exec($ch);
curl_close($ch);
?>

Но в этом случае PHP не знает размер удалённого файла, поэтому Content-Length не указывается (браузер будет показывать прогресс не точно). Для большей точности можно сначала получить размер через curl_getinfo.

Пример 5. Передача файла с лимитом скорости

Для предотвращения захвата пропускной способности можно искусственно замедлить отправку, ограничивая размер чанка и добавляя задержки.

<?php
$file = 'bigfile.mp4';
$handle = fopen($file, 'rb');
$limit = 100 * 1024; // 100 КБ в секунду
header('Content-Type: video/mp4');
header('Content-Disposition: attachment; filename="bigfile.mp4"');
header('Content-Length: ' . filesize($file));
while (!feof($handle)) {
    echo fread($handle, $limit);
    ob_flush();
    flush();
    usleep(1000000); // 1 секунда
}
fclose($handle);
?>

Каждую секунду отправляется 100 КБ. Это лишь демонстрация; на практике используют более точные алгоритмы с учётом времени.

Пример 6. Отдача файла с кастомным Content-Type по расширению

<?php
$file = 'report.xlsx';
$mime_types = [
    'pdf' => 'application/pdf',
    'xlsx' => 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
    'zip' => 'application/zip',
];
$ext = pathinfo($file, PATHINFO_EXTENSION);
$mime = $mime_types[$ext] ?? 'application/octet-stream';
header('Content-Type: ' . $mime);
header('Content-Disposition: attachment; filename="' . basename($file) . '"');
header('Content-Length: ' . filesize($file));
readfile($file);
?>

Этот подход помогает браузеру правильно интерпретировать файл при открытии (например, Excel может открыть .xlsx напрямую). Без указания MIME-типа браузер скачает файл как неизвестный.