Загрузка изображений через jQuery AJAX с индикатором выполнения

jQuery отправляет изображение через AJAX без перезагрузки страницы. Объект FormData передает файл, а события XMLHttpRequest показывают ход отправки. Соберите форму, анимированную полосу с процентами и PHP-обработчик с проверкой изображения. После сохранения сервер вернет превью, при ошибке страница покажет понятное сообщение.

HTML-форма с загрузкой файла изображения

Для примера понадобятся PHP с расширением Fileinfo и библиотека jQuery. Создайте отдельную папку проекта. Если у вас установлен npm, выполните в ней команды:

npm install jquery@latest
mkdir vendor
cp node_modules/jquery/dist/jquery.min.js vendor/jquery.min.js

Команда устанавливает текущий выпуск jQuery и копирует библиотеку в vendor.

Команды mkdir и cp здесь рассчитаны на Bash. В другом терминале создайте папку и скопируйте файл через файловый менеджер.

Сохраните разметку в index.html. Файлы style.css, upload.js и uploadFile.php разместите рядом.

<!DOCTYPE html>
<html lang="ru">
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>Загрузка изображения с индикатором выполнения</title>
    <link rel="stylesheet" href="style.css">
    <script src="vendor/jquery.min.js" defer></script>
    <script src="upload.js" defer></script>
</head>
<body>
    <main class="form-container">
        <h1>Загрузка изображения</h1>
        <form action="uploadFile.php" id="uploadForm"
              method="post" enctype="multipart/form-data">
            <label for="uploadImage">Выберите изображение</label>
            <input type="file" id="uploadImage" name="uploadImage"
                   accept="image/*" required>
            <p>JPEG, PNG, GIF или WebP. Максимум 5 МиБ.</p>
            <button id="submitButton" type="submit">Загрузить</button>
        </form>
        <div class="progress" id="progressDivId" hidden
             role="progressbar" aria-label="Отправка файла"
             aria-valuemin="0" aria-valuemax="100" aria-valuenow="0">
            <div class="progress-bar" id="progressBar"></div>
            <span class="percent" id="percent">0%</span>
        </div>
        <p id="uploadStatus" role="status"></p>
        <div id="outputImage" aria-live="polite"></div>
    </main>
</body>
</html>

Атрибут accept фильтрует изображения в диалоге выбора. Он не защищает сервер от отправки другого файла. Пример разрешает четыре формата и задает собственный предел 5 МиБ.

Добавьте полный CSS в style.css:

body {
    font-family: sans-serif;
    margin: 24px;
}
.form-container {
    max-width: 600px;
    margin: 0 auto;
}
input, button {
    display: block;
    margin-top: 12px;
}
.progress {
    position: relative;
    height: 28px;
    margin-top: 20px;
    overflow: hidden;
    border-radius: 6px;
    background: #e5e7eb;
}
.progress[hidden] {
    display: none;
}
.progress-bar {
    width: 0;
    height: 100%;
    background: #60a5fa;
    transition: width 120ms linear;
}
.percent {
    position: absolute;
    inset: 0;
    text-align: center;
    line-height: 28px;
    color: #111827;
}
.error {
    color: #b91c1c;
}
#outputImage img {
    display: block;
    max-width: 100%;
    height: auto;
}

Атрибут hidden скрывает индикатор до отправки.

CSS задает высоту, фон и короткий переход ширины. Переход сглаживает движение полосы без очереди jQuery-анимаций.

Как отправить изображение через jQuery AJAX

Метод $.ajax() отправляет FormData напрямую, без плагина jQuery Form. Обработчик события submit регистрируется один раз после загрузки документа. Поэтому отправка работает и кнопкой, и клавишей Enter.

Сохраните следующий код в upload.js:

$(function () {
    const form = document.getElementById('uploadForm');
    const input = document.getElementById('uploadImage');
    const button = document.getElementById('submitButton');
    const progress = document.getElementById('progressDivId');
    const bar = document.getElementById('progressBar');
    const percent = document.getElementById('percent');
    const status = $('#uploadStatus');
    const output = $('#outputImage');
    const maxBytes = 5 * 1024 * 1024;
    const allowedTypes = [
        'image/jpeg', 'image/png', 'image/gif', 'image/webp'
    ];
    let sending = false;

    function showError(message) {
        output.empty().addClass('error').text(message);
    }

    function setProgress(value) {
        bar.style.width = value + '%';
        percent.textContent = value + '%';
        progress.setAttribute('aria-valuenow', String(value));
    }

    $(form).on('submit', function (event) {
        event.preventDefault();
        if (sending) return;

        output.empty().removeClass('error');
        status.text('');
        progress.hidden = true;
        setProgress(0);

        const file = input.files[0];
        if (!file) {
            showError('Выберите изображение.');
            return;
        }
        if (!allowedTypes.includes(file.type)) {
            showError('Выберите JPEG, PNG, GIF или WebP.');
            return;
        }
        if (file.size === 0 || file.size > maxBytes) {
            showError('Размер файла должен быть от 1 байта до 5 МиБ.');
            return;
        }

        const data = new FormData(form);
        sending = true;
        button.disabled = true;
        input.disabled = true;
        progress.hidden = false;
        status.text('Отправка изображения…');

        $.ajax({
            url: form.action,
            method: 'POST',
            data: data,
            processData: false,
            contentType: false,
            dataType: 'json',
            xhr: function () {
                const xhr = $.ajaxSettings.xhr();
                xhr.upload.addEventListener('progress', function (event) {
                    if (!event.lengthComputable) {
                        status.text('Отправка: общий размер неизвестен.');
                        progress.hidden = true;
                        return;
                    }
                    const value = Math.min(
                        100, Math.floor(event.loaded / event.total * 100)
                    );
                    setProgress(value);
                    if (value === 100) {
                        status.text('Файл отправлен. Сервер проверяет изображение…');
                    }
                });
                return xhr;
            },
            success: function (response) {
                if (!response || response.ok !== true ||
                    typeof response.html !== 'string') {
                    status.text('Загрузка не завершена.');
                    showError('Сервер вернул неожиданный ответ.');
                    return;
                }
                setProgress(100);
                status.text('Изображение сохранено.');
                output.removeClass('error').html(response.html);
                form.reset();
            },
            error: function (xhr) {
                status.text('Загрузка не завершена.');
                const message = xhr.responseJSON && xhr.responseJSON.message;
                showError(typeof message === 'string' ? message :
                    'Не удалось загрузить изображение. Проверьте соединение и ответ сервера.');
            },
            complete: function () {
                sending = false;
                button.disabled = false;
                input.disabled = false;
            }
        });
    });
});

processData: false запрещает jQuery преобразовывать FormData в строку. contentType: false оставляет браузеру настройку multipart-заголовка с разделителем частей. Не задавайте Content-Type вручную: без правильного разделителя PHP не разберет файл.

Событие xhr.upload.progress сообщает количество отправленных байтов. Полоса и подпись получают один вычисленный процент.

Значение 100% означает окончание отправки тела запроса. Успех сохранения подтверждает только ответ PHP.

Проверки file.type и file.size помогают избежать лишней отправки. Сервер повторяет проверки независимо от браузера. Значения клиентского MIME можно подделать.

PHP-код загрузчика файлов

Переменные файла хранятся в суперглобальном массиве $_FILES. Функция move_uploaded_file() используется для перемещения загруженного файла в целевую папку uploads.

Создайте эту папку рядом с uploadFile.php. Процесс PHP должен иметь право записи в нее. Для локального запуска обычно достаточно создать каталог под своим пользователем:

mkdir uploads

Не назначайте папке права 777 ради устранения ошибки.

На сервере выдайте запись пользователю или группе процесса PHP. Обработчик сообщит, если каталог недоступен.

Сохраните код в uploadFile.php. Скрипт принимает только POST-запросы и возвращает JSON с HTTP-статусом.

<?php
header('Content-Type: application/json; charset=utf-8');
header('X-Content-Type-Options: nosniff');

function respond($status, $payload)
{
    http_response_code($status);
    echo json_encode($payload, JSON_UNESCAPED_UNICODE);
    exit;
}

function fail($status, $message)
{
    respond($status, ['ok' => false, 'message' => $message]);
}

if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
    header('Allow: POST');
    fail(405, 'Используйте POST-запрос.');
}

if (!isset($_FILES['uploadImage'])) {
    fail(400, 'Файл не получен. Возможна пустая форма или превышение post_max_size.');
}

$file = $_FILES['uploadImage'];
if (!is_array($file) ||
    !isset($file['error'], $file['name'], $file['tmp_name']) ||
    !is_int($file['error']) ||
    !is_string($file['name']) || !is_string($file['tmp_name'])) {
    fail(400, 'Неверная структура загрузки.');
}

if ($file['error'] !== UPLOAD_ERR_OK) {
    switch ($file['error']) {
        case UPLOAD_ERR_INI_SIZE:
        case UPLOAD_ERR_FORM_SIZE:
            fail(413, 'Файл превышает разрешенный размер загрузки.');
        case UPLOAD_ERR_PARTIAL:
            fail(400, 'Файл получен не полностью. Повторите отправку.');
        case UPLOAD_ERR_NO_FILE:
            fail(400, 'Выберите изображение.');
        default:
            fail(500, 'Сервер не смог принять файл. Проверьте журнал PHP.');
    }
}

$tmp = $file['tmp_name'];
if (!is_uploaded_file($tmp)) {
    fail(400, 'Источник файла не прошел проверку.');
}

$maxBytes = 5 * 1024 * 1024;
$size = filesize($tmp);
if ($size === false) {
    fail(500, 'Сервер не смог определить размер файла.');
}
if ($size === 0 || $size > $maxBytes) {
    fail(413, 'Размер файла должен быть от 1 байта до 5 МиБ.');
}

$allowed = [
    'jpg' => 'image/jpeg',
    'png' => 'image/png',
    'gif' => 'image/gif',
    'webp' => 'image/webp'
];
$extension = strtolower(pathinfo($file['name'], PATHINFO_EXTENSION));
if (!isset($allowed[$extension])) {
    fail(415, 'Допустимы расширения jpg, png, gif и webp.');
}

if (!class_exists('finfo')) {
    fail(500, 'На сервере требуется расширение PHP Fileinfo.');
}

try {
    $finfo = new finfo(FILEINFO_MIME_TYPE);
    $mime = $finfo->file($tmp);
    if ($mime !== $allowed[$extension]) {
        fail(415, 'Содержимое изображения не соответствует расширению.');
    }

    $imageInfo = @getimagesize($tmp);
    if ($imageInfo === false || $imageInfo['mime'] !== $mime) {
        fail(415, 'Файл не распознан как изображение.');
    }

    $folder = __DIR__ . '/uploads';
    if (!is_dir($folder) || !is_writable($folder)) {
        fail(500, 'Папка uploads отсутствует или недоступна для записи.');
    }

    $name = bin2hex(random_bytes(16)) . '.' . $extension;
    if (!move_uploaded_file($tmp, $folder . '/' . $name)) {
        fail(500, 'Сервер не смог сохранить изображение.');
    }

    $url = htmlspecialchars(
        'uploads/' . $name, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8'
    );
    respond(200, [
        'ok' => true,
        'html' => '<img src="' . $url . '" alt="Загруженное изображение">'
    ]);
} catch (Throwable $error) {
    error_log((string) $error);
    fail(500, 'Ошибка обработки изображения. Подробности доступны в журнале PHP.');
}

Белый список связывает расширение с MIME, определенным через finfo. Пример принимает JPEG с расширением .jpg; файл .jpeg переименуйте в .jpg. Проверка getimagesize() дополнительно отсеивает файлы без распознаваемого заголовка изображения.

Сервер создает случайное имя из 16 байтов.

Исходное имя не попадает ни в путь, ни в HTML. Функция htmlspecialchars() экранирует адрес внутри атрибута src.

Эти проверки не заменяют защиту публичного сервиса. Перед публикацией запретите выполнение скриптов в каталоге загрузок на уровне веб-сервера. Добавьте авторизацию, защиту от CSRF и ограничения частоты запросов. Для обработки недоверенных изображений также ограничивайте размеры в пикселях и рассматривайте перекодирование.

Как настроить ограничения размера в PHP

Параметр upload_max_filesize ограничивает один файл. Параметр post_max_size ограничивает все тело POST-запроса, включая multipart-обвязку.

Для локального сервера найдите конфигурацию командой в том же терминале:

php --ini

Строка Loaded Configuration File покажет путь к загруженному php.ini. Откройте этот файл в текстовом редакторе, предварительно сохранив копию. Найдите параметры и задайте запас для лимита примера 5 МиБ:

file_uploads = On
upload_max_filesize = 6M
post_max_size = 8M

После сохранения остановите встроенный сервер через Ctrl+C и запустите снова.

Если строка Loaded Configuration File содержит (none), загруженного файла конфигурации нет. Для локального примера передайте настройки прямо при запуске сервера из папки проекта:

php -d file_uploads=1 -d upload_max_filesize=6M -d post_max_size=8M -S 127.0.0.1:8000

Параметры -d действуют только для запущенного процесса PHP.

Проверьте настройки загрузкой изображения размером между 2 и 5 МиБ. Обработчик должен сохранить файл и вернуть превью. Чтобы отменить изменения, восстановите копию php.ini и перезапустите сервер. Если использовали -d, остановите процесс и запустите его без этих параметров.

На рабочем сервере PHP может использовать другую конфигурацию, чем терминал. Настройки меняют для процесса, обслуживающего сайт, например PHP-FPM. Команда php --ini показывает конфигурацию консольного PHP и не определяет настройки PHP-FPM.

Изменение через ini_set() внутри загрузчика не поможет: PHP разбирает загрузку до выполнения скрипта.

Если файл превышает upload_max_filesize, PHP возвращает ошибку загрузки. При превышении post_max_size массивы $_POST и $_FILES могут оказаться пустыми. Поэтому обработчик не зависит от наличия кнопки в $_POST и отдельно проверяет отсутствие файла.

Веб-сервер тоже может отклонить запрос до запуска PHP. Тогда страница покажет общее сообщение об ошибке. HTTP-статус и тело ответа видны в панели Network браузера.

Как запустить и проверить загрузку изображения

Запустите пример через HTTP: открытие index.html как локального файла не выполнит PHP. Если PHP доступен в терминале, перейдите в папку проекта и выполните:

php -S 127.0.0.1:8000

Если сервер уже запущен с параметрами -d, оставьте его работать.

Откройте http://127.0.0.1:8000/index.html в браузере. Встроенный сервер подходит для локальной проверки, но не для публикации сайта.

  1. Выберите изображение JPG, PNG, GIF или WebP размером до 5 МиБ.
  2. Нажмите «Загрузить». Кнопка заблокируется, появится полоса с процентами.
  3. Дождитесь ответа сервера. Страница покажет сообщение «Изображение сохранено» и превью.
  4. Откройте папку uploads. В ней появится изображение со случайным именем.
  5. Повторите загрузку. В панели Network должен появиться ровно один новый POST-запрос.

Индикатор показывает отправку файла, а превью подтверждает успешное сохранение.

Форма AJAX-загрузки изображения с индикатором выполнения

На локальном сервере отправка может завершиться почти мгновенно. В Chromium-браузере откройте DevTools клавишей F12 и перейдите в Network. В списке ограничения скорости вместо No throttling выберите медленный профиль. Если готового профиля недостаточно, создайте пользовательский с небольшой скоростью Upload.

Повторите отправку изображения: процент должен возрастать по событиям передачи. После теста верните No throttling. Ограничение в DevTools влияет на запросы страницы, пока оно включено.

Введите в консоли браузера jQuery.fn.jquery: консоль покажет установленную версию библиотеки. Если появится ошибка об отсутствии jQuery, откройте Network и проверьте запрос к vendor/jquery.min.js. Ответ 404 означает неверное расположение файла.

Для проверки серверного отказа отправьте посторонний файл без клиентской проверки:

  1. Создайте текстовый файл с содержимым test и именем fake.jpg. Убедитесь, что редактор не добавил к имени расширение .txt.
  2. Откройте страницу загрузчика в Chrome и нажмите F12. На macOS откройте DevTools сочетанием Command+Option+I.
  3. В DevTools нажмите Ctrl+Shift+P; на macOS используйте Command+Shift+P. Откроется палитра команд.
  4. Введите Disable JavaScript и выберите одноименную команду. Оставьте DevTools открытыми.
  5. Перезагрузите страницу, чтобы убрать уже зарегистрированный обработчик формы.
  6. Выберите fake.jpg и нажмите «Загрузить». Браузер перейдет к ответу uploadFile.php: PHP вернет JSON с ok: false и сообщением о неверном содержимом изображения.
  7. Откройте папку uploads. Новый файл после отказа появиться не должен.
  8. Снова откройте палитру команд DevTools тем же сочетанием. Введите Enable JavaScript и выберите команду.
  9. Вернитесь на http://127.0.0.1:8000/index.html и перезагрузите страницу. Загрузка настоящего изображения снова должна показать индикатор и превью.

Кроме удачной загрузки прогоняйте и отказ: переименованный посторонний файл должен оставлять папку uploads без нового изображения.

Комментарии

Оставьте свой комментарий
Пока никто не оставил комментариев