Django storage for Qiniu Cloud Storage
Project description
Django storage for 七牛云存储
Install
pip install django-qiniu-storage
Configurations
Django Qiniu Storage 需要以下几个配置才能正常工作。这些配置通过可以环境变量或 settings.py 来设置。环境变量的优先级要高于 settings.py 。
Django Settings / Environment Variable |
说明 |
---|---|
QINIU_ACCESS_KEY |
七牛给开发者分配的 AccessKey |
QINIU_SECRET_KEY |
七牛给开发者分配的 Secret |
QINIU_BUCKET_NAME |
用来存放文件的七牛空间(bucket)的名字 |
QINIU_BUCKET_DOMAIN |
七牛空间(bucket)的域名 |
QINIU_SECURE_URL |
是否通过 HTTPS 来访问七牛云存储上的资源(若为’是’, 可填True, true 或 1;若为’否’, 可填False, false 或 0) |
关于 HTTPS域名配置的详情, 可以参考七牛官方文档 如何通过 SSL 的形式来访问七牛云存储上的资源
Usage
如果你对 Django 的 Storage 系统尚不熟悉的话, Django 官方文档中的这几篇: Managing files, Managing static files, The staticfiles app 都是很不错的阅读材料。 建议阅读完后, 再看本教程。
用例1: 只用七牛托管动态生成的文件(例如用户上传的文件)
在 settings.py 里设置 DEFAULT_FILE_STORAGE :
DEFAULT_FILE_STORAGE = 'qiniustorage.backends.QiniuStorage'
用例2: 用七牛托管动态生成的文件以及站点自身的静态文件
首先,检查你的 INSTALLED_APPS setting, 确保安装了 django.contrib.staticfiles 这个 app。
staticfiles 提供了一个名为 collectstatic 的命令。 它会收集各个 app 的根目录下的 static 子目录下的文件, 并汇总到一个地方。如果将 django settings 里的 STATICFILES_STORAGE 设置为 QiniuStorage, 收集到的静态文件就会被统一上传到七牛。
Documentation
It’s hosted on the Read The Doc.
Changelog
2.0.0 使用 7.x 版本的 Python SDK。同时支持 Python 2 和 Python 3, 但也因此不再支持 Django 1.4。
新建 ”1.x“ 分支。 今后主分支将使用 7.x 版本的 Python SDK。2.x 会同时支持 Python 2 和 Python 3。
1.2.0 主要是测试方面的改进。利用 Travic CI 对 (Python 2.6, 2.7)×( Django 1.4 -1.7) 的每个组合都跑一遍单元测试。
1.1.0 加上了比较完整的单元测试。Django 1.7 相关的 bug fix.
1.0.1 Bug fix. 使用 6.x 版本的 七牛 Python SDK.
License
基于MIT许可证发布
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django-qiniu-storage-2.2.3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 62e6588f25eb27a22c2a33da05af7f7120a05a84f8a3ca26b40dd9cce80c9769 |
|
MD5 | 64bf0ac1a2b9f2143a4f90908acae4bb |
|
BLAKE2b-256 | c55e661357c24b4fe8e3cc9470d15ea4a4372d242c7bb9538b914a2c41c4a5d1 |
Hashes for django_qiniu_storage-2.2.3-py2-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8eeac748c965d0566ba78753764a8595aeaa5cd82c4ceb57a9cf2d134e773120 |
|
MD5 | 36e4d4516651bff0f77171165a29c55b |
|
BLAKE2b-256 | f11d1efc416a2ac606abd3050822cf97600d84c39f6680d598ff4e875457bc0c |