Управление документами пользователей в PHP: от загрузки до выдачи

Расширенные примеры работы с документами пользователя

Пример 1: Полный класс UserDocument с методами upload, delete, serve

Реализация включает все типичные операции. Обратите внимание на обработку ошибок и логирование.

class UserDocument {
    private PDO $pdo;
    private string $storagePath;
    private int $userId;

    public function __construct(PDO $pdo, string $storagePath, int $userId) {
        $this->pdo = $pdo;
        $this->storagePath = rtrim($storagePath, '/');
        $this->userId = $userId;
    }

    public function upload(array $file, array $allowedMimes = ['application/pdf'], int $maxSize = 10485760): ?int {
        if ($file['error'] !== UPLOAD_ERR_OK) {
            throw new RuntimeException('Upload error code: ' . $file['error']);
        }
        $finfo = new finfo(FILEINFO_MIME_TYPE);
        $mime = $finfo->file($file['tmp_name']);
        if (!in_array($mime, $allowedMimes, true)) {
            throw new UnexpectedValueException('MIME type ' . $mime . ' not allowed');
        }
        if ($file['size'] > $maxSize) {
            throw new RangeException('File size ' . $file['size'] . ' exceeds limit ' . $maxSize);
        }
        $ext = pathinfo($file['name'], PATHINFO_EXTENSION);
        $newName = bin2hex(random_bytes(16)) . '.' . $ext;
        $dest = $this->storagePath . '/' . $newName;
        if (!move_uploaded_file($file['tmp_name'], $dest)) {
            throw new RuntimeException('Failed to move uploaded file');
        }
        $sql = 'INSERT INTO user_documents (user_id, original_name, filename, mime_type, size, storage_path, created_at) VALUES (?, ?, ?, ?, ?, ?, NOW())';
        $stmt = $this->pdo->prepare($sql);
        $stmt->execute([$this->userId, $file['name'], $newName, $mime, $file['size'], $dest]);
        return (int) $this->pdo->lastInsertId();
    }

    public function delete(int $documentId): bool {
        $stmt = $this->pdo->prepare('SELECT storage_path FROM user_documents WHERE id = ? AND user_id = ?');
        $stmt->execute([$documentId, $this->userId]);
        $row = $stmt->fetch(PDO::FETCH_ASSOC);
        if (!$row) {
            return false;
        }
        if (file_exists($row['storage_path'])) {
            unlink($row['storage_path']);
        }
        $stmt = $this->pdo->prepare('DELETE FROM user_documents WHERE id = ?');
        return $stmt->execute([$documentId]);
    }

    public function serve(int $documentId): void {
        $stmt = $this->pdo->prepare('SELECT * FROM user_documents WHERE id = ? AND user_id = ?');
        $stmt->execute([$documentId, $this->userId]);
        $doc = $stmt->fetch(PDO::FETCH_ASSOC);
        if (!$doc) {
            http_response_code(404);
            echo 'Document not found';
            return;
        }
        header('Content-Type: ' . $doc['mime_type']);
        header('Content-Disposition: filename="' . basename($doc['original_name']) . '"');
        header('Content-Length: ' . $doc['size']);
        readfile($doc['storage_path']);
    }

    // Additional methods: getList(), getById() etc.
}

Результат работы метода upload при успешной загрузке (например, через отладку):

int(42) // идентификатор записи о документе в таблице user_documents

Пример 2: Работа с изображениями – автоматическое создание миниатюры

Используя библиотеку GD или Intervention Image, можно после загрузки создавать уменьшенную копию документа (например, для аватарок).

// после успешной загрузки файла
$image = new \Intervention\Image\ImageManager(/* driver */);
$img = $image->make($destination);
$thumbnailPath = dirname($destination) . '/thumb_' . $newName;
$img->resize(150, 150)->save($thumbnailPath);

// сохраняем путь к оригиналу и миниатюре в БД
$sql = 'INSERT INTO user_documents (user_id, original_name, filename, mime_type, size, storage_path, thumbnail_path) VALUES (?, ?, ?, ?, ?, ?, ?)';

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

Пример 3: Загрузка документов из base64 (API, мобильные клиенты)

Иногда документы приходят в формате base64. Обработка такого варианта:

$base64 = 'data:application/pdf;base64,JVBERi0xLjQK...';
$data = explode(',', $base64)[1];
$decoded = base64_decode($data, true);
if ($decoded === false) {
    throw new InvalidArgumentException('Invalid base64 data');
}
$tmpPath = sys_get_temp_dir() . '/' . uniqid('upload_', true) . '.tmp';
file_put_contents($tmpPath, $decoded);
$file = [
    'name'     => 'document_from_api.pdf',
    'type'     => 'application/pdf',
    'tmp_name' => $tmpPath,
    'error'    => UPLOAD_ERR_OK,
    'size'     => strlen($decoded),
];
$docId = $uploader->upload($file);
unlink($tmpPath); // удаляем временный файл

Такой код полезен при интеграции с внешними сервисами или для загрузки через REST API.

Пример 4: Вывод списка документов пользователя с ссылками на скачивание

$stmt = $pdo->prepare('SELECT id, original_name, mime_type, size, created_at FROM user_documents WHERE user_id = ?');
$stmt->execute([$userId]);
$documents = $stmt->fetchAll(PDO::FETCH_ASSOC);
?>
<ul>
<? foreach ($documents as $doc): ?>
    <li>
        <a href="/download.php?id=<?= $doc['id'] ?>"><?= htmlspecialchars($doc['original_name']) ?></a>
        (<?= number_format($doc['size'] / 1024, 2) ?> КБ)
    </li>
<? endforeach; ?>
</ul>

В файле download.php вызывается метод serve() соответствующего класса.