django实现后台显示媒体文件

1. 前言

随着web应用的快速发展，后台管理系统已经成为了现代应用程序的重要组成部分，而媒体文件在各种企业级应用中也是非常重要的一部分。在django中，我们可以很方便地实现后台管理媒体文件的功能，这也是本文要介绍的内容。

2. 配置

2.1 MEDIA_ROOT和MEDIA_URL

在django中，我们需要先设置MEDIA_ROOT和MEDIA_URL。MEDIA_ROOT是媒体文件的存储位置，而MEDIA_URL是媒体文件访问的url地址。这两个设置的值，通常是在settings.py里进行配置。

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

其中，MEDIA_ROOT是使用os.path.join()函数将BASE_DIR和'media'路径组合起来，'media'路径就是媒体文件存放的位置。而MEDIA_URL则是访问这些媒体文件的url地址。这里我们让MEDIA_URL为'/media/'。

2.2 settings.py其他配置

在settings.py文件中，我们还需要做以下配置：

# settings.py
STATIC_URL = '/static/'
STATICFILES_DIRS = [
    os.path.join(BASE_DIR, 'static')
]
STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')

这里，STATIC_URL是静态文件的访问url地址，STATICFILES_DIRS是静态文件存放的位置，STATIC_ROOT是静态文件部署到生产环境的位置。

在最后，我们需要在urls.py中进行url配置：

# urls.py
from django.conf.urls.static import static
from django.conf import settings
urlpatterns = [
    # ... other url patterns
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

这里，我们使用了static()函数，将MEDIA_URL的值和MEDIA_ROOT的值传递给了函数，实现了在开发环境中显示媒体文件和在生产环境中发布静态文件和媒体文件的功能。

3. 上传媒体文件

在django中，我们可以使用django的内置视图来实现媒体文件的上传。具体来说，我们可以使用FormView视图来实现上传表单的显示和提交。

3.1 forms.py

首先，我们需要创建一个表单模型，用于用户上传文件时的验证。

# forms.py
from django import forms
class UploadFileForm(forms.Form):
    title = forms.CharField(max_length=50)
    file = forms.FileField()

我们这里定义了表单包含一个title和一个file，file是上传文件需要使用的filefield。

3.2 upload.html

这里我们需要创建一个上传媒体文件的html页面。页面中包含了一个表单，用于用户上传文件。

# upload.html
{% extends "base.html" %}
{% block content %}
  
Upload Media Files
  

    {% csrf_token %}
    {{ form.as_p }}
    Save
  

{% endblock %}

这里，我们使用{% extends %}继承了base.html模板，使用{{ form.as_p }}展示了表单，并使用{% csrf_token %}增加了csrf_token的验证。

3.3 views.py

接着，我们需要在视图中定义如何处理表单的提交。具体来说，我们可以使用FormView视图来实现上传表单的显示和提交。

# views.py
from django.urls import reverse_lazy
from django.views.generic.edit import FormView
from .forms import UploadFileForm
class FileFieldView(FormView):
    form_class = UploadFileForm
    template_name = 'upload.html'
    success_url = reverse_lazy('media')
    def form_valid(self, form):
        title = form.cleaned_data['title']
        f = form.cleaned_data['file']
        media = Media(title=title, file=f)
        media.save()
        return super().form_valid(form)

这里我们使用了FormView视图，其中包含表单的验证、展示和处理。我们可以看到这里只需要传入模板、表单、成功后的跳转url等参数即可。

4. 显示媒体文件

现在我们已经把媒体文件上传到了MEDIA_ROOT的路径下，下一步是如何在web页面中显示这些媒体文件。一种常见的方式是使用django内置的视图TemplateView。

4.1 models.py

为了存储媒体文件，我们需要在models.py文件中创建一个模型。

# models.py
from django.db import models
class Media(models.Model):
    title = models.CharField(max_length=255)
    file = models.FileField(upload_to='media/')

在这里，我们定义了该模型包含一个title和一个file，file是文件上传文件需要使用的filefield。同时我们使用了upload_to参数，表示该媒体文件被上传后会被保存在'media/'路径下。

4.2 media.html

这里我们需要创建一个html页面，用于展示MEDIA_ROOT目录下的所有媒体文件。

# media.html
{% extends "base.html" %}
{% block content %}
  
Media Files
  
    {% for media in media_list %}
      {{ media.title }}
    {% empty %}
      No media files available.
    {% endfor %}
  
{% endblock %}

在这里，我们使用{% for %}循环来遍历MEDIA_ROOT目录下的所有媒体文件，并使用标签将文件名设置为链接。

# views.py
from django.views.generic import TemplateView
from .models import Media
class MediaView(TemplateView):
    template_name = 'media.html'
    def get_context_data(self, **kwargs):
        media_list = Media.objects.all()
        context = super().get_context_data(**kwargs)
        context['media_list'] = media_list
        return context