Django配置默认使用FDFS进行文件存储

1. FDFS文件上传与访问

  • 通过python代码向FDFS系统上传文件
from fdfs_client.client import Fdfs_client
# 创建Fdfs_client对象
client = Fdfs_client('<fdfs客户端配置文件路径>')
# 上传文件
client.upload_by_filename(文件路径)
或
client.upload_by_buffer(文件内容)
  • 上传结果:
{
  'Group name': 'group1',
  'Local file name': '/Users/smart/Desktop/1.jpg',
  'Storage IP': '172.16.179.139',
  'Remote file_id': 'group1/M00/00/03/rBCzi10HvhOAbpotAAAi00HB9mU322.jpg',
  'Uploaded size': '8.00KB',
  'Status': 'Upload successed.'
}
  • 通过浏览器访问上传的图片需借助nginx


    Snipaste_2019-07-14_11-26-58.png

注:docker中的storage启动时已经配置内部启动了一个nginx服务器,该nginx服务器监听的端口为8888,我们可以借助于此nginx访问到fdfs文件存储系统中的文件。

假如nginx服务器的地址为:172.16.179.139,则访问上面上传图片的地址为

http://172.16.179.139:8888/group1/M00/00/03/rBCzi10HvhOAbpotAAAi00HB9mU322.jpg

2. Django框架文件保存流程

  • 在Django框架中,如果模型中含有FileField或ImageField文件字段,
class TestModel(models.Model):
    file = models.FileField(...)
    # 或
    file = models.ImageField(...)

当通过模型类新增或更新数据时,会自动调用默认文件存储类中的_save方法进行文件存储,并将_save方法的返回值作为内容添加到对应表的字段中

  • Django默认存储类是通过DEFAULT_FILE_STORAGE配置项指定的,其默认为
DEFAULT_FILE_STORAGE='django.core.files.storage.FileSystemStorage'

FileSystemStorage文件存储类中的_save方法默认将文件存储在MEDIA_ROOT指定的目录下方

3. 自定义FDFS文件存储类

  • 自定义储存类必须是django.core.files.storage.Storage的子类
  • Django必须能够不带任何参数来实例化你的储存类这意味着任何设置都应该从django.conf.settings中获取
  • 你的储存类必须实现_save和exists方法,以及任何适合于你的储存类的其它方法

Django在调_save之前会先调exists判断文件名和系统中原有的文件名是否冲突

from django.core.files.storage import Storage
from django.conf import settings

from fdfs_client.client import Fdfs_client


class FDFSStorage(Storage):
    """FDFS自定义文件存储类"""
    def __init__(self, client_conf=None, base_url=None):
        if client_conf is None:
            # FDFS的配置文件路径,在settibgs中配置
            client_conf = settings.FDFS_CLIENT_CONF

        self.client_conf = client_conf

        if base_url is None:
            # nginx服务器的地址,在setting中配置
            base_url = settings.FDFS_URL

        self.base_url = base_url

    def _save(self, name, content):
        """
        name: 上传文件的名称
        content: 包含上传文件内容的File对象,content.read()获取上传文件内容
        """
        client = Fdfs_client(self.client_conf)

        # 上传文件到FDFS系统
        res = client.upload_by_buffer(content.read())

        if res.get('Status') != 'Upload successed.':
            raise Exception('上传文件到FDFS系统失败')

        # 获取返回的文件id
        file_id = res.get('Remote file_id')

        return file_id

    def exists(self, name):
        """
        判断上传文件的名称和文件系统中原有的文件名是否冲突
        name: 上传文件的名称
        """
        # 不冲突返回false
        return False

    def url(self, name):
        # 将返回的file_id和nginx的地址拼接
        return self.base_url + name
  • 修改Django框架的默认文件存储类
DEFAULT_FILE_STORAGE='meiduo_mall.utils.fdfs.storage.FDFSStorage'
  • 当我们通过该模型类的对象.该文件字段.url会调用自定义文件存储类中的url方法得到访问地址
# 得到一个模型类对象
sku_image = SKUImage.objects.get(id=1)
# 通过对象.该字段获得的是一个FileField的对象
sku_iamge.image
# 获得地址
sku_image.image.url

推荐阅读更多精彩内容