需要一个最小的Django文件上传示例

作为Django的新手,我很难在Django 1.3中创建一个上传应用程序。 我找不到任何最新的示例/片段。 有人可能会发布一个最小但完整的(Model,View,Template)示例代码来执行此操作吗?


Phew,Django文档对此没有很好的例子。 我花了2个多小时挖掘所有的部分,以了解这是如何工作的。 有了这些知识,我实现了一个项目,可以上传文件并将它们显示为列表。 要下载项目的源代码,请访问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的源代码除了1.3之外,还为Django 1.4提供了实现。 尽管几乎没有变化,但以下教程对于1.4也很有用。

更新2013-05-10:在GitHub上实现Django 1.5。 在urls.py中重定向的细微变化和在list.html中使用url模板标签。 感谢hubert3的努力。

Update 2013-12-07: Django 1.6支持GitHub。 在myapp / urls.py中更改了一个导入。 谢谢去Arthedian。

更新2015-03-17:由于aronysidoro,Django 1.7支持GitHub。

更新2015-09-04:在GitHub上支持Django 1.8,感谢nerogit。

更新2016-07-03: Django 1.9支持GitHub,感谢daavve和nerogit

项目树

一个基本的Django 1.3项目,具有单个应用程序和媒体/目录用于上传。

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为其提供服务的网址。 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

为了处理上传,你需要一个表单。 这种形式只有一个领域,但这已经足够了。 详情请参阅Form 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.应用网址:myproject / myapp / urls.py

要使视图可访问,您必须为其指定urls。 没什么特别的。

# -*- 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>

这会给你浏览按钮,一个上传按钮来启动操作(提交表单)并记下这个Django知道给你的request.FILES

在某个地方你可以访问该文件

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

文件上传文档中有大量信息

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


AkseliPalén的回答更新。 看到github回购,与Django 2合作

一个最小的Django文件上传示例

1.创建一个django项目

运行startproject ::

$ django-admin.py startproject sample

现在创建一个文件夹( 样本 )::

sample/
  manage.py
  sample/
    __init__.py
    settings.py
    urls.py
    wsgi.py 

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.apps.UploaderConfig'INSTALLED_APPS并添加MEDIA_ROOTMEDIA_URL ,即::

INSTALLED_APPS = (
    ...<other apps>...
    'uploader.apps.UploaderConfig',
)

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.home, name='imageupload'),
]+ static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

5.更新models.py

更新uploader/models.py ::

from django.db import models
from django.forms import ModelForm

class Upload(models.Model):
    pic = models.FileField(upload_to="images/")    
    upload_date=models.DateTimeField(auto_now_add =True)

# FileUpload form class.
class UploadForm(ModelForm):
    class Meta:
        model = Upload
        fields = ('pic',)

6.更新views.py

更新uploader/views.py ::

from django.shortcuts import render
from uploader.models import UploadForm,Upload
from django.http import HttpResponseRedirect
from django.urls import reverse
# Create your views here.
def home(request):
    if request.method=="POST":
        img = UploadForm(request.POST, request.FILES)       
        if img.is_valid():
            img.save()  
            return HttpResponseRedirect(reverse('imageupload'))
    else:
        img=UploadForm()
    images=Upload.objects.all()
    return render(request,'home.html',{'form':img,'images':images})

7.创建模板

在文件夹uploader中创建一个文件夹模板 ,然后创建一个文件home.html ,即sample/uploader/templates/home.html ::

<div style="padding:40px;margin:40px;border:1px solid #ccc">
    <h1>picture</h1>
    <form action="#" method="post" enctype="multipart/form-data">
        {% csrf_token %} {{form}} 
        <input type="submit" value="Upload" />
    </form>
    {% for img in images %}
        {{forloop.counter}}.<a href="{{ img.pic.url }}">{{ img.pic.name }}</a>
        ({{img.upload_date}})<hr />
    {% endfor %}
</div>

8.同步数据库

Syncronize数据库和runserver ::

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

请访问http://localhost.com:8000

链接地址: http://www.djcxy.com/p/38689.html

上一篇: Need a minimal Django file upload example

下一篇: Getting the SQL from a Django QuerySet