AWS S3与Django集成|极客笔记

AWS S3与Django集成

简介

Amazon Simple Storage Service（简称Amazon S3）是一种对象存储服务，可通过Internet在Web上存储和检索任何数量的数据。它是一个弹性、高可扩展、低延迟的云存储服务。Django是一种基于Python的Web应用程序框架，可以帮助开发者快速轻松地构建Web应用程序。

在本文中，我们将探讨如何将AWS S3与Django集成，以实现在Django应用程序中轻松地上传、下载和管理静态文件和媒体文件的功能。

准备工作

在开始本教程之前，您需要具备以下条件：

一个AWS账号并创建一个S3存储桶
安装Python和Django
安装boto3库（AWS SDK for Python）

安装boto3库的方法：

pip install boto3

配置AWS S3

首先，我们需要在AWS控制台上创建一个S3存储桶，用于存储我们的静态文件和媒体文件。在创建存储桶时，确保将其配置为公开可读，以便通过URL访问文件。

然后，我们需要创建一个AWS IAM用户并将其与S3存储桶关联，以便我们的Django应用程序可以使用该用户的凭据来访问S3存储桶。请务必将IAM用户的访问密钥和密钥ID保存好，以备后续在Django应用程序中使用。

在Django中配置AWS S3

接下来，我们需要在Django项目中进行一些配置，以便使其能够与AWS S3集成。

设置AWS S3凭据

打开Django项目的settings.py文件，在文件末尾添加以下代码：

AWS_ACCESS_KEY_ID = 'YOUR_AWS_ACCESS_KEY'
AWS_SECRET_ACCESS_KEY = 'YOUR_AWS_SECRET_KEY'
AWS_STORAGE_BUCKET_NAME = 'YOUR_S3_BUCKET_NAME'
AWS_S3_REGION_NAME = 'YOUR_S3_REGION'  # 例如：'us-west-1'
AWS_S3_CUSTOM_DOMAIN = f'{AWS_STORAGE_BUCKET_NAME}.s3.amazonaws.com'
AWS_DEFAULT_ACL = 'public-read'

请将上述代码中的YOUR_AWS_ACCESS_KEY、YOUR_AWS_SECRET_KEY、YOUR_S3_BUCKET_NAME和YOUR_S3_REGION替换为您的实际凭据信息。

配置静态文件和媒体文件存储后端

在settings.py文件中继续添加以下代码：

AWS_STATIC_LOCATION = 'static'
STATIC_URL = f'https://{AWS_S3_CUSTOM_DOMAIN}/{AWS_STATIC_LOCATION}/'
STATICFILES_STORAGE = 'storages.backends.s3boto3.S3Boto3Storage'

AWS_PUBLIC_MEDIA_LOCATION = 'media/public'
DEFAULT_FILE_STORAGE = 'your_app.storages.MediaStorage'
MEDIA_URL = f'https://{AWS_S3_CUSTOM_DOMAIN}/{AWS_PUBLIC_MEDIA_LOCATION}/'

创建存储类

创建一个名为storages.py的文件，在其中编写以下代码：

from storages.backends.s3boto3 import S3Boto3Storage

class MediaStorage(S3Boto3Storage):
    location = 'media'
    file_overwrite = False

修改urls.py文件

最后，在项目的urls.py文件中添加以下代码：

from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    # Your URL patterns here
]

if settings.DEBUG:
    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

现在，您已经完成了Django与AWS S3的集成配置。您可以在Django应用程序中开始上传、下载和管理静态文件和媒体文件。

示例代码

以下是一个简单的Django视图函数示例，用于上传文件到AWS S3：

from django.shortcuts import render
from django.core.files.storage import default_storage
from django.core.files.base import ContentFile
import uuid

def upload_file(request):
    if request.method == 'POST' and request.FILES['file']:
        file = request.FILES['file']
        file_name = f'{str(uuid.uuid4())}_{file.name}'

        default_storage.save(file_name, ContentFile(file.read()))

        return render(request, 'upload_success.html', {'file_name': file_name})

    return render(request, 'upload.html')

在上述示例中，我们接收来自前端的文件并保存到AWS S3中。同时，返回了上传成功的页面并展示了上传文件的名称。