Работа с фото профиля в PHP: методы хранения, обработки и безопасности

Расширенные примеры работы с фотографиями пользователей

Пример 1: Полный класс для загрузки аватара с обработкой ошибок и поддержкой нескольких размеров

Класс инкапсулирует логику валидации, сохранения, генерации миниатюр и возвращает массив путей. Поддерживает JPEG, PNG, WEBP.

class AvatarUploader
{
    private $allowedMimes = ['image/jpeg', 'image/png', 'image/webp'];
    private $maxFileSize = 2097152; // 2 MB
    private $uploadDir;

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

    public function upload($file) {
        if ($file['error'] !== UPLOAD_ERR_OK) {
            throw new Exception("Ошибка загрузки: код {$file['error']}");
        }
        if ($file['size'] > $this->maxFileSize) {
            throw new Exception("Файл превышает 2 MB");
        }
        $finfo = new finfo(FILEINFO_MIME_TYPE);
        $mime = $finfo->file($file['tmp_name']);
        if (!in_array($mime, $this->allowedMimes)) {
            throw new Exception("Недопустимый MIME-тип: $mime");
        }

        $ext = pathinfo($file['name'], PATHINFO_EXTENSION);
        $filename = uniqid('avatar_') . '.' . $ext;
        $path = $this->uploadDir . $filename;

        move_uploaded_file($file['tmp_name'], $path);

        // Генерация миниатюры
        $img = Image::make($path);
        $img->orientate(); // поворот на основе EXIF
        $img->fit(150, 150)->save($this->uploadDir . 'thumb_' . $filename);

        return [
            'original' => 'uploads/' . $filename,
            'thumbnail' => 'uploads/thumb_' . $filename
        ];
    }
}

// Использование:
$uploader = new AvatarUploader(__DIR__ . '/uploads');
try {
    $result = $uploader->upload($_FILES['avatar']);
    // Сохранить $result в базе данных
    echo "Аватар загружен: " . $result['original'];
} catch (Exception $e) {
    echo "Ошибка: " . $e->getMessage();
}

Аватар загружен: uploads/avatar_65f7b2c8d9e0f1.jpg
Миниатюра: uploads/thumb_avatar_65f7b2c8d9e0f1.jpg

Пример 2: Асинхронная загрузка через Ajax с проверкой на стороне сервера и клиента

HTML-форма с enctype="multipart/form-data" и JavaScript (Fetch) отправляет файл на сервер. Сервер возвращает JSON с URL.

// client.html
<form id="avatarForm">
  <input type="file" name="avatar" accept="image/*">
  <button type="submit">Загрузить</button>
</form>
<div id="preview"></div>
<script>
document.getElementById('avatarForm').addEventListener('submit', async (e) => {
    e.preventDefault();
    const formData = new FormData(e.target);
    const resp = await fetch('/upload.php', { method: 'POST', body: formData });
    const json = await resp.json();
    if (json.success) {
        document.getElementById('preview').innerHTML = 
            `<img src="${json.url}" alt="Аватар">`;
    } else {
        alert(json.error);
    }
});
</script>

// upload.php
header('Content-Type: application/json');
$response = ['success' => false, 'error' => ''];
try {
    // ... логика загрузки, аналогичная Примеру 1 ...
    $response['success'] = true;
    $response['url'] = '/uploads/' . $filename;
} catch (Exception $e) {
    $response['error'] = $e->getMessage();
}
echo json_encode($response);

Ответ сервера: {"success":true,"url":"/uploads/avatar_...jpg"}

Пример 3: Добавление водяного знака на фото пользователя

Может потребоваться для защиты авторских прав. Водяной знак наносится на оригинал и на все версии.

$watermark = Image::make('watermark.png')->resize(100, null, function ($c) {
    $c->aspectRatio();
});

$userPhoto = Image::make($_FILES['photo']['tmp_name']);
$userPhoto->insert($watermark, 'bottom-right', 10, 10);
$userPhoto->save('/uploads/' . uniqid() . '.jpg');

Изображение сохранено с водяным знаком в правом нижнем углу.

Пример 4: Автоматическое определение и коррекция ориентации по EXIF

Смартфоны записывают ориентацию в метаданные, но не поворачивают сам кадр. Библиотека Intervention Image умеет это исправлять.

$img = Image::make($path);
$img->orientate(); // поворот на основе EXIF Orientation
$img->save($path); // перезаписываем с правильной ориентацией

Пример 5: Генерация уникального имени с сохранением оригинального имени (для UX)

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

$originalName = $_FILES['avatar']['name']; // e.g. "my_photo.jpg"
$safeName = uniqid() . '_' . preg_replace('/[^\w\.\-]/', '_', $originalName);
move_uploaded_file($file['tmp_name'], $uploadDir . $safeName);
// Сохраняем $originalName и $safeName в БД