如何在 Django 中上传文件？

作为 Django 的新手，我很难在 Django 1.3 中制作上传应用程序。我找不到任何最新的示例 / 代码段。有人可以发布一个最小但完整的（模型，视图，模板）示例代码来这样做吗？

django file upload

答案

哎呀，Django 文档确实没有很好的例子。我花了 2 个多小时来挖掘所有内容，以了解其工作原理。有了这些知识，我实现了一个项目，该项目可以上传文件并将其显示为列表。要下载该项目的源代码，请访问https://github.com/axelpale/minimal-django-file-upload-example或克隆它：

> git clone https://github.com/axelpale/minimal-django-file-upload-example.git

2013 年 1 月 30 日更新： GitHub 上的源代码除了 1.3 之外，还实现了 Django 1.4 的实现。尽管变化不大，但以下教程对 1.4 也很有用。

2013 年 5 月 10 日更新： GitHub 上 Django 1.5 的实现。 urls.py 中重定向的微小变化以及 list.html 中 url 模板标记的用法。感谢hubert3的努力。

2013 年 12 月 7 日更新： GitHub 上支持 Django 1.6。一次导入已在 myapp / urls.py 中更改。感谢Arthedian 。

2015 年 3 月17 日更新：感谢 aronysidoro，GitHub 上支持 Django 1.7。

2015 年 9 月 4日更新：感谢 nerogit，GitHub 上支持 Django 1.8。

2016 年 7 月 3日更新：由于 daavve 和 nerogit，GitHub 上支持 Django 1.9

项目树

一个基本的 Django 1.3 项目，具有单个应用程序和要上传的 media / 目录。

minimal-django-file-upload-example/
    src/
        myproject/
            database/
                sqlite.db
            media/
            myapp/
                templates/
                    myapp/
                        list.html
                forms.py
                models.py
                urls.py
                views.py
            __init__.py
            manage.py
            settings.py
            urls.py

1. 设置：myproject / settings.py

要上传和提供文件，您需要指定 Django 在何处存储上传的文件以及 Django 从哪些 URL 提供文件。默认情况下，MEDIA_ROOT 和 MEDIA_URL 位于 settings.py 中，但它们为空。有关详细信息，请参见 Django 管理文件中的第一行。记住还要设置数据库并将 myapp 添加到 INSTALLED_APPS

...
import os

BASE_DIR = os.path.dirname(os.path.dirname(__file__))
...
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': os.path.join(BASE_DIR, 'database.sqlite3'),
        'USER': '',
        'PASSWORD': '',
        'HOST': '',
        'PORT': '',
    }
}
...
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
MEDIA_URL = '/media/'
...
INSTALLED_APPS = (
    ...
    'myapp',
)

2. 模型：myproject / myapp / models.py

接下来，您需要一个带有 FileField 的模型。该特定字段基于当前日期和 MEDIA_ROOT 将文件存储到例如 media / documents / 2011/12/24 /。请参阅FileField 参考。

# -*- coding: utf-8 -*-
from django.db import models

class Document(models.Model):
    docfile = models.FileField(upload_to='documents/%Y/%m/%d')

3. 表格：myproject / myapp / forms.py

为了更好地处理上传，您需要一个表格。这种形式只有一个字段，但是就足够了。有关详细信息，请参见表单 FileField 参考。

# -*- coding: utf-8 -*-
from django import forms

class DocumentForm(forms.Form):
    docfile = forms.FileField(
        label='Select a file',
        help_text='max. 42 megabytes'
    )

4. 查看：myproject / myapp / views.py

所有魔术发生的视图。请注意request.FILES的处理方式。对我来说，真的很难发现可以像这样将request.FILES['docfile']保存到 models.FileField 的事实。模型的 save（）自动处理文件到文件系统的存储。

# -*- coding: utf-8 -*-
from django.shortcuts import render_to_response
from django.template import RequestContext
from django.http import HttpResponseRedirect
from django.core.urlresolvers import reverse

from myproject.myapp.models import Document
from myproject.myapp.forms import DocumentForm

def list(request):
    # Handle file upload
    if request.method == 'POST':
        form = DocumentForm(request.POST, request.FILES)
        if form.is_valid():
            newdoc = Document(docfile = request.FILES['docfile'])
            newdoc.save()

            # Redirect to the document list after POST
            return HttpResponseRedirect(reverse('myapp.views.list'))
    else:
        form = DocumentForm() # A empty, unbound form

    # Load documents for the list page
    documents = Document.objects.all()

    # Render list page with the documents and the form
    return render_to_response(
        'myapp/list.html',
        {'documents': documents, 'form': form},
        context_instance=RequestContext(request)
    )

5. 项目 URL：myproject / urls.py

Django 默认不提供 MEDIA_ROOT。在生产环境中那将是危险的。但是在开发阶段，我们可能会缩短。注意最后一行。该行使 Django 可以提供来自 MEDIA_URL 的文件。这仅在开发阶段有效。

有关详细信息，请参见django.conf.urls.static.static 参考。另请参阅有关提供媒体文件的讨论。

# -*- coding: utf-8 -*-
from django.conf.urls import patterns, include, url
from django.conf import settings
from django.conf.urls.static import static

urlpatterns = patterns('',
    (r'^', include('myapp.urls')),
) + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

6. 应用程序 URL：myproject / myapp / urls.py

要使视图可访问，必须为其指定 URL。这里没什么特别的。

# -*- coding: utf-8 -*-
from django.conf.urls import patterns, url

urlpatterns = patterns('myapp.views',
    url(r'^list/$', 'list', name='list'),
)

7. 模板：myproject / myapp / templates / myapp / list.html

最后一部分：列表的模板及其下面的上传表单。表单必须将 enctype-attribute 设置为 “multipart / form-data”，并将方法设置为 “post”，才能上载到 Django。有关详细信息，请参见文件上传文档。

FileField 具有许多可以在模板中使用的属性。例如，如模板中的 {{document.docfile.url}} 和 {{document.docfile.name}}。有关更多信息，请参见使用模型中的文件和文件对象文档。

<!DOCTYPE html>
<html>
    <head>
        <meta charset="utf-8">
        <title>Minimal Django File Upload Example</title>   
    </head>
    <body>
    <!-- List of uploaded documents -->
    {% if documents %}
        <ul>
        {% for document in documents %}
            <li><a href="{{ document.docfile.url }}">{{ document.docfile.name }}</a></li>
        {% endfor %}
        </ul>
    {% else %}
        <p>No documents.</p>
    {% endif %}

        <!-- Upload form. Note enctype attribute! -->
        <form action="{% url 'list' %}" method="post" enctype="multipart/form-data">
            {% csrf_token %}
            <p>{{ form.non_field_errors }}</p>
            <p>{{ form.docfile.label_tag }} {{ form.docfile.help_text }}</p>
            <p>
                {{ form.docfile.errors }}
                {{ form.docfile }}
            </p>
            <p><input type="submit" value="Upload" /></p>
        </form>
    </body>
</html>

8. 初始化

只需运行 syncdb 和 runserver。

> cd myproject
> python manage.py syncdb
> python manage.py runserver

结果

最后，一切准备就绪。在默认的 Django 开发环境中，可以在localhost:8000/list/看到上载文档的列表。今天，这些文件已上传到 / path / to / myproject / media / documents / 2011/12/17 /，并且可以从列表中打开。

我希望这个答案将对我有所帮助。

一般来说，当您试图 “仅仅获得一个可行的例子” 时，最好是 “刚刚开始编写代码”。这里没有代码可以为您提供帮助，因此它可以为我们解答更多的问题。

如果要获取文件，则需要在某处的 html 文件中添加以下内容：

<form method="post" enctype="multipart/form-data">
    <input type="file" name="myfile" />
    <input type="submit" name="submit" value="Upload" />
</form>

这将为您提供浏览按钮，一个上载按钮以开始操作（提交表单）并记下 enctype，以便 Django 知道会给您request.FILES

在某处的视图中，您可以使用

def myview(request):
    request.FILES['myfile'] # this is my file

文件上传文档中包含大量信息

我建议您彻底阅读该页面，然后开始编写代码- 然后在不起作用时返回示例和堆栈跟踪。

演示版

查看github repo ，与 Django 3 一起使用

最小的 Django 文件上传示例

1. 创建一个 django 项目

运行 startproject ::

$ django-admin.py startproject sample

现在创建一个文件夹（ sample ）。

2. 创建一个应用

创建一个应用程序：

$ cd sample
$ python manage.py startapp uploader

现在，将创建一个包含以下文件的文件夹（ uploader

uploader/
  __init__.py
  admin.py
  app.py
  models.py
  tests.py
  views.py
  migrations/
    __init__.py

3. 更新 settings.py

在sample/settings.py在INSTALLED_APPS添加'uploader' ，然后添加MEDIA_ROOT和MEDIA_URL ，即：

INSTALLED_APPS = [
    'uploader',
    ...<other apps>...      
]

MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
MEDIA_URL = '/media/'

4. 更新 urls.py

在sample/urls.py添加：：

...<other imports>...
from django.conf import settings
from django.conf.urls.static import static
from uploader import views as uploader_views

urlpatterns = [
    ...<other url patterns>...
    path('', uploader_views.UploadView.as_view(), name='fileupload'),
]+ static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

5. 更新 models.py

更新uploader/models.py ::

from django.db import models
class Upload(models.Model):
    upload_file = models.FileField()    
    upload_date = models.DateTimeField(auto_now_add =True)

6. 更新 views.py

更新uploader/views.py ::

from django.views.generic.edit import CreateView
from django.urls import reverse_lazy
from .models import Upload
class UploadView(CreateView):
    model = Upload
    fields = ['upload_file', ]
    success_url = reverse_lazy('fileupload')
    def get_context_data(self, **kwargs):
        context = super().get_context_data(**kwargs)
        context['documents'] = Upload.objects.all()
        return context

7. 创建模板

创建一个文件夹sample / uploader / templates / uploader

创建一个文件upload_form.html，即sample/uploader/templates/uploader/upload_form.html ::

<div style="padding:40px;margin:40px;border:1px solid #ccc">
    <h1>Django File Upload</h1>
    <form method="post" enctype="multipart/form-data">
      {% csrf_token %}
      {{ form.as_p }}
      <button type="submit">Submit</button>
    </form><hr>
    <ul>
    {% for document in documents %}
        <li>
            <a href="{{ document.upload_file.url }}">{{ document.upload_file.name }}</a>
            <small>({{ document.upload_file.size|filesizeformat }}) - {{document.upload_date}}</small>
        </li>
    {% endfor %}
    </ul>
</div>

8. 同步数据库

同步数据库和运行服务器：

$ python manage.py makemigrations
$ python manage.py migrate
$ python manage.py runserver

访问http：// localhost：8000 /