Загрузка файлов с помощью SWFUpload и PHP

О загрузке файлов на серверрассказывается,
наверное, в каждой книге о веб разработке. Обычно при этом приводится
пример формы с тегом input type=file и объясняется, как работать с
массивом $_FILES на стороне сервера. Это классический вариант. Он отлично работает, но имеет несколько ограничений.
1) Чтобы загрузить несколько файлов, нужно создать несколько теговinput. При этом пользователь должен будет выбирать каждый файл отдельно, что довольно неудобно при большом количестве файлов.
2) Невозможно показать процент загрузки файла.
3) Загрузка нескольких файлов будет выполнена в одном запросе. Тут нет
ничего плохого, но может возникнуть проблема, если на сервере
установлены ограничения на максимальный объем запросов и время
выполнения скриптов.
4) Загрузка не будет асинхронной, т.е. произойдет перезагрузка страницы.
На сегодняшний день существует два основных варианта решения этих проблем. Использование iframe или flash (по-идее, silverlight тоже можно использовать для этих целей).

Кстати, о решении с помощью iframe я раньше рассказывал (Как реализовать асинхронную загрузку файлов с помощью JavaScript и PHP).
Сегодня речь пойдет об использовании flash, а точнее библиотекиSWFUpload.
На мой взгляд, это одно из лучших решений, т.к. несмотря на то, что отправка файлов осуществляется с помощью flash, настройка, управление и отслеживание процесса загрузки выполняется с помощьюJavaScript.
Пересказывать возможности SWFUpload я не буду, просто покажу небольшой пример её использования.
Постановка задачи.
Допустим нам необходимо позволить пользователю загружать фотографии на
сервер. При этом, сразу после загрузки они должны появляться внизу
страницы.
Шаг 1. Создаём главную страницу (index.php).

  1. <!DOCTYPE html PUBLIC «-//W3C//DTD XHTML 1.1//EN» «http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd»>
  2. <html xmlns=»http://www.w3.org/1999/xhtml» xml:lang=»en»>
  4. <head>
  5. <title>SWFUpload</title>
  6. <meta http-equiv=»Content-Type» content=»text/html; charset=UTF-8″ />
  7. </head>
  8. <body>
  9. <h1>SWFUpload</h1>
  10. <div id=»uploadButton»></div>
  11. <div id=»status»></div>
  12. <div id=»images»></div>
  13. <script type=»text/javascript» src=»»></script>
  14. <script type=»text/javascript» src=»»></script>
  15. <script type=»text/javascript» src=»»></script>
  16. <script type=»text/javascript» src=»»></script>
  17. </body>
  18. </html>

Здесь мы создали три блока.
uploadButton — предназначен для размещения кнопки загрузчика.
status — здесь мы будем выводить сообщения о процессе загрузки.
images — в этом блоке будут показаны загруженные картинки.
В конце страницы подключены 4 js файла.
Первый — библиотека jquery (её использовать необязательно, я просто хотел немного сократить количество js кода в примере).
Второй — swfupload.js. Это основной скрипт библиотеки SWFUpload. Именно он создаёт кнопку загрузки.
Третий — plugins/swfupload.queue.js. Тоже входит в состав библиотеки. Позволяет загружать несколько файлов одновременно.
Четвёртый — main.js. Здесь находится код настройки библиотеки и обработчики событий. Его мы сейчас и рассмотрим.
Шаг 2. Настраиваем SWFUpload.
Для того, чтобы подключить библиотеку, нужно создать объект SWFUpload и передать ему хеш с настройками.
Делается это следующим образом (код из файла main.js).

  1. var swfu = new SWFUpload(
  2. {
  3. upload_url : «»,
  4. flash_url : «»,
  5. button_placeholder_id : «uploadButton»,
  7. file_size_limit : «2 MB»,
  8. file_types : «*.jpg; *.png; *.jpeg; *.gif»,
  9. file_types_description : «Images»,
  10. file_upload_limit : «0»,
  11. debug: false,
  13. button_image_url: «»,
  14. button_width : 100,
  15. button_height : 30,
  16. button_text_left_padding: 15,
  17. button_text_top_padding: 2,
  18. button_text : «<span class=\»uploadBtn\»>Обзор…</span>»,
  19. button_text_style : «.uploadBtn { font-size: 18px; font-family: Arial; background-color: #FF0000; }»,
  21. file_dialog_complete_handler : fileDialogComplete,
  22. upload_success_handler : uploadSuccess,
  23. upload_complete_handler : uploadComplete,
  24. upload_start_handler : uploadStart,
  25. upload_progress_handler : uploadProgress
  26. }
  27. );

Думаю, названия большинства параметров говорят сами за себя, но хочу обратить ваше внимание на некоторые моменты.
В параметре upload_url мы указываем адрес php скрипта, который принимает файлы.
С помощью параметров flash_url и button_placeholder_id указываем адрес флеш ролика, который создаёт кнопку загрузки и id элемента на странице, в котором эта кнопка будет размещена.
Затем идет несколько параметров, устанавливающих ограничения на загрузку
файлов. Здесь указаны допустимые разрешения файлов, их максимальный
размер и количество файлов, которые можно загрузить за один раз (0 — любое количество).
После этого указываем параметры, настраивающие внешний вид кнопки
загрузки. Эта часть обязательная, т.к. по-умолчанию кнопка имеет размер
1х1 пиксель, и пользоваться ей будет невозможно.
Т.к. кнопка представляет собой флеш ролик, оформить её напрямую с помощью CSS не получится, но с помощью этих параметров вы можете указать фоновую картинку, шрифт и положения текста.
Оставшиеся параметры устанавливают обработчики событий. Рассмотрим их подробнее.

  1. function uploadSuccess(file, serverData) {
  2. $(‘#images’).append($(serverData));
  3. }
  5. function uploadComplete(file) {
  6. $(‘#status’).append($(‘<p>Загрузка ‘ + file.name + ‘ завершена</p>’));
  7. }
  9. function uploadStart(file) {
  10. $(‘#status’).append($(‘<p>Начата загрузка файла ‘ + file.name + ‘</p>’));
  11. return true;
  12. }
  14. function uploadProgress(file, bytesLoaded, bytesTotal) {
  15. $(‘#status’).append($(‘<p>Загружено ‘ + Math.round(bytesLoaded/bytesTotal*100) + ‘% файла ‘ + file.name + ‘</p>’));
  16. }
  18. function fileDialogComplete(numFilesSelected, numFilesQueued) {
  19. $(‘#status’).html($(‘<p>Выбрано ‘ + numFilesSelected + ‘ файл(ов), начинаем загрузку</p>’));
  20. this.startUpload();
  21. }

Сразу хочу обратить ваше внимание. В этом примере использованы не все
события, более полные примеры вы найдете на официальном сайте
библиотеки.
Начнем с события file_dialog_complete. Оно возникает, когда пользователь выбирает файлы и нажимает кнопку «Open». В его обработчике (fileDialogComplete) вам обязательно нужно запустить загрузку (сама по себе она не начнётся!).
this.startUpload();
Также обратите внимание, что обработчик события upload_start должен возвращать true, для того, чтобы загрузка началась.
Большинство из приведённых здесь обработчиков, получают объект fileв первом параметре. Как несложно догадаться в нём содержится информация о загружаемом файле. Имя файла можно получить так —file.name.
Ещё один интересный момент — разница между событиямиupload_success и upload_complete.
Первое срабатывает после того, как flash ролик завершает отправку
файла, второе — после того как приходит ответ сервера. Учтите, что если
вы после загрузки картинки на сервер будете выполнять её обработку
(масштабирование, например), то задержка между этими событиями будет
заметной.
В данном случае сервер просто возвращает тег img для загруженной картинки.
Шаг 3. Создаём серверный скрипт ().

  1. <?php
  3. $uploadDir = ‘uploads/’; //папка для хранения файлов
  5. $allowedExt = array(‘jpg’, ‘jpeg’, ‘png’, ‘gif’);
  6. $maxFileSize = 2 * 1024 * 1024; //1 MB
  8. //если получен файл
  9. if (isset($_FILES)) {
  10. //проверяем размер и тип файла
  11. $ext = end(explode(‘.’, strtolower($_FILES[‘Filedata’][‘name’])));
  12. if (!in_array($ext, $allowedExt)) {
  13. return;
  14. }
  15. if ($maxFileSize < $_FILES[‘Filedata’][‘size’]) {
  16. return;
  17. }
  18. if (is_uploaded_file($_FILES[‘Filedata’][‘tmp_name’])) {
  19. $fileName = $uploadDir.$_FILES[‘Filedata’][‘name’];
  20. //если файл с таким именем уже существует…
  21. if (file_exists($fileName)) {
  22. //…добавляем текущее время к имени файла
  23. $nameParts = explode(‘.’, $_FILES[‘Filedata’][‘name’]);
  24. $nameParts[count($nameParts)-2] .= time();
  25. $fileName = $uploadDir.implode(‘.’, $nameParts);
  26. }
  27. move_uploaded_file($_FILES[‘Filedata’][‘tmp_name’], $fileName);
  28. echo ‘<img src=»‘.$fileName.'» alt=»‘.$fileName.'» />’;
  29. }
  30. }

В принципе, это один из самых простых вариантов скрипта загрузки файлов. Я уже упоминал, что SWFUpload отправляет файлы в отдельных запросах, поэтому в массиве $_FILES может быть только один файл.
Вначале скрипта указываем папку для загрузки файлов, допустимые
расширения и размер. Эти же параметры указаны и при настройке flash
загрузчика, но напоминаю, что доверять полученным от клиента данным
нельзя.
Затем выполняем проверки (строки 11-18) и с помощью функцииmove_uploaded_file копируем загруженный файл в указанную папку.
Если файл с таким же именем уже был загружен, то добавляем к имени файла текущее время.
После этого, формируем тег img и отправляем его браузеру.
Как видите, ничего сложного. Использование библиотеки сводит количество
вашего кода к минимуму. Хотя, если вы захотите создать красивый
интерфейс, наглядно иллюстрирующий процесс загрузки, то поработать всё
же придется
Если хотите поэкспериментировать, качайте архив с этим примером.

Вы можете распаковать его в любую папку на вашем сервере. Только убедитесь, что папка uploads доступна для записи.