Uf, la documentación de Django realmente no tiene un buen ejemplo al respecto. Pasé más de 2 horas para desenterrar todas las piezas para entender cómo funciona esto. Con ese conocimiento, implementé un proyecto que hace posible cargar archivos y mostrarlos como una lista. Para descargar el código fuente del proyecto, visite https://github.com/axelpale/minimal-django-file-upload-example o clónelo:
> git clone https://github.com/axelpale/minimal-django-file-upload-example.git
Actualización 2013-01-30: La fuente en GitHub también tiene implementación para Django 1.4 además de 1.3. Aunque hay pocos cambios, el siguiente tutorial también es útil para 1.4.
Actualización 2013-05-10: Implementación para Django 1.5 en GitHub. Cambios menores en la redirección en urls.py y el uso de la etiqueta de plantilla de url en list.html. Gracias a Hubert3 por el esfuerzo.
Actualización 2013-12-07: Django 1.6 compatible en GitHub. Una importación cambió en myapp / urls.py. Gracias a Arthedian .
Actualización 2015-03-17: Django 1.7 compatible con GitHub, gracias a aronysidoro .
Actualización 2015-09-04: Django 1.8 compatible con GitHub, gracias a nerogit .
Actualización 2016-07-03: Django 1.9 compatible con GitHub, gracias a daavve y nerogit
Árbol del proyecto
Un proyecto básico de Django 1.3 con una sola aplicación y directorio media / para cargas.
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. Configuración: myproject / settings.py
Para cargar y servir archivos, debe especificar dónde almacena Django los archivos cargados y desde qué URL Django los sirve. MEDIA_ROOT y MEDIA_URL están en settings.py de forma predeterminada pero están vacías. Vea las primeras líneas en Django Managing Files para más detalles. Recuerde también configurar la base de datos y agregar myapp a 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. Modelo: myproject / myapp / models.py
A continuación, necesita un modelo con un FileField. Este campo particular almacena archivos, por ejemplo, en medios / documentos / 2011/12/24 / según la fecha actual y MEDIA_ROOT. Consulte la referencia de FileField .
# -*- coding: utf-8 -*-
from django.db import models
class Document(models.Model):
docfile = models.FileField(upload_to='documents/%Y/%m/%d')
3. Formulario: myproject / myapp / forms.py
Para manejar bien la carga, necesita un formulario. Este formulario tiene solo un campo, pero eso es suficiente. Consulte la referencia del formulario FileField para obtener más detalles.
# -*- coding: utf-8 -*-
from django import forms
class DocumentForm(forms.Form):
docfile = forms.FileField(
label='Select a file',
help_text='max. 42 megabytes'
)
4. Vista: myproject / myapp / views.py
Una vista donde sucede toda la magia. Presta atención como request.FILES
se manejan. Para mí, fue realmente difícil detectar el hecho de que request.FILES['docfile']
se puede guardar en modelos. FileField así como así. Save () del modelo maneja el almacenamiento del archivo en el sistema de archivos automáticamente.
# -*- 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 del proyecto: myproject / urls.py
Django no sirve MEDIA_ROOT de forma predeterminada. Eso sería peligroso en el entorno de producción. Pero en la etapa de desarrollo, podríamos acortarnos. Presta atención a la última línea. Esa línea permite que Django sirva archivos de MEDIA_URL. Esto funciona solo en la etapa de desarrollo.
Consulte la referencia de django.conf.urls.static.static para obtener más detalles. Consulte también esta discusión sobre la publicación de archivos multimedia .
# -*- 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 de aplicaciones: myproject / myapp / urls.py
Para que la vista sea accesible, debe especificar sus URL. Nada especial aquí.
# -*- coding: utf-8 -*-
from django.conf.urls import patterns, url
urlpatterns = patterns('myapp.views',
url(r'^list/$', 'list', name='list'),
)
7. Plantilla: myproject / myapp / templates / myapp / list.html
La última parte: plantilla para la lista y el formulario de carga debajo de ella. El formulario debe tener el atributo enctype establecido en "multipart / form-data" y el método establecido en "post" para hacer posible la carga en Django. Consulte la documentación de Carga de archivos para más detalles.
FileField tiene muchos atributos que se pueden usar en plantillas. Por ejemplo, {{document.docfile.url}} y {{document.docfile.name}} como en la plantilla. Vea más sobre esto en el artículo Uso de archivos en modelos y en la documentación del objeto El archivo .
<!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. Inicializar
Simplemente ejecute syncdb y runserver.
> cd myproject
> python manage.py syncdb
> python manage.py runserver
Resultados
Finalmente, todo está listo. En el entorno de desarrollo predeterminado de Django, se puede ver la lista de documentos cargados en localhost:8000/list/
. Hoy los archivos se cargan en / path / to / myproject / media / documents / 2011/12/17 / y se pueden abrir desde la lista.
Espero que esta respuesta ayude a alguien tanto como me hubiera ayudado.
{% url list %}
convierte{% url "list" %}
.