Python+django实现简单的文件上传

让我来详细讲解一下 Python + Django 实现简单的文件上传的完整攻略，其中包含两条示例说明。

一、背景

文件上传是大多数网站都需要实现的功能，一般可用于用户上传头像、文件等需求，使用 Django 实现文件上传可大大简化开发难度。

二、步骤

1. 在 Django 项目中创建上传文件的目录

首先，在 Django 项目的根目录下创建一个目录用于存储上传的文件。例如，我们在项目根目录下创建 upload 目录：

mkdir upload

2. 修改 Django 项目的配置文件

在 Django 项目的配置文件 settings.py 中，包含有上传文件的配置参数。找到 settings.py 中的 MEDIA_URL 和 MEDIA_ROOT，分别设置如下：

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

这里的 MEDIA_URL 是设置上传文件的访问路径，而 MEDIA_ROOT 是上传文件的根目录路径。以上配置将上传的文件存储到 upload 目录中。

3. 实现文件上传功能

在 Django 项目中，文件上传的流程如下：

用户在页面中选择需要上传的文件并提交表单。
Django 中的视图函数接收用户上传的文件。
将文件存储到指定的目录中。
在数据库中记录文件的信息。

以下是实现文件上传功能的步骤：

3.1 编写视图函数

在 Django 项目中，视图函数负责处理 HTTP 请求，并返回 HTTP 响应。在上传文件的场景中，我们需要编写一个视图函数用于接收用户上传的文件：

from django.shortcuts import render

def upload(request):
    if request.method == "POST":
        # 获取上传的文件对象
        file = request.FILES.get('file')
        # 将文件存储在 upload 目录下
        with open(f"upload/{file.name}", 'wb') as f:
            for chunk in file.chunks():
                f.write(chunk)
        return render(request, 'upload_success.html')
    else:
        return render(request, 'upload.html')

3.2 编写 HTML 模板

然后，在 Django 项目中，我们还需要编写 HTML 模板用于展示上传页面和上传成功页面：

上传页面 upload.html：

<form method="POST" enctype="multipart/form-data">
    {% csrf_token %}
    <input type="file" name="file">
    <button type="submit">上传</button>
</form>

上传成功页面 upload_success.html：

<p>上传成功！</p>

4. 运行 Django 项目

最后，我们需要启动 Django 项目来测试文件上传功能。在 Django 项目根目录下运行以下命令启动 Django 项目：

python manage.py runserver

然后，在浏览器中输入 http://localhost:8000/upload/ 访问上传页面，选择需要上传的文件并点击上传按钮，上传成功后显示上传成功页面。

三、示例

下面是两个实际的示例，演示了如何使用 Django 实现文件上传功能。

示例1：上传图片并预览

该示例演示了如何使用 Django 实现上传图片并在页面上实时预览。实现步骤如下：

使用 HTML5 中的 <input type="file"> 标签支持图片的预览和上传。
使用 jQuery 实现了图片预览的功能。
通过 Django 视图函数实现文件上传功能。

完整示例代码可查看这里。

示例2：上传文件到阿里云OSS

该示例演示了如何使用 Django 将文件上传到阿里云OSS相应的 Bucket 中。实现步骤如下：

在阿里云官网创建 Bucket。
安装依赖库 aliyun-python-sdk-oss。
在 Django 项目中编写文件上传视图函数，并在该函数中使用 OSS API 上传文件到 Bucket 中。