如何在Django中上传文件?[关闭]


668

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

Answers:


1273

ew,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-05-10: GitHub上Django 1.5的实现。urls.py中重定向的微小变化以及list.html中url模板标记的用法。感谢hubert3的努力。

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

更新2015-03-17: GitHub支持Django 1.72015年3月 aronysidoro

更新2015-09-04: GitHub支持Django 1.82015年9月4 nerogit

2016年7月3更新:由于daavve,GitHub上支持Django 1.9 7月3nerogit

项目树

一个基本的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 /,并且可以从列表中打开。

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


9
在Django文档中找到了显示文件上传的位置。此答案中的示例非常好,但是django文档中的信息将与新版本保持同步。 docs.djangoproject.com/en/dev/topics/http/file-uploads
TaiwanGrapefruitTea 2012年

1
该示例不适用于Django“ 1.5”。在HTML中{% url list %}成为{% url "list" %}
Matthieu Riegler 2013年

4
非常感谢你 。它真的对我有用。但是,对于即将到来的查看器,您应该检查gitHub中的代码以与新版本的Python和Django取得最佳兼容性。例如,views.py,render_to_response()应该替换为render(request,...,)以避免CSRF错误。干杯。
惠比

1
没有FORMMS,有可能这样做吗?
Roel

1
该文件可以是.zip还是其他压缩文件?
qg_java_17137

75

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

如果要获取文件,则需要在某处的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

里面有大量的信息 文件上传文档中

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


10
谢谢亨利。实际上,我已经阅读了文档并编写了一些代码,但是由于文档存在一些差距(例如“从某处导入handle_uploaded_file”),并且我的代码有缺陷,所以我认为如果可以从一个工作示例开始,那会更好。
qliq 2011年

26
同意qliq。一个简单的工作示例是让新手去,而不是文档的最有效的方式
Philip007

11
enctype="multipart/form-data"我要做这项工作所需的东西,谢谢!
john-charles 2013年

5
只是不要错过表单标签中的{%csrf_token%}。
jonincanada

可以不使用FORMS.PY的FORMS进行此操作吗?
Roel

71

演示版

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

最小的Django文件上传示例

1.创建一个django项目

运行startproject ::

$ django-admin.py startproject sample

现在创建一个文件夹(sample)。

2.创建一个应用

创建一个应用程序:

$ cd sample
$ python manage.py startapp uploader

现在uploader,将创建包含以下文件的folder()::

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_ROOTMEDIA_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 /


2
完美,除了最后一行-应该是localhost.com:8000/upload >这适用于django 1.6和Python 3.3。
史蒂夫

5
+1用于可重复使用的django应用程序设计模式
Marcel 2014年

1
阿克塞利(Akseli)用了一段FileField时间,苏哈伊尔(suhail)用了ImageField,有人可以解释一下选择吗?
dvtan

@dtgq我更新了与结合使用的答案FileFieldImageField仅用于图片上传。该更新将在Django 1.11上运行。
suhailvs

在Django 2.0上进行了测试,并且运行良好
diek '18

29

我必须说我发现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的相对入门者,因此很可能我错过了一些关键点。


3
+1(表示不使用a FileField和a)model.Form。对于初学者(以及琐碎的任务),如上所示,手动处理上载的文件会减少混乱。
AneesAhmed777 '17

文件写入字节时,dest = open(path,'wb')
Bipul Roy

20

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

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 %}

很好,因为有时只是想使用文件内容而不保存上载...
nemesisfixx

17

扩展亨利的例子

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

您可以handle_uploaded_file从视图中使用上载的文件对象调用此函数。这将在文件系统中使用唯一名称(以原始上载文件的文件名作为前缀)保存文件,并返回已保存文件的完整路径。您可以将路径保存在数据库中,以后再对文件进行处理。


Imran,我在视图上尝试了您的代码,但收到此错误:'WSGIRequest'对象没有属性'name'。
2011年

2
将上传的文件对象(request.FILES['myfile'])传递给handle_uploaded_file,而不是request本身。
伊兰(Imran)

我可以直接将其保存到数据库吗?stackoverflow.com/questions/24705246/...
AlexandruC

通过使用prefix=source.name它,在文件末尾添加了额外的字符,使文件扩展名混乱。例如upload.csv更改为upload.csv5334。对其进行更改以对其进行suffix=source.name修复。
Tahreem Iqbal

13

在这里它可以为您提供帮助:在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)

并在模板中也使用该字段。


1
当您必须手动调整要保存的文件时,这很有用。如果是这样,您可能还需要以下部分:docs.djangoproject.com/en/dev/topics/files/#the-file-object
kecske 2014年

11

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

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

django-fine-uploader

views.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'
            }))

表格

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)

7

不知道这种方法是否有任何缺点,但在views.py中甚至更为不利:

entry = form.save()

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

0

我遇到了类似的问题,并由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)

[在此处输入链接描述] [1] [在此处输入链接描述] [1]:youtu.be/0tNZB3dyopY [2]:youtu.be/klhMYMc3PlY
uda123
By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.