Загрузка файлов в Django | Создание загрузочной формы
В данном руководстве показано, как реализовать загрузку файлов с Django. Для этого создадим простой клон Instagram, который будет работать с изображениями.
Содержание
Установка Django в Python 3
Для простоты папку с обучающим примером лучше поместить на рабочем столе, но в общем и целом расположение особого значения не имеет. Главное, чтобы директория проекта была легко доступной.
Активируем новую виртуальную среду:
Есть вопросы по Python?
На нашем форуме вы можете задать любой вопрос и получить ответ от всего нашего сообщества!
Telegram Чат & Канал
Вступите в наш дружный чат по Python и начните общение с единомышленниками! Станьте частью большого сообщества!
Паблик VK
Одно из самых больших сообществ по Python в социальной сети ВК. Видео уроки и книги для вас!
Создание проекта и приложения в Django
Теперь запускаем python manage.py migrate для установки базы данных нового проекта.
Создаем модели в Django
Настройка MEDIA_ROOT в Django 2
Откройте insta_project/settings.py в вашем текстовом редакторе. Нам потребуется добавить две новые конфигурации. По умолчанию MEDIA_URL и MEDIA_ROOT являются пустыми и не отображаются на экране, поэтому их необходимо настроить:
Название media использовать не обязательно, можно выбрать любое, просто в Django media используется по умолчанию. Мы также создаем папку images внутри для простоты навигации.
Панель администратора (админка) в Django
Все настроено! Генерируем новый файл миграции.
Теперь запускаем migrate для обновления базы данных.
Теперь можно создать аккаунт superuser для доступа к интерфейсу администратора, после чего выполнить runserver для первого запуска локального веб-сервера:
Скачать картинку можно тут Django Pony.
Настройка urls.py в Django
Создаем форму загрузки файлов в Django
Создаем форму загрузки файлов в Django
В данном руководстве показано, как реализовать загрузку файлов с Django. Для этого создадим простой клон Instagram, который будет работать с изображениями.
Установка Django в Python 3
Для простоты папку с обучающим примером лучше поместить на рабочем столе, но в общем и целом расположение особого значения не имеет. Главное, чтобы директория проекта была легко доступной.
Активируем новую виртуальную среду:
Создание проекта и приложения в Django
Теперь запускаем python manage.py migrate для установки базы данных нового проекта.
Создаем модели в Django
Настройка MEDIA_ROOT в Django 2
Откройте insta_project/settings.py в вашем текстовом редакторе. Нам потребуется добавить две новые конфигурации. По умолчанию MEDIA_URL и MEDIA_ROOT являются пустыми и не отображаются на экране, поэтому их необходимо настроить:
Название media использовать не обязательно, можно выбрать любое, просто в Django media используется по умолчанию. Мы также создаем папку images внутри для простоты навигации.
Панель администратора (админка) в Django
Все настроено! Генерируем новый файл миграции.
Теперь запускаем migrate для обновления базы данных.
Теперь можно создать аккаунт superuser для доступа к интерфейсу администратора, после чего выполнить runserver для первого запуска локального веб-сервера:
Если набрать в адресной строке браузера http://127.0.0.1:8000/admin, появится возможность зайти в админку Django. Вы будете направлены на следующую страницу:
Скачать картинку можно тут Django Pony.
Настройка urls.py в Django
Затем мы вынесем все записи на главную страницу, для этого используем пустую строку » в качестве пути.
Представления views в Django
Шаблоны templates в Django
Файл шаблона home.html показывает title и image всех наших записей. В Instagram все было бы так же.
Вот и все. Запустите сервер командой python manage.py runserver и перейдите на домашнюю страницу http://127.0.0.1:8000. В случае необходимости перезагрузите страницу.
Вуаля! Если вы добавите дополнительные посты с заголовками и картинками от имени администратора, то они появятся на домашней странице.
Форма для добавления записи в Django
Теперь мы можем создать html форму для того, чтобы обычные пользователи без доступа в админку могли также добавлять записи и загружать файлы. Это предполагает создание новой страницы при помощи формы.
Займемся формой. Она создается следующим образом:
Создаем новый шаблон.
Вот и оно! Убедитесь, что сервер запущен, и перейдите на страницу http://127.0.0.1:8000/post/.
После подтверждения создания новой записи вы будете перенаправлены на домашнюю страницу, где отображаются все имеющиеся посты.
Следующие шаги
И что теперь? Многим наверняка захочется наложить определенные ограничения на размер картинки. Это можно сделать в файле models.py или при помощи CSS. Также многим наверняка захочется добавить опции редактирования или удаления для записей.
Ввиду важного обновления, не рекомендуется размещать файлы в Django. Лучше настроить выделенную внешнюю службу, например, сеть доставки контента Content Delivery Network (CDN).
Как загружать картинки и файлы через Django 3 используя модель и формы
Для работы с изображениями и другими файлами во фреймворке Python Django существует готовый механизм реализуемый через модели. Процесс хранения картинок и файлов в базах данных может вызвать путаницу если вы не имели особого опыта работы с ними. Процесс создания возможности загрузки файлов состоит из нескольких шагов, которые мы рассмотрим ниже на примерах.
Навигация по посту
Подготовка тестового проекта
Создадим проект, на котором будут показаны следующие примеры. У вас уже должен быть установлен Django и, по вашему желанию, создана виртуальная среда. В примерах будет использоваться название проекта ‘file_project’, вы можете выбрать имя на свое усмотрение:
Мы должны добавить наше приложение в конфигурацию проекта через ‘settings.py’. В ‘INSTALLED_APPS’ нужно добавить следующую строку:
Создание модели для загрузки файлов
В большинстве случаев хранение файлов организуется в несколько шагов:
Для такой реализации в Django есть два типа полей (Fields):
Модели создаются в ‘models.py’ вашего проекта. Добавьте в него следующую модель:
В ImageField добавлена проверка, что файл имеет тип изображения. Так же у ImageField есть методы возвращающие высоту и ширину. Ширину и высоту так же можно сохранить в отдельные модели используя параметры height_field и width_field. Часть этих возможностей по работе с изображениями выполняется через библиотеку Pillow и поэтому ее нужно установить:
Удаление любого объекта удаляет только запись из базы. На файловой системе файл остается.
После создания моделей выполните миграции:
Динамический upload_to
Папки для сохранения данных можно организовать динамически. Например мы можем сделать так, что бы файл сохранялся в каталог с названием сегодняшней даты формата год-месяц-день:
Этот способ соответствует методу strftime() из библиотеки datetime.
Так же можно создать путь соответствующий пользователю, который выполняет загрузку:
Использование существующих файлов и папок с FilePathField
В панели администрирования, если указанная папка не пуста, файл будет выводиться следующим образом:
FilePathField не следует использовать в директориях с вашим приложением т.к. приводит к уязвимостям.
Используем CRUD запросы в Django 3 на примере приложения
Переменная MEDIA_ROOT и MEDIA_URL
Для хранения всех загруженных файлов определяется отдельная папка. Эта папка указывается в переменной MEDIA_ROOT, в файле ‘settings.py’. Есть еще переменная MEDIA_URL, которая используется в шаблонах и адресах для обращения к файлам в MEDIA_ROOT.
Эти настройки прописываются в файле ‘settings.py’. Для Django 3+ используются следующие значения:
Для Django до 3-ей версии это выглядело так:
BASE_DIR, в обоих случаях, это путь до вашего проекта. В примерах выше, в этой папке, вы должны создать папку ‘media’ самостоятельно:
Теперь, например, сохранять файлы вы будете по следующему пути:
А открывать их будет по следующей ссылке:
Панель администрирования
Зарегистрируем наши модели что бы они отображались в панели администрирования. Для этого отредактируем файл ‘admin.py’:
После этого создайте супер пользователя и запустите сервер:
Зайдя по адресу ‘http://127.0.0.1:8000/admin/’ и авторизовавшись можно увидеть созданную модель и поля для загрузки файлов:
Если открыть директорию прописанную в «MEDIA_ROOT» можно увидеть загруженные файлы (могут отличаться из-за настроек):
Загрузка и вывод файлов
Что бы вывести изображение на странице нужно выполнить следующие шаги:
Реализуем эти пункты
Создание ссылки в urls.py
В рамках разработки, в Django, предусмотрена возможность возвращать пользователю статические файлы. Добавим в файл ‘url.py’ ссылку по которой будет возвращаться страница с картинкой и возможность обработки загруженных файлов:
Возможность возвращать пользователю статические файлы так же связана с настройкой DEBUG в ‘settings.py’. Файлы будут нормально обрабатываться, если DEBUG=True.
Вывод изображения на странице
Что бы вывести файл на странице достаточно обратить к нужному значению из базы. То есть для вывода картинки достаточно следующей функции в ‘upload_app/views.py’:
В созданной модели у меня есть 3 поля:
Что бы вывести их на странице я создам следующий шаблон по пути:
После запуска сервера можно будет увидеть следующий результат (при наличии данных в базе):
Загрузка документа со страницы и его сохранение
Что бы сохранить файл с Django мы должны использовать следующую функцию:
Теперь, запустив сервер и, открыв главную страницу, у нас будет возможность загрузки файла в корень MEDIA_ROOT:
В примере выше файл в базу не сохраняется. Что бы путь до файла сохранился в базу мы должны передать ему объект file. Ниже пример, если бы вы загружали несколько файлов сразу:
Создание формы
Все шаги, описанные выше, можно сократить использовав существующие возможности Django. Например в Django есть формы, которые можно создать на основе существующей модели. Такие формы упрощают процесс валидации (соответствует ли тип данных Django типу в базе), представления в шаблоне (HTML теги создаются сами) и много другое.
Формы, обычно, создаются в отдельном файле ‘forms.py’:
Для работы формы нужна модель, на основе которой можно определить поля. Поместим в этот файл следующий код:
В файл маршрутизации добавим маршрут, который свяжет url с новым классом:
Создадим файл шаблона по пути:
В этот файл добавим форму и вывод существующих записей:
После запуска сервера эта страница будет выглядеть так:
Как загрузить файлы с Django
В этом руководстве вы узнаете о принципах загрузки файлов Django и о том, как обрабатывать загрузку файлов с использованием форм моделей. В конце этого поста вы найдете исходный код примеров, которые я использовал, чтобы вы могли попробовать и изучить.
Основы загрузки файлов с Django
У Django есть подходящие поля модели для обработки загруженных файлов: FileField и ImageField .
FileField и ImageField создаются как строковое поле в базе данных (обычно VARCHAR), содержащее ссылку на фактический файл.
Вам нужно будет установить MEDIA_URL и MEDIA_ROOT в файле settings.py вашего проекта.
Чтобы получить доступ к MEDIA_URL в шаблоне, вы должны добавить django.template.context_processors.media к вашим context_processors в конфигурации TEMPLATES .
Простая загрузка файла
simple_upload.html
views.py
Загрузка файла с модельными формами
Это более удобный способ. Формы моделей выполняют валидацию, автоматически строят абсолютный путь для загрузки, обрабатывают конфликты имен файлов и другие распространенные задачи.
models.py
forms.py
views.py
model_form_upload.html
О параметре FileField upload_to
Смотрите пример ниже:
Также возможно сделать что-то вроде:
upload_to также может быть вызываемым параметром, который возвращает строку. Этот вызываемый параметр принимает два параметра, экземпляр (instance) и имя файла (filename).
Скачать примеры
Код, используемый в этом посте, доступен на Github.
Руководство по загрузке файлов (и изображений) в Django
Setup
If you’re on a Mac the Desktop is a convenient place to put our code. The location doesn’t matter; it just needs to be easily available.
On the command line, navigate there and create a directory insta for our files. We will use Pipenv to install both Django and pillow which is a Python image process library Django relies on for image files. For non-image file uploads, pillow is not needed. Finally activate our new virtual environment with the shell command.
You should see (insta) going forward to indicate we’re in an active virtual environment. You can type exit at any time to leave it and pipenv shell to re-enter.
Project and App
Now run python manage.py migrate to setup the new database for our project.
Models
MEDIA_ROOT
Open up insta_project/settings.py in your text editor. We will add two new configurations. By default MEDIA_URL and MEDIA_ROOT are empty and not displayed so we need to configure them:
We could pick a name other than media here but this is the Django convention. We’ll also make an images folder within it to use shortly.
Admin
Now update the posts/admin.py file so we can see our Post app in the Django admin.
And we’re all set! Generate a new migrations file.
Then run migrate to update the database.
Now we can create a superuser account to access the admin and then execute runserver to spin up the local web server for the first time.
If you go to http://127.0.0.1:8000/admin you’ll be able to log in to the Django admin site. It should redirect you to this page:
Upon «Save» you will be redirected to the Posts page where we can see all our posts.
If you look within the local media folder in your project you’ll see under images there is now the djangopony.png image file. See! I told you that was what MEDIA_URL would do.
Next we’ll need to sort out the URL routes within the posts app. First create that file.
Then we’ll put all posts on the homepage so again use the empty string » as our route path.
This references a view called HomePageView which we’ll create next.
Views
Templates
We have two choices for our template’s location. We could put it within the posts app at posts/templates/posts/home.html but I find that structure redundant. Plus it’s harder to reason about templates when they are all buried within their respective apps. So typically I will instead create a project-level templates directory.
Our home.html template file will display the title and image for all posts. Just like Instagram would 
Ok, that’s it! Make sure the server is running with the python manage.py runserver command and navigate to our homepage at http://127.0.0.1:8000. Refresh the page if needed.
And voila! If you add additional posts with a title and image via the admin they will appear on the homepage.
Now we can add a form so regular users, who wouldn’t have access to the admin, can also add posts. That means creating a new page with a form.
Let’s start with the views.py file. We’ll name our new view CreatePostView which will extend the built-in Django CreateView. We’ll also import reverse_lazy to handle the redirect back to our homepage after the form has been submitted.
Next up that form. First create it.
Then create the new template.
And fill it with a headline and form. It’s important to always add csrf_token for protection. We’re specifying form.as_p which means Django will output each field as a paragraph tag.
That’s it! Make sure your server is running and go to the page at http://127.0.0.1:8000/post/.
After you submit a new post you’ll be redirected back to the homepage and will see all the posts.
Next Steps
Hosting this site in production would require a few additional steps. Notably, it’s likely that you would use WhiteNoise on the server for your static files, however WhiteNoise explicitly does not support media files. The common practice is to use django-storages for this purpose and connect to something like S3.