网上关于七牛云存储的教程除了官网上的API文档,其他的资料太少了。研究了下API之后,现在已经能实现图片的上传和下载及上传之后的重定向。
http://blog.csdn.net/cqcre/article/details/39718689
http://www.tuicool.com/articles/yARFVvQ
首先本篇文章实现的功能如下:
1.利用表单上传功能,用户可以点击选择文件按钮,选择本地的一个文件,同时设定上传的图片的名称,点击上传按钮可以上传并存储到七牛云存储。
2.在点击上传时会检测文件的后缀名,限制为jpg和png格式存储。
3.上传成功后跳转到自己设定的一个URL,并传回文件信息,如文件名。而不是显示七牛白花花的json显示页面。
好啦,那我们开始吧,首先我们要有一个七牛云存储账号,如果没有的就自己去申请吧。
七牛云存储传送门:http://www.qiniu.com/
一.SDK下载
https://github.com/qiniu/php-sdk/tags
戳这个网址下载一下SDK吧,里面封装了文件上传下载等等的方法,我们引入之后可以直接调用。
SDK之中有一个qiniu的文件夹,这是所有的SDK实货,这个是最重要的。我们首先要把这个文件夹及里面的文件放到项目文件夹中,比如我放到这里。
大家可以看到有一个qiniu文件夹。好啦,资源支持就是这样。接下来我们要实现代码咯。
二.文件的上传。
1.首先把你七牛云存储的密钥照出来,点击账号设置可以看到有一个AccessKey和SecretKey,留着备用。
2.上传凭证生成。
在这里我们首先要引入rs.php文件,自己找一对应路径,代码如下:
- require_once(dirname(__FILE__)."/../../qiniu/rs.php");
dirname()是指的绝对路径,有时相对路径会出现问题,建议在前面加上dirname方法获取绝对路径。
require_once是引入文件,表示该文件只引入一次。
然后,传入你的AccessKey和SecretKey
代码如下:
- $accessKey = 'Imn35KC5pRX7Ov3scxbYkvNk6oIx7zWsBRp16'; //换成你自己的密钥
- $secretKey = 's29vc9tlCvs23wRh7QScYTuzCDmEroKj1ddssz'; //换成你自己的密钥
- Qiniu_SetKeys($accessKey, $secretKey);
然后建一个上传策略对象,将你的bucket 传入,bucket 就是你的空间名。
- $bucket = 'designpartners';
- $putPolicy = new Qiniu_RS_PutPolicy($bucket);
然后调用此方法来生成上传凭证。
- $upToken = $putPolicy->Token(null);
接下来就写一个html表单
- <form method="post" action="http://up.qiniu.com" name = "form" enctype="multipart/form-data">
- <ul>
- <input type="hidden" id="token" name="token" value=<?php echo $upToken?>>
- <li>
- <label for="key">key:</label>
- <input name="key" value="">
- </li>
- <li>
- <label for="bucket">照片:</label>
- <input name="file" type="file" />
- </li>
- <li>
- <input type="submit" value="提交" >
- </li>
- </ul>
- </form>
action 就填写 up.qiniu.com,表单提供了一个输入框key,用来输入你想保存的图片名称,上传到七牛之后就是这个名字。
然后一个文件选择,一个提交按钮。运行结果如下:
输入key值和选择照片即可实现照片的上传。哈哈哈有没有很简单。
三、文件下载
原理和文件上传功能相仿。
引入文件
- require_once(dirname(__FILE__)."/../../qiniu/rs.php");
声明你的七牛云存储域名和两个密钥以及向下载的文件名称
- $key = '00000';
- $domain = 'designpartners.qiniudn.com';
- $accessKey = 'IOImn35KC5p3scxbYkvNk6oIxB7zWsBRp16';
- $secretKey = 's29vc9tlCvs23wCDmIbUSi4EroKj1z';
注意:1.key值即为文件名,不要加后缀
2.domain即为bucket加上qiniudn.com,例子中的designpartners就是我在上传图片时用的bucket名。
3.accessKey和secretKey换成你自己的,直接用我的不行的..因为我修改了.
- Qiniu_SetKeys($accessKey, $secretKey);
- $baseUrl = Qiniu_RS_MakeBaseUrl($domain, $key);
- $getPolicy = new Qiniu_RS_GetPolicy();
- $privateUrl = $getPolicy->MakeRequest($baseUrl, null);
- echo $privateUrl . "\n";
传入这四个值即可生成一样url,直接访问url即可实现图片的下载。
在引入图片时直接
- <img src = "<?php echo $privateUrl; ?>"/>
即可引入图片咯,很简单的吧。
四、303重定向
在上面的方法中,我们上传图片成功后跳转到up.qiniu.com下,会显示白白的网页,显示一个json字符串,但是在实际网站开发中我们肯定不能让用户看到这种网页,所以我们用到了303跳转。SDK中也为我们封装了这个方法。使用其实非常简单。在上传文件的代码中添加两行代码即可
- $putPolicy = new Qiniu_RS_PutPolicy($bucket);
- $putPolicy->ReturnUrl = site_url()."/upload/receiveInfo";
- $putPolicy->ReturnBody='{"key": $(key)}';
注意:1. ReturnUrl和ReturnBody必须指定,并且首字母要大写,很多人都小写开头,这样会跳转不成功。
2.ReturnUrl必须是一个公网可以访问的网址,在本地测试是不可能通过的。比如你写成localhost,七牛服务器是定位不到的。
3.这个ReturnUrl的链接后会跟着一个?upload_ret=XXX,可以用get方法获取这个upload_ret。upload_ret的内容是base64安全编码的json形式的key值。
值的解析:比如我上传的文件名是555
- upload/receiveInfo?upload_ret=eyJrZXkiOiAiNTU1In0=
网址后缀如上所示,把那个upload_ret复制下来,用base64解码可以出现如下结果:
- {"key": "555"}
所以,我们要获取555这个值的代码如下,即解析代码如下:
- $upload_ret = $_GET['upload_ret'];
- $json_ret = base64_decode($upload_ret);
- $result=json_decode($json_ret);
- echo "key".$result->key;
好啦,获取到这个key值之后,你可以选择存到数据库或者进行其他的操作咯。
五、上传前文件类型的验证
我们可以用js来验证文件的后缀名,
在form的属性里加上
- onsubmit="return isValidateFile('file');"
加上一个js方法
- <script>
- function isValidateFile(obj) {
- var extend = document.form.file.value.substring(document.form.file.value.lastIndexOf(".") + 1);
- if (extend == "") {
- alert("请选择头像");
- return false;
- }
- else {
- if (!(extend == "jpg" || extend == "png")) {
- alert("请上传后缀名为jpg或png的文件!");
- return false;
- }
- }
- return true;
- }
- </script>
即可验证它的类型是否合法。
附:CI代码实现:
获取Uptoken:
- function getUptoken(){
- require_once(dirname(__FILE__)."/../../qiniu/rs.php");
- //远程存储空间名称
- $bucket = 'designpartners';
- $accessKey = 'IOImn35KCRX7Ov3scvNk6oIxB7zWsBRp16';
- $secretKey = 's29vc9tlCvs23wRhTuzCDmIbUSi4EroKj1z';
- Qiniu_SetKeys($accessKey, $secretKey);
- $putPolicy = new Qiniu_RS_PutPolicy($bucket);
- echo site_url();
- $putPolicy->ReturnUrl = site_url()."/upload/receiveInfo";
- $putPolicy->ReturnBody='{"key": $(key)}';
- $upToken = $putPolicy->Token(null);
- return $upToken;
- }
文件上传:
- public function uploadPic(){
- $upToken = $this->getUptoken();
- $data['upToken'] = $upToken;
- $this->load->view('upload',$data);
- }
303重定向解析:
- public function receiveInfo(){
- $upload_ret = $_GET['upload_ret'];
- $json_ret = base64_decode($upload_ret);
- $result=json_decode($json_ret);
- echo "key".$result->key;
- }
文件下载:
- public function downloadPic(){
- require_once(dirname(__FILE__)."/../../qiniu/rs.php");
- $key = '00000';
- $domain = 'designpartners.qiniudn.com';
- $accessKey = 'IOImn35KC57Ov3scxbYkvNk6oIxB7zWsBRp16';
- $secretKey = 's29vc9tlCvsh7QScYTuzCDmIbUSi4EroKj1z';
- Qiniu_SetKeys($accessKey, $secretKey);
- $baseUrl = Qiniu_RS_MakeBaseUrl($domain, $key);
- $getPolicy = new Qiniu_RS_GetPolicy();
- $privateUrl = $getPolicy->MakeRequest($baseUrl, null);
- echo "====> getPolicy result: \n";
- echo $privateUrl . "\n";
- }
表单:
- <script>
- function isValidateFile(obj) {
- var extend = document.form.file.value.substring(document.form.file.value.lastIndexOf(".") + 1);
- if (extend == "") {
- alert("请选择头像");
- return false;
- }
- else {
- if (!(extend == "jpg" || extend == "png")) {
- alert("请上传后缀名为jpg或png的文件!");
- return false;
- }
- }
- return true;
- }
- </script>
- <form method="post" action="http://up.qiniu.com" name = "form" enctype="multipart/form-data" onsubmit="return isValidateFile('file');">
- <ul>
- <input type="hidden" id="token" name="token" value=<?php echo $upToken?>>
- <li>
- <label for="key">key:</label>
- <input name="key" value="">
- </li>
- <li>
- <label for="bucket">照片:</label>
- <input name="file" type="file" />
- </li>
- <li>
- <input type="submit" value="提交" >
- </li>
- </ul>
- </form>