七牛云js-sdk应用总结
基本思路
- 首先，整个七牛云sdk的思路是，先去服务器端拿uptoken，前段js来操作上传，后端部分这里采用php。
- js-sdk是依赖于plupload的，plupload是一个上传插件，所以应该下载的资源有，php-sdk,js-sdk以及plupload插件。另外,官网给的demo是基于bootstrap的，所以也要把bootstrap下载一下。
- 直接把官网给的demo跑通是最高效的熟悉方式。
- 将官网文档看一下，了解七牛云的工作流程以及代码。
准备工作和文件介绍
- 首先，你应该已经注册了七牛云的账号，进入‘对象存储’，创建了一个空间，会看到一个类似下面这样的域名
ogd29n56i.bkt.clouddn.com
在“个人面板”->“秘钥管理”应该也能看到你自己的秘钥对。
- 下载qiniu/php-sdk,js-sdk,plupload,bootstrap
- js-sdk中包含了官网的demo，在index.html中引入前面下载的资源，加载顺序要注意一下：
css
<link rel="stylesheet" type="text/css" href="{{url('/qiniu/bootstrap/css/bootstrap.css')}}">
<link rel="stylesheet" type="text/css" href="{{url('/qiniu/js/highlight/highlight.css')}}">
js部分
<script type="text/javascript" src="{{url('/qiniu/js/jquery.js')}}"></script>
<script type="text/javascript" src="{{url('/qiniu/js/plupload/plupload.full.min.js')}}"></script>
<script type="text/javascript" src="{{url('/qiniu/js/plupload/i18n/zh_CN.js')}}"></script>
<script type="text/javascript" src="{{url('/qiniu/js/qiniu.js')}}"></script>
<script type="text/javascript" src="{{url('/qiniu/js/ui.js')}}"></script>
<script type="text/javascript" src="{{url('/qiniu/js/main.js')}}"></script>
关于js引入的顺序，plupload是基于jquery的，而七牛的sdk又是基于plupload的，所以应该先引入jquery再plupload，再qiniu.js，那么main.js和ui.js是什么呢？
main.js是云存储的初始化代码，就是七牛js-sdk官网文档的“上传”部分的代码。
在这部分代码中，有关于初始化的属性设置，例如：
var uploader = Qiniu.uploader({
runtimes: 'html5,flash,html4',
browse_button: 'pickfiles',
container: 'container',
drop_element: 'container',
max_file_size: '1000mb',
flash_swf_url: 'bower_components/plupload/js/Moxie.swf',
dragdrop: true,
chunk_size: '4mb',
......
也有回调函数和数据，例如
'BeforeUpload': function(up, file) {
var progress = new FileProgress(file, 'fsUploadProgress');
var chunk_size = plupload.parseSize(this.getOption('chunk_size'));
if (up.runtime === 'html5' && chunk_size) {
progress.setChunkProgess(chunk_size);
}
},
上面这个函数定义了上传开始之前的动作，括号内的up和file是两个对象，里面包含了关于在上传这个文件的所有信息，可以将他们打印出来看看。
同样的，也有上传中，上传完成后等等回调函数。那么在这些函数中经常会进行一些DOM操作，本例中，将这些DOM操作都封装在ui.js中。好了，这几个文件介绍好之后，现在开始正式看看，七牛云是怎样工作的。
具体操作流程
因为整个流程是围绕main.js展开的，我们就按照这个文件来展开介绍七牛云上传的所有细节。我们只说几个核心的点，其他的看文档就行了。
- 文件上传按钮
var uploader = Qiniu.uploader({
runtimes: 'html5,flash,html4',
browse_button: 'pickfiles',
container: 'container',
...
browse_button,container后面的值对应了页面中两个元素的id值，并且container应该包含pickfiles，所以在html中写入下面内容
<div id="container">
<button id="pickfiles">选择文件</button>
</div>
- uptoken和domain
domain上面说过了，是你的七牛云生成的空间域名，一个域对应一个空间，有些坑后面再讲。
uptoken是一个签证，这个js脚本运行之后，main.js会异步去你指定的链接拿到uptoken的值
所以，关于这两个东西你得做三个事情：（我这么写不安全，自己发挥）
一是前端写入隐藏dom
<input type="hidden" id="domain" value="http://ogd29n56i.bkt.clouddn.com/">
<input type="hidden" id="uptoken_url" value="{{url('getuptoken')}}">
二是写入main.js
uptoken_url: $('#uptoken_url').val(),
domain: $('#domain').val(),
第三步就是写好获取uptoken的php程序，这部分也比较简单，可以参考官方php文档，附上代码：
public function getUptoken()
{
// 需要填写你的 Access Key 和 Secret Key
$accessKey = 'VsAP-hK_hVPKiq5CQcoxWNhBT9ZpZ1Ii4z3O_W51';
$secretKey = '5dqfmvL15DFoAK1QzaVF2TwVzwJllOF8K4Puf1Po';
// 构建鉴权对象
$auth = new Auth($accessKey, $secretKey);
// 要上传的空间
$bucket = 'jacklin';
// 生成上传 Token
$token = $auth->uploadToken($bucket);
$res = array('uptoken'=>$token);
return response()->json($res);
}
3.到目前为止，上传功能已经可以实现了，其他的设置你也需要看一下，比如方便的设置文件大小上限，哪几个不能同时设置之类的。
4.上文有说过，js版本的sdk结合了plupload这个上传插件，所以还有很多便利的地方。那就是main.js下面的部分。
'FilesAdded': function(up, files) {}
'BeforeUpload': function(up, file) {}
'UploadProgress': function(up, file) {}
'UploadComplete': function() {}
'FileUploaded': function(up, file, info) {}
'Error': function(up, err, errTip) {}
'Key': function(up, file) {}
先大概了解一下这几个函数，这里的用法类似jQ的ajax，这些是回调函数和参数，其中的up,files,info里面包含了关于这个文件所有的信息，
包括文件类型，大小，成功后的链接等等，所以可以用这些信息做一些DOM操作，首先前端的展示和必要的数据获取。如果你想查看这些对象里面
的内容咋办呢?
for(i in json){
console.log(i);
console.log(json[i]);
}
5 下面详细讲解这几个函数
'FilesAdded': function(up, files) {
//这里定义文件加入上传队列，但是还没有开始上传的动作
//七牛jssdk是多文件上传的，你可以试试上传的时候Ctrl添加多个文件试试
//第一个在加载的时候其他的文件的状态就是FilesAdded
},
'BeforeUpload': function(up, file) {
//这里自定义了上传前的动作，上传前就是马上就要开始上传的临界点
},
'UploadProgress': function(up, file) {
//这里自定义上传中的动作，这个地方就比较有意思了，只要文件上传没有完成
//这个函数就不断回调，你可以写一个alert(1)试试，文件上传中，就不断的弹弹弹
}
'UploadComplete': function() {
//这里自定义上传完成时的动作
}，
'FileUploaded': function(up, file, info) {
//这里定义了文件完成后的动作，可能你上传成功时通过ajax把url写进数据库
//就可以把ajax写在这里，从info对象里获取到url
}
'Error': function(up, err, errTip) {
//这里定义出现错误时的动作
}
'Key': function(up, file) {
//这里也是一个关键的地方，如果你想自己定义文件名，就在这里组织，并 return key;
// 但是前提是你已经把 unique_names save_key 注释了，我这里是加了一个时间戳
//这里是我定义的key,其实就是字符串拼接，如果你喜欢，return '123' 都可以
var extarr = file['name'].split('.');
if(extarr.length===1){
var arr=file['type'].split('/');
var prename = extarr[0];
var ext = (arr[arr.length-1]=='undefined')?'':arr[arr.length-1];
}else{
var ext = '.'+ extarr[extarr.length-1]; //得到后缀
var index = file['name'].lastIndexOf('.');//得到最后一个点的坐标
var prename = file['name'].substring(0,index);//得到最后一个点之前的字符串
}
var time = Date.parse(new Date())/1000;
$("input[name='ftype']").val(prename);
var key = prename+'/'+time+ ext;
return key;
}
6 .到现在整个流程已经讲完了，下面讲这个ui.js，你打开这个文件可能吓一跳，哇塞，js面向对象，各种成员属性方法的，
其实ui.js是官网demo的dom操作，没有这个js，官网这个demo能上传文件，但是，你啥都看不到，他就是用了上面所说up,
files,info几个对象里面的信息结合了几个过程，展示出了一些信息。它定义了一个FileProgress对象，而这个对象是初始化了
一个dom元素作为他的容器，你看一下他大概的用法，稍微了解一下up,files,info这几个对象就可以自己写了，不过，可是，
这个demo有关于缩略图和大文件分块上传进度展示的功能还是很复杂的。如果你说着我也会写，那你试试。
坑
400：token not specified
出现这个情况，说明你离成功还很远
1.检查你的token格式是不是跟官网的一样
2.我还遇到一个更坑的情况，浪费了很多时间，那就是电脑差，资源加载的慢，js还没有完全加载好，我就点击上传，也报这个错，所以，你得排除这个可能，那就是--等
400:incorrect zone ,please use up-z1.qiniu.com
这个问题是由于，你创建空间时候，手贱点了华北地区，七牛每个服务域名服务的地区是规定好的，所以有两个办法
- 换空间: 重新建一个空间 我选华东的，就OK了
- 换域名: 打开qiniu.js 搜索 qiniuUploadUrls,修改成如下
var qiniuUploadUrls = [
'http://upload-z1.qiniu.com',
'http://up-z1.qiniu.com'
]
最后
其他的自定义设置可以参考官方文档，下面附上一些常用的设置
1 设置一次只能选一个文件
multi_selection: false
2 取消分片 注意，最大分片也只是4M
chunk_size: ‘0mb’
3 取消自动上传
auto_start: false
4 暂停上传，开始上传
//加入下面dom和js代码
$('#up_load2').on('click', function(){
uploader2.start();
});
$('#stop_load2').on('click', function(){
uploader2.stop();
});
5 多个上传按钮问题，实例化多个main.js就行了
