Веб-разработка: обработка пользовательских файлов в PHP

Расширенные примеры обработки файлов

Пример 1: Надёжная валидация MIME и размера

В этом примере используется finfo для определения реального типа файла, а также проверка на лимит размера и расширения. Код подходит для любых файлов.

<?php
$allowedMime = ['image/jpeg', 'image/png', 'application/pdf'];
$allowedExt = ['jpg', 'jpeg', 'png', 'pdf'];
$maxSize = 5 * 1024 * 1024; // 5 MB

if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_FILES['file'])) {
    $f = $_FILES['file'];
    if ($f['error'] !== UPLOAD_ERR_OK) {
        exit("Ошибка " . $f['error']);
    }
    
    // Проверка размера
    if ($f['size'] > $maxSize) {
        exit("Файл слишком большой");
    }
    
    // MIME-тип
    $finfo = finfo_open(FILEINFO_MIME_TYPE);
    $mime = finfo_file($finfo, $f['tmp_name']);
    finfo_close($finfo);
    if (!in_array($mime, $allowedMime)) {
        exit("Недопустимый MIME: $mime");
    }
    
    // Расширение из оригинального имени
    $ext = strtolower(pathinfo($f['name'], PATHINFO_EXTENSION));
    if (!in_array($ext, $allowedExt)) {
        exit("Недопустимое расширение: $ext");
    }
    
    // Успех
    echo "Файл прошёл валидацию. MIME: $mime, размер: " . $f['size'] . " байт";
}
?>

При загрузке файла example.jpg с правильным MIME image/jpeg:
Файл прошёл валидацию. MIME: image/jpeg, размер: 123456 байт

Пример 2: Безопасное сохранение с уникальным именем

Генерация имени на основе хеша содержимого, времени и случайной строки предотвращает конфликты и инъекции.

<?php
function generateSafeName(string $sourcePath, string $originalName): string {
    $hash = md5_file($sourcePath) . '_' . time() . '_' . random_int(1000, 9999);
    $ext = pathinfo($originalName, PATHINFO_EXTENSION);
    return $hash . '.' . $ext;
}

$destDir = __DIR__ . '/uploads/';
$safeName = generateSafeName($_FILES['file']['tmp_name'], $_FILES['file']['name']);
move_uploaded_file($_FILES['file']['tmp_name'], $destDir . $safeName);
echo "Сохранён как: $safeName";
?>

Сохранён как: a1b2c3d4e5f6_1712345678_7890.png

Пример 3: Автоматический ресайз изображения при загрузке

После загрузки изображения можно уменьшить его до заданных размеров с помощью GD.

<?php
$maxWidth = 800;
$maxHeight = 600;
$src = $_FILES['image']['tmp_name'];
$info = getimagesize($src);
if (!$info) exit("Не удалось получить размеры");

list($origW, $origH) = $info;
$ratio = min($maxWidth / $origW, $maxHeight / $origH);
$newW = (int)($origW * $ratio);
$newH = (int)($origH * $ratio);

$srcImage = imagecreatefromstring(file_get_contents($src));
$dstImage = imagecreatetruecolor($newW, $newH);
imagecopyresampled($dstImage, $srcImage, 0, 0, 0, 0, $newW, $newH, $origW, $origH);

$dest = __DIR__ . '/uploads/thumb_' . basename($_FILES['image']['name']);
imagejpeg($dstImage, $dest, 85);
imagedestroy($srcImage);
imagedestroy($dstImage);
echo "Создан эскиз: $dest";
?>

Создан эскиз: /var/www/uploads/thumb_photo.jpg
Размеры: 800x600 (при соотношении оригинала 4:3)

Пример 4: Пошаговая загрузка (chunked upload) больших файлов

Разделение файла на части, отправка через AJAX и сборка на сервере. Ниже - упрощённая реализация на PHP.

<?php
// chunk_upload.php
$chunkDir = __DIR__ . '/chunks/';
$fileName = $_POST['filename'] ?? 'unknown';
$chunkIndex = (int)($_POST['chunk'] ?? 0);
$totalChunks = (int)($_POST['totalChunks'] ?? 1);

$chunkPath = $chunkDir . $fileName . '.part' . $chunkIndex;
move_uploaded_file($_FILES['chunk']['tmp_name'], $chunkPath);

// Если это последний чанк - собираем файл
if ($chunkIndex === $totalChunks - 1) {
    $finalPath = __DIR__ . '/uploads/' . $fileName;
    $out = fopen($finalPath, 'wb');
    for ($i = 0; $i < $totalChunks; $i++) {
        $part = $chunkDir . $fileName . '.part' . $i;
        $in = fopen($part, 'rb');
        stream_copy_to_stream($in, $out);
        fclose($in);
        unlink($part);
    }
    fclose($out);
    echo json_encode(['status' => 'complete', 'path' => $finalPath]);
} else {
    echo json_encode(['status' => 'chunk_received', 'index' => $chunkIndex]);
}
?>

При отправке 3 чанков по 5 МБ:
{"status":"chunk_received","index":0}
{"status":"chunk_received","index":1}
{"status":"complete","path":"/uploads/video.mp4"}

Пример 5: Параллельная обработка нескольких файлов

Использование array_map для одновременного сохранения и валидации массива файлов из формы с multiple.

<?php
function processFile(array $file): string {
    if ($file['error'] !== UPLOAD_ERR_OK) {
        return "Ошибка: {$file['error']}";
    }
    $dest = __DIR__ . '/uploads/' . basename($file['name']);
    move_uploaded_file($file['tmp_name'], $dest);
    return "OK: {$file['name']}";
}

if (isset($_FILES['files'])) {
    $files = $_FILES['files'];
    $results = array_map(function($i) use ($files) {
        return processFile([
            'name'     => $files['name'][$i],
            'tmp_name' => $files['tmp_name'][$i],
            'error'    => $files['error'][$i],
            'size'     => $files['size'][$i]
        ]);
    }, array_keys($files['name']));
    echo implode("<br>", $results);
}
?>

OK: photo1.jpg
OK: document.pdf
Ошибка: 1 (UPLOAD_ERR_INI_SIZE) для file3.zip