Загрузка файлов на сервер: PHP-решения и практические советы

Продвинутые примеры загрузки файлов на PHP

Пример 1. Класс для безопасной загрузки с валидацией

class FileUploader {
    private $uploadDir;
    private $allowedMime = ['image/jpeg', 'image/png', 'application/pdf'];
    private $maxSize = 10 * 1024 * 1024; // 10 MB

    public function __construct($uploadDir) {
        $this->uploadDir = rtrim($uploadDir, '/') . '/';
        if (!is_dir($this->uploadDir)) {
            mkdir($this->uploadDir, 0755, true);
        }
    }

    public function upload($fileKey) {
        if (!isset($_FILES[$fileKey]) || $_FILES[$fileKey]['error'] !== UPLOAD_ERR_OK) {
            throw new Exception('Ошибка загрузки файла');
        }
        $file = $_FILES[$fileKey];
        if ($file['size'] > $this->maxSize) {
            throw new Exception('Превышен максимальный размер');
        }
        $mime = (new finfo(FILEINFO_MIME_TYPE))->file($file['tmp_name']);
        if (!in_array($mime, $this->allowedMime)) {
            throw new Exception('Недопустимый тип файла');
        }
        $ext = pathinfo($file['name'], PATHINFO_EXTENSION);
        $newName = bin2hex(random_bytes(16)) . '.' . $ext;
        $dest = $this->uploadDir . $newName;
        if (move_uploaded_file($file['tmp_name'], $dest)) {
            return $newName;
        }
        throw new Exception('Не удалось сохранить файл');
    }
}
// Использование
$uploader = new FileUploader(__DIR__ . '/uploads');
try {
    $name = $uploader->upload('file');
    echo 'Файл ' . htmlspecialchars($name) . ' загружен';
} catch (Exception $e) {
    echo 'Ошибка: ' . $e->getMessage();
}

Файл a1b2c3d4e5f6g7h8.jpg загружен

Пример 2. Загрузка файла с помощью cURL (имитация отправки формы)

$ch = curl_init('https://example.com/upload.php');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => [
        'file' => new CURLFile('/path/to/local/file.pdf', 'application/pdf', 'document.pdf')
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Файл загружен успешно

Пример 3. Загрузка большого файла по частям (chunked upload)

На стороне клиента файл делится на куски (например, по 1 MB), каждый кусок отправляется отдельным запросом. Сервер собирает куски в один файл.

// JavaScript (упрощенно)
const chunkSize = 1 * 1024 * 1024;
let offset = 0;
const file = fileInput.files[0];
const totalChunks = Math.ceil(file.size / chunkSize);

function uploadChunk(chunkIndex) {
    const start = chunkIndex * chunkSize;
    const end = Math.min(start + chunkSize, file.size);
    const blob = file.slice(start, end);
    const formData = new FormData();
    formData.append('chunk', blob);
    formData.append('fileName', file.name);
    formData.append('chunkIndex', chunkIndex);
    formData.append('totalChunks', totalChunks);

    fetch('upload_chunk.php', { method: 'POST', body: formData })
        .then(r => r.text())
        .then(msg => {
            if (chunkIndex + 1 < totalChunks) {
                uploadChunk(chunkIndex + 1);
            } else {
                alert('Загрузка завершена');
            }
        });
}
uploadChunk(0);

// upload_chunk.php
$fileName = $_POST['fileName'];
$chunkIndex = (int)$_POST['chunkIndex'];
$totalChunks = (int)$_POST['totalChunks'];
$uploadDir = __DIR__ . '/uploads/';
$tempFile = $uploadDir . $fileName . '.part';

file_put_contents($tempFile, file_get_contents($_FILES['chunk']['tmp_name']), FILE_APPEND);

if ($chunkIndex === $totalChunks - 1) {
    rename($tempFile, $uploadDir . $fileName);
    echo 'Файл собран';
} else {
    echo 'Час' . $chunkIndex . ' получен';
}

Час0 получен
Час1 получен
...
Файл собран

Пример 4. Использование компонента Symfony HttpFoundation для загрузки

use Symfony\Component\HttpFoundation\File\UploadedFile;
use Symfony\Component\HttpFoundation\Request;

$request = Request::createFromGlobals();
/** @var UploadedFile $uploadedFile */
$uploadedFile = $request->files->get('file');
if ($uploadedFile) {
    $newName = $uploadedFile->move($uploadDir, uniqid() . '.' . $uploadedFile->guessExtension());
    echo $newName->getPathname();
}

/var/www/uploads/5f2a1b8c4d.jpg