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.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | e001a23c0cf57886b90c752b02605e67fe8657c119444ff4638234d86d37b6a6 |
|
MD5 | c525faf253c460421dca107fae3dc96d |
|
BLAKE2b-256 | e9dd2d6ef5ea68076cf24c5f488cac6477e0f7dec0bd44c2c825b8e2a74d05bf |
Hashes for django_qiniu_storage-2.2.0-py2-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 98c201233291d106366a0fadaa58794771ad8f4fe279ef390150a2cc83fe7124 |
|
MD5 | d809232e8da0d1cd044952d1f56f5abe |
|
BLAKE2b-256 | d5fe4f1f45b7061a3bce2f73d435511c75e22ea8bec2922f8f2e995c97704bc5 |