Загрузка изображений через 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 в браузере. Встроенный сервер подходит для локальной проверки, но не для публикации сайта.
- Выберите изображение JPG, PNG, GIF или WebP размером до 5 МиБ.
- Нажмите «Загрузить». Кнопка заблокируется, появится полоса с процентами.
- Дождитесь ответа сервера. Страница покажет сообщение «Изображение сохранено» и превью.
- Откройте папку
uploads. В ней появится изображение со случайным именем. - Повторите загрузку. В панели Network должен появиться ровно один новый POST-запрос.
Индикатор показывает отправку файла, а превью подтверждает успешное сохранение.
На локальном сервере отправка может завершиться почти мгновенно. В Chromium-браузере откройте DevTools клавишей F12 и перейдите в Network. В списке ограничения скорости вместо No throttling выберите медленный профиль. Если готового профиля недостаточно, создайте пользовательский с небольшой скоростью Upload.
Повторите отправку изображения: процент должен возрастать по событиям передачи. После теста верните No throttling. Ограничение в DevTools влияет на запросы страницы, пока оно включено.
Введите в консоли браузера jQuery.fn.jquery: консоль покажет установленную версию библиотеки. Если появится ошибка об отсутствии jQuery, откройте Network и проверьте запрос к vendor/jquery.min.js. Ответ 404 означает неверное расположение файла.
Для проверки серверного отказа отправьте посторонний файл без клиентской проверки:
- Создайте текстовый файл с содержимым
testи именемfake.jpg. Убедитесь, что редактор не добавил к имени расширение.txt. - Откройте страницу загрузчика в Chrome и нажмите F12. На macOS откройте DevTools сочетанием Command+Option+I.
- В DevTools нажмите Ctrl+Shift+P; на macOS используйте Command+Shift+P. Откроется палитра команд.
- Введите
Disable JavaScriptи выберите одноименную команду. Оставьте DevTools открытыми. - Перезагрузите страницу, чтобы убрать уже зарегистрированный обработчик формы.
- Выберите
fake.jpgи нажмите «Загрузить». Браузер перейдет к ответуuploadFile.php: PHP вернет JSON сok: falseи сообщением о неверном содержимом изображения. - Откройте папку
uploads. Новый файл после отказа появиться не должен. - Снова откройте палитру команд DevTools тем же сочетанием. Введите
Enable JavaScriptи выберите команду. - Вернитесь на
http://127.0.0.1:8000/index.htmlи перезагрузите страницу. Загрузка настоящего изображения снова должна показать индикатор и превью.
Кроме удачной загрузки прогоняйте и отказ: переименованный посторонний файл должен оставлять папку uploads без нового изображения.
Популярное за неделю
- Как создать сайт самому в 2026: 4 способа + пошаговая инструкция 34 мин чтения
- Лучшие конструкторы для создания сайтов — плюсы, минусы и сравнения 22 мин чтения
- Слайдер-карусель на jQuery: какие плагины живы и как их подключить 12 мин чтения
- Как работать с анимацией в jQuery: fade, slide и animate 9 мин чтения
- Как отправить POST- и GET-запросы через jQuery Ajax в PHP 7 мин чтения
- jQuery slideUp, slideDown и slideToggle 6 мин чтения
Комментарии