在 Django 中使用 Cloudinary

Cloudinary是一个用于存储和管理图片和视频的云服务，能够在Web应用程序中实现强大的媒体管理功能。Django是一个流行的Python Web框架，其提供了丰富的工具和库，使得使用Cloudinary在Django应用程序中实现图片和视频管理非常容易。

安装Cloudinary

要在Django应用程序中使用Cloudinary，首先需要安装Python的Cloudinary SDK。可以使用以下命令安装：

pip install cloudinary

配置Cloudinary

在使用Cloudinary SDK之前，需要配置Cloudinary帐户。在Cloudinary网站上注册一个帐户，然后在Dashboard中找到API密钥和API密钥密码。这些值将用于在Django应用程序中进行身份验证。

一般来说，将API密钥和密钥密码存储在应用程序的环境变量中，而不是直接在代码中硬编码。为此，可以使用environs库。以下是在Django中设置Cloudinary帐户的示例代码：

from environs import Env
import cloudinary

env = Env()
env.read_env()

cloudinary.config(
    cloud_name=env.str('CLOUDINARY_CLOUD_NAME'),
    api_key=env.str('CLOUDINARY_API_KEY'),
    api_secret=env.str('CLOUDINARY_API_SECRET')
)

将上述代码添加到Django应用程序中的一个配置文件中，例如settings.py。

上传图片

要在Django应用程序中上传并存储图像，可以使用Cloudinary SDK提供的uploda()方法。可以将图像作为文件对象或URL传递。

以下是使用Cloudinary SDK上传图像的示例代码：

from django.shortcuts import render
import cloudinary.uploader

def my_view(request):
    file_to_upload = request.FILES['file']
    result = cloudinary.uploader.upload(file_to_upload)
    return render(request, 'my_template.html', {'result': result})

在上面的代码中，我们使用Django的request.FILES属性获取上传的图像，并使用cloudinary.uploader.upload()方法将其上传到Cloudinary。上传方法返回上传文件信息，可以将其用于保存Cloudinary URL或其他操作。

显示存储的图片

要在Django应用程序中显示Cloudinary中存储的图像，可以使用Cloudinary提供的Django插件。可以使用以下命令安装插件：

pip install cloudinary-storage

在Django应用程序中使用插件后，可以使用CloudinaryField字段类型将字段与Cloudinary存储关联。以下是使用插件在Django模型中添加CloudinaryField的示例：

from django.db import models
from cloudinary_storage.storage import RawMediaCloudinaryStorage

class MyModel(models.Model):
    image = models.ImageField(
        upload_to='uploads/',
        storage=RawMediaCloudinaryStorage()
    )
    # 其他字段

在上面的代码中，我们使用RawMediaCloudinaryStorage存储类型将ImageField字段与Cloudinary存储关联。upload_to属性指定存储路径。使用CloudinaryField类型可以轻松显示和管理存储的图像。

当要显示以CloudinaryField类型存储的图像时，可以使用<img>标签，将其src属性设置为存储在Cloudinary中的URL。以下是在Django模板中显示CloudinaryField的示例：

{% load cloudinary %}
<img src="{% cloudinary photo.image %}" alt="">

在上面的代码中，我们使用cloudinary加载器和{% cloudinary %}标记轻松地将CloudinaryField类型转换为Cloudinary URL，然后将其设置为<img>标记的src属性。

结论

通过使用Cloudinary SDK和Django插件，可以轻松实现在Django应用程序中存储、上传、显示和管理图像的功能。以上示例代码演示了基本功能，但可以根据应用程序的需要进行扩展和定制。