django项目中使用FastDFS

Posted 2021-01-10 itelephant

FastDFS客户端与自定义文件存储系统

1. FastDFS的Python客户端

python版本的FastDFS客户端使用说明参考https://github.com/jefforeilly/fdfs_client-py

安装

安装提供给大家的fdfs_client-py-master.zip到虚拟环境中

pip install fdfs_client-py-master.zip
pip install mutagen
pip isntall requests

使用

使用FastDFS客户端，需要有配置文件。我们在meiduo_mall/utils目录下新建fastdfs目录，将提供给大家的client.conf配置文件放到这个目录中。

需要修改一下client.conf配置文件

base_path=FastDFS客户端存放日志文件的目录
tracker_server=运行tracker服务的机器ip:22122

上传文件需要先创建fdfs_client.client.Fdfs_client的对象，并指明配置文件，如

from fdfs_client.client import Fdfs_client
client = Fdfs_client(‘meiduo_mall/utils/fastdfs/client.conf‘)

通过创建的客户端对象执行上传文件的方法

client.upload_by_filename(文件名)
或
client.upload_by_buffer(文件bytes数据)

如：

>>> ret = client.upload_by_filename(‘/Users/delron/Desktop/1.png‘)
getting connection
<fdfs_client.connection.Connection object at 0x1098d4cc0>
<fdfs_client.fdfs_protol.Tracker_header object at 0x1098d4908>
>>> ret
{‘Group name‘: ‘group1‘, ‘Remote file_id‘: ‘group1/M00/00/02/CtM3BVr-k6SACjAIAAJctR1ennA809.png‘, ‘Status‘: ‘Upload successed.‘, ‘Local file name‘: ‘/Users/delron/Desktop/1.png‘, ‘Uploaded size‘: ‘151.00KB‘, ‘Storage IP‘: ‘10.211.55.5‘}
>>>

• Remote file_id 即为FastDFS保存的文件的路径

2. 自定义Django文件存储系统

在学习Django框架的时候，我们已经讲过，Django自带文件存储系统，但是默认文件存储在本地，在本项目中，我们需要将文件保存到FastDFS服务器上，所以需要自定义文件存储系统。

自定义文件存储系统的方法如下：

1）需要继承自django.core.files.storage.Storage，如

from django.core.files.storage import Storage
?
class FastDFSStorage(Storage):
    ...

2）支持Django不带任何参数来实例化存储类，也就是说任何设置都应该从django.conf.settings中获取

 1 from django.conf import settings
 2 from django.core.files.storage import Storage
 3 ?
 4 class FasfDFSStorage(Storage):
 5     def __init__(self, base_url=None, client_conf=None):
 6         if base_url is None:
 7             base_url = settings.FDFS_URL
 8         self.base_url = base_url
 9         if client_conf is None:
10             client_conf = settings.FDFS_CLIENT_CONF
11         self.client_conf = client_conf

 

3）存储类中必须实现_open()和_save()方法，以及任何后续使用中可能用到的其他方法。

• _open(name, mode=‘rb‘)

  被Storage.open()调用，在打开文件时被使用。

• _save(name, content)

  被Storage.save()调用，name是传入的文件名，content是Django接收到的文件内容，该方法需要将content文件内容保存。

  Django会将该方法的返回值保存到数据库中对应的文件字段，也就是说该方法应该返回要保存在数据库中的文件名称信息。

• exists(name)

  如果名为name的文件在文件系统中存在，则返回True，否则返回False。

• url(name)

  返回文件的完整访问URL

• delete(name)

  删除name的文件

• listdir(path)

  列出指定路径的内容

• size(name)

  返回name文件的总大小

  注意，并不是这些方法全部都要实现，可以省略用不到的方法。

4）需要为存储类添加django.utils.deconstruct.deconstructible装饰器

我们在meiduo_mall/utils/fastdfs目录中创建fdfs_storage.py文件，实现可以使用FastDFS存储文件的存储类如下

 1 from django.conf import settings
 2 from django.core.files.storage import Storage
 3 from django.utils.deconstruct import deconstructible
 4 from fdfs_client.client import Fdfs_client
 5 ?
 6 ?
 7 @deconstructible
 8 class FasfDFSStorage(Storage):
 9     def __init__(self, base_url=None, client_conf=None):
10         """
11         初始化
12         :param base_url: 用于构造图片完整路径使用，图片服务器的域名
13         :param client_conf: FastDFS客户端配置文件的路径
14         """
15         if base_url is None:
16             base_url = settings.FDFS_URL
17         self.base_url = base_url
18         if client_conf is None:
19             client_conf = settings.FDFS_CLIENT_CONF
20         self.client_conf = client_conf
21 ?
22     def _open(self, name, mode=‘rb‘):
23         """
24         用不到打开文件，所以省略
25         """
26         pass
27 ?
28     def _save(self, name, content):
29         """
30         在FastDFS中保存文件
31         :param name: 传入的文件名
32         :param content: 文件内容
33         :return: 保存到数据库中的FastDFS的文件名
34         """
35         client = Fdfs_client(self.client_conf)
36         ret = client.upload_by_buffer(content.read())
37         if ret.get("Status") != "Upload successed.":
38             raise Exception("upload file failed")
39         file_name = ret.get("Remote file_id")
40         return file_name
41 ?
42     def url(self, name):
43         """
44         返回文件的完整URL路径
45         :param name: 数据库中保存的文件名
46         :return: 完整的URL
47         """
48         return self.base_url + name
49 ?
50     def exists(self, name):
51         """
52         判断文件是否存在，FastDFS可以自行解决文件的重名问题
53         所以此处返回False，告诉Django上传的都是新文件
54         :param name:  文件名
55         :return: False
56         """
57         return False

 

3. 在Django配置中设置自定义文件存储类

在settings/dev.py文件中添加设置

# django文件存储, 指定自定义的文件存储系统
DEFAULT_FILE_STORAGE = ‘meiduo_mall.utils.fastdfs.fdfs_storage.FastDFSStorage‘
?
# FastDFS
FDFS_URL = ‘http://image.meiduo.site:8888/‘  
FDFS_CLIENT_CONF = os.path.join(BASE_DIR, ‘utils/fastdfs/client.conf‘)

 

4. 添加image域名

在/etc/hosts中添加访问FastDFS storage服务器的域名

127.0.0.1   image.meiduo.site