Способы вывода файлов в PHP скриптах

Продвинутые сценарии вывода файлов

Пример 1: Динамическое определение MIME типа с помощью finfo

Вместо жёстко заданного Content-Type тип файла определяется автоматически с помощью расширения Fileinfo.

<?php
$file = 'upload/sample.png';
$finfo = finfo_open(FILEINFO_MIME_TYPE);
$mimeType = finfo_file($finfo, $file);
finfo_close($finfo);
header('Content-Type: ' . $mimeType);
header('Content-Length: ' . filesize($file));
readfile($file);
?>

Результат: браузер получает заголовок Content-Type: image/png и корректно отображает PNG изображение. Если файл был JPEG, будет соответственно image/jpeg. Такой подход универсален для любого типа файла.

Пример 2: Защищённая передача файла с проверкой прав через хеш и лимит времени

Файл доступен только определённое время или для определённого пользователя с помощью временного токена.

<?php
$secret = 'мой_секрет';
$file = '/protected/report.pdf';
$expires = time() + 3600; // ссылка живёт 1 час
$token = md5($secret . $file . $expires);
$link = "download.php?file=" . urlencode($file) . "&expires=$expires&token=$token";
echo "Временная ссылка: <a href='$link'>Скачать</a>";
?>

На странице download.php производится проверка:

<?php
$secret = 'мой_секрет';
$file = $_GET['file'] ?? '';
$expires = (int)($_GET['expires'] ?? 0);
$token = $_GET['token'] ?? '';
if (time() > $expires) {
    die('Срок ссылки истёк.');
}
if (md5($secret . $file . $expires) !== $token) {
    die('Неверный токен.');
}
if (!file_exists($file)) {
    http_response_code(404);
    die('Файл не найден.');
}
header('Content-Type: ' . mime_content_type($file));
header('Content-Disposition: attachment; filename="' . basename($file) . '"');
header('Content-Length: ' . filesize($file));
readfile($file);
exit;
?>

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

Пример 3: Чтение и вывод большого файла частями (chunked output) без использования readfile

Для очень больших файлов (несколько гигабайт) применяется собственный механизм чтения с контролем памяти.

<?php
$file = '/backup/big.iso';
$chunkSize = 1024 * 1024; // 1 MB
$handle = fopen($file, 'rb');
if (!$handle) {
    die('Не удалось открыть файл.');
}
header('Content-Type: application/octet-stream');
header('Content-Length: ' . filesize($file));
header('Content-Disposition: attachment; filename="big.iso"');
while (!feof($handle)) {
    $chunk = fread($handle, $chunkSize);
    if ($chunk === false) break;
    echo $chunk;
    ob_flush();
    flush();
}
fclose($handle);
exit;
?>

Результат: файл передаётся порциями по 1 МБ, что позволяет отдавать файлы любого размера без превышения лимита памяти PHP. Следует отметить, что readfile внутренне делает то же самое, но в некоторых случаях требуется тонкая настройка.

Пример 4: Вывод изображения с наложенным водяным знаком (GD)

PHP динамически генерирует изображение, накладывая водяной знак на фотографию.

<?php
$source = 'photo.jpg';
$stamp = 'watermark.png';
$im = imagecreatefromjpeg($source);
$stampIm = imagecreatefrompng($stamp);
if (!$im || !$stampIm) {
    die('Ошибка загрузки изображений.');
}
$sx = imagesx($stampIm);
$sy = imagesy($stampIm);
imagecopy($im, $stampIm, imagesx($im) - $sx - 10, imagesy($im) - $sy - 10, 0, 0, $sx, $sy);
header('Content-Type: image/jpeg');
imagejpeg($im, null, 90);
imagedestroy($im);
imagedestroy($stampIm);
?>

Результат: браузер получает JPEG изображение с водяным знаком в правом нижнем углу. Качество установлено 90. Для PNG используется imagepng().

Пример 5: Рекурсивный список файлов с вложенными папками и размерами

Использование RecursiveDirectoryIterator для обхода дерева каталогов.

<?php
$dir = new RecursiveDirectoryIterator('./projects');
$iterator = new RecursiveIteratorIterator($dir, RecursiveIteratorIterator::SELF_FIRST);
echo '<table border="1">';
foreach ($iterator as $fileinfo) {
    if ($fileinfo->isFile()) {
        echo '<tr><td>' . htmlspecialchars($fileinfo->getPathname()) . '</td><td>' . $fileinfo->getSize() . ' байт</td></tr>';
    }
}
echo '</table>';
?>

Результат: HTML-таблица со всеми файлами (рекурсивно) из папки projects и их размерами. Для папки с сотнями файлов следует добавлять кэширование или лимит.

Пример 6: Отдача файла с поддержкой докачки (Range запросы)

Поддержка HTTP Range заголовков позволяет возобновлять прерванную загрузку. Это сложный, но полезный сценарий.

<?php
$file = '/video/tutorial.mp4';
$handle = fopen($file, 'rb');
if (!$handle) {
    header('HTTP/1.1 500 Internal Server Error');
    exit;
}
$fileSize = filesize($file);
$range = $_SERVER['HTTP_RANGE'] ?? null;
if ($range) {
    preg_match('/bytes=(\d+)-(\d*)/', $range, $matches);
    $start = (int)$matches[1];
    $end = $matches[2] === '' ? $fileSize - 1 : (int)$matches[2];
    header('HTTP/1.1 206 Partial Content');
    header("Content-Range: bytes $start-$end/$fileSize");
    header('Content-Length: ' . ($end - $start + 1));
    fseek($handle, $start);
    while ($start <= $end) {
        $chunk = fread($handle, 8192);
        echo $chunk;
        $start += strlen($chunk);
        flush();
    }
} else {
    header('HTTP/1.1 200 OK');
    header('Content-Length: ' . $fileSize);
    header('Content-Type: video/mp4');
    readfile($file);
}
fclose($handle);
exit;
?>

Результат: при обычном запросе видео передаётся целиком; при запросе с заголовком Range (например, после паузы) сервер отдаёт только запрошенный диапазон, что позволяет возобновить скачивание.

Пример 7: Отображение содержимого файла в защищённой папке с помощью файлового сервера

Все файлы хранятся вне document root, доступ только через PHP.

<?php
$safeBase = dirname(__DIR__) . '/private_files/';
$filename = basename($_GET['file']); // очищаем от путей
$fullPath = $safeBase . $filename;
if (!file_exists($fullPath)) {
    http_response_code(404);
    exit;
}
// Дополнительно можно проверить права пользователя
header('Content-Type: ' . mime_content_type($fullPath));
header('Content-Length: ' . filesize($fullPath));
readfile($fullPath);
?>

Результат: пользователь может скачать файл, только если знает точное имя и имеет доступ. Директория private_files недоступна через веб-сервер напрямую.