如何在 Django 中上传文件？

Question

Closed. This question needs to be more focused. It is not currently accepting answers.

---

想要改进这个问题吗？通过编辑这篇文章来更新问题，使其仅关注一个问题。

8 年前已关闭。

Answer 1

演示

请参阅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 添加'uploader' 到 INSTALLED_APPS 并添加 MEDIA_ROOT 和 MEDIA_URL，即::

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

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

更新 urls.py

4. sample/urls.py add::

...<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.同步数据库

同步数据库和runserver::

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

访问http://localhost:8000/

Answer 2

一般来说，当您尝试“只是获得一个工作示例”时，最好“开始编写代码”。这里没有代码可以帮助您，因此这使得回答这个问题对我们来说更加困难。

如果你想抓取一个文件，你需要在一个 html 文件中的某个地方有这样的东西：

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

这将为你提供浏览按钮，一个上传按钮来启动操作（提交表单）并记下 enctype，以便 Django 知道给你< code>request.FILES

在某个视图中，您可以使用以下命令访问该文件

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

文件上传文档

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

Answer 3

我必须说我发现 django 的文档令人困惑。
还是举个最简单的例子，为什么要提到表格？
我在views.py中工作的例子是：

for key, file in request.FILES.items():
    path = file.name
    dest = open(path, 'w')
    if file.multiple_chunks:
        for c in file.chunks():
            dest.write(c)
    else:
        dest.write(file.read())
    dest.close()

-html文件看起来像下面的代码，尽管这个例子只上传一个文件，而保存文件的代码处理许多文件：-

<form action="/upload_file/" method="post" enctype="multipart/form-data">{% csrf_token %}
<label for="file">Filename:</label>
<input type="file" name="file" id="file" />
<br />
<input type="submit" name="submit" value="Submit" />
</form>

这些例子不是我的代码，他们有是从我发现的另外两个例子中获得的。
我是 django 的相对初学者，所以很可能我错过了一些关键点。

Answer 4

我也有类似的要求。网上的大多数示例都要求创建模型并创建我不想使用的表单。这是我的最终代码。

if request.method == 'POST':
    file1 = request.FILES['file']
    contentOfFile = file1.read()
    if file1:
        return render(request, 'blogapp/Statistics.html', {'file': file1, 'contentOfFile': contentOfFile})

在要上传的 HTML 中我写道：

{% block content %}
    <h1>File content</h1>
    <form action="{% url 'blogapp:uploadComplete'%}" method="post" enctype="multipart/form-data">
         {% csrf_token %}
        <input id="uploadbutton" type="file" value="Browse" name="file" accept="text/csv" />
        <input type="submit" value="Upload" />
    </form>
    {% endblock %}

以下是显示文件内容的 HTML：

{% block content %}
    <h3>File uploaded successfully</h3>
    {{file.name}}
    </br>content = {{contentOfFile}}
{% endblock %}

Answer 5

扩展 Henry 的示例：

import tempfile
import shutil

FILE_UPLOAD_DIR = '/home/imran/uploads'

def handle_uploaded_file(source):
    fd, filepath = tempfile.mkstemp(prefix=source.name, dir=FILE_UPLOAD_DIR)
    with open(filepath, 'wb') as dest:
        shutil.copyfileobj(source, dest)
    return filepath

您可以调用此 < code>handle_uploaded_file 函数从您的视图中使用上传的文件对象。这将以唯一的名称（以原始上传文件的文件名为前缀）保存文件在文件系统中，并返回保存文件的完整路径。您可以将路径保存在数据库中，并稍后对该文件执行某些操作。

Answer 6

这里它可能对你有帮助：
在 models.py 中创建一个文件字段

用于上传文件（在 admin.py 中）：

def save_model(self, request, obj, form, change):
    url = "http://img.youtube.com/vi/%s/hqdefault.jpg" %(obj.video)
    url = str(url)

    if url:
        temp_img = NamedTemporaryFile(delete=True)
        temp_img.write(urllib2.urlopen(url).read())
        temp_img.flush()
        filename_img = urlparse(url).path.split('/')[-1]
        obj.image.save(filename_img,File(temp_img)

并在模板中使用该字段。

Answer 7

您可以参考 Fine Uploader 中的服务器示例，它有 django 版本。
https://github.com/FineUploader/server-examples /tree/master/python/django-fine-uploader

它非常优雅，最重要的是，它提供了特色的 js 库。服务器示例中不包含模板，但您可以在其网站上找到演示。
精细上传器： http://fineuploader.com/demos.html

django-fine-uploader

视图.py

UploadView 将发布和删除请求分派给各自的处理程序。

class UploadView(View):

    @csrf_exempt
    def dispatch(self, *args, **kwargs):
        return super(UploadView, self).dispatch(*args, **kwargs)

    def post(self, request, *args, **kwargs):
        """A POST request. Validate the form and then handle the upload
        based ont the POSTed data. Does not handle extra parameters yet.
        """
        form = UploadFileForm(request.POST, request.FILES)
        if form.is_valid():
            handle_upload(request.FILES['qqfile'], form.cleaned_data)
            return make_response(content=json.dumps({ 'success': True }))
        else:
            return make_response(status=400,
                content=json.dumps({
                    'success': False,
                    'error': '%s' % repr(form.errors)
                }))

    def delete(self, request, *args, **kwargs):
        """A DELETE request. If found, deletes a file with the corresponding
        UUID from the server's filesystem.
        """
        qquuid = kwargs.get('qquuid', '')
        if qquuid:
            try:
                handle_deleted_file(qquuid)
                return make_response(content=json.dumps({ 'success': True }))
            except Exception, e:
                return make_response(status=400,
                    content=json.dumps({
                        'success': False,
                        'error': '%s' % repr(e)
                    }))
        return make_response(status=404,
            content=json.dumps({
                'success': False,
                'error': 'File not present'
            }))

forms.py

class UploadFileForm(forms.Form):

    """ This form represents a basic request from Fine Uploader.
    The required fields will **always** be sent, the other fields are optional
    based on your setup.
    Edit this if you want to add custom parameters in the body of the POST
    request.
    """
    qqfile = forms.FileField()
    qquuid = forms.CharField()
    qqfilename = forms.CharField()
    qqpartindex = forms.IntegerField(required=False)
    qqchunksize = forms.IntegerField(required=False)
    qqpartbyteoffset = forms.IntegerField(required=False)
    qqtotalfilesize = forms.IntegerField(required=False)
    qqtotalparts = forms.IntegerField(required=False)

Answer 8

不确定这种方法是否有任何缺点，但在views.py中甚至更小：

entry = form.save()

# save uploaded file
if request.FILES['myfile']:
    entry.myfile.save(request.FILES['myfile']._name, request.FILES['myfile'], True)

Answer 9

我遇到了类似的问题，并通过 django 管理站点解决了。

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

    def doc_name(self):
        return self.docfile.name.split('/')[-1] # only the name, not full path

# admin
from myapp.models import Document
class DocumentAdmin(admin.ModelAdmin):
    list_display = ('doc_name',)
admin.site.register(Document, DocumentAdmin)

Answer 10

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

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

更新 2013-01-30： GitHub 上的源代码除了 Django 1.3 之外还实现了 Django 1.4。尽管有一些变化，以下教程对于 1.4 也很有用。

2013-05-10 更新： GitHub 上的 Django 1.5 实现。 urls.py 中的重定向和 list.html 中 url 模板标记的使用进行了细微更改。感谢 hubert3 的努力。

2013-12-07 更新： GitHub 支持 Django 1.6。 myapp/urls.py 中的一项导入发生了变化。感谢 Arthedian。

2015-03-17 更新： GitHub 支持 Django 1.7，感谢 aronysidoro。

更新 2015-09-04： GitHub 支持 Django 1.8，感谢 nerogit。

2016-07-03 更新： GitHub 支持 Django 1.9，感谢 daavve 和 < a href="https://github.com/nerogit" rel="noreferrer">nerogit

项目树

一个基本的 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

为了更好地处理上传，您需要一个表单。该表格只有一个字段，但这已经足够了。有关详细信息，请参阅表单文件字段参考。

# -*- 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 .静态参考了解详细信息。另请参阅有关服务的讨论媒体文件。

# -*- 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/
 7. 模板：myproject/myapp/templates/myapp/list.html
最后一部分：列表及其下面的上传表单的模板。表单必须将 enctype-attribute 设置为“multipart/form-data”并将方法设置为“post”才能上传到 Django。有关详细信息，请参阅文件上传文档。
 FileField 有许多可在模板中使用的属性。例如模板中的 {{ document.docfile.url }} 和 {{ document.docfile.name }} 。有关这些内容的更多信息，请参阅在模型中使用文件一文 和 File 对象文档。
<!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/ 并可以从列表中打开。
我希望这个答案能帮助别人，就像它对我有帮助一样。
, 'list', name='list'),
)

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

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

FileField 有许多可在模板中使用的属性。例如模板中的 {{ document.docfile.url }} 和 {{ document.docfile.name }} 。有关这些内容的更多信息，请参阅在模型中使用文件一文 和 File 对象文档。

8.初始化

只需运行syncdb和runserver。

结果

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

我希望这个答案能帮助别人，就像它对我有帮助一样。