网上关于七牛云存储的教程除了官网上的 API 文档,其他的资料太少了。研究了下 API 之后,现在已经能实现图片的上传和下载及上传之后的重定向。 首先本篇文章实现的功能如下: 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 文件,自己找一对应路径,代码如下:
1
|
require_once(dirname(__FILE__)."/../../qiniu/rs.php")
|
dirname () 是指的绝对路径,有时相对路径会出现问题,建议在前面加上 dirname 方法获取绝对路径。 require_once 是引入文件,表示该文件只引入一次。 然后,传入你的 AccessKey 和 SecretKey 代码如下:
1 2 3
|
$accessKey = 'Imn35KC5pRX7Ov3scxbYkvNk6oIx7zWsBRp16'; $secretKey = 's29vc9tlCvs23wRh7QScYTuzCDmEroKj1ddssz'; Qiniu_SetKeys($accessKey, $secretKey);
|
然后建一个上传策略对象,将你的 bucket 传入,bucket 就是你的空间名。
1 2
|
$bucket = 'designpartners'; $putPolicy = new Qiniu_RS_PutPolicy($bucket);
|
然后调用此方法来生成上传凭证。
1
|
$upToken = $putPolicy->Token(null);
|
接下来就写一个 html 表单
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
|
<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 值和选择照片即可实现照片的上传。哈哈哈有没有很简单。 三、文件下载 原理和文件上传功能相仿。 引入文件
1
|
require_once(dirname(__FILE__)."/../../qiniu/rs.php")
|
声明你的七牛云存储域名和两个密钥以及向下载的文件名称
1 2 3 4
|
$key = '00000' $domain = 'designpartners.qiniudn.com' $accessKey = 'IOImn35KC5p3scxbYkvNk6oIxB7zWsBRp16' $secretKey = 's29vc9tlCvs23wCDmIbUSi4EroKj1z'
|
注意:1.key 值即为文件名,不要加后缀 2.domain 即为 bucket 加上 qiniudn.com, 例子中的 designpartners 就是我在上传图片时用的 bucket 名。 3.accessKey 和 secretKey 换成你自己的,直接用我的不行的.. 因为我修改了.
1 2 3 4 5
|
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 即可实现图片的下载。 在引入图片时直接
1
|
<img src = "<?php echo $privateUrl; ?>"/>
|
即可引入图片咯,很简单的吧。 四、303 重定向 在上面的方法中,我们上传图片成功后跳转到 up.qiniu.com 下,会显示白白的网页,显示一个 json 字符串,但是在实际网站开发中我们肯定 不能让用户看到这种网页,所以我们用到了 303 跳转。SDK 中也为我们封装了这个方法。使用其实非常简单。在上传文件的代码中添加两行代码即可
1 2 3
|
$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
1
|
upload/receiveInfo?upload_ret=eyJrZXkiOiAiNTU1In0=
|
网址后缀如上所示,把那个 upload_ret 复制下来,用 base64 解码可以出现如下结果:
所以,我们要获取 555 这个值的代码如下,即解析代码如下:
1 2 3 4
|
$upload_ret = $_GET['upload_ret']; $json_ret = base64_decode($upload_ret); $result=json_decode($json_ret); echo "key".$result->key;
|
好啦,获取到这个 key 值之后,你可以选择存到数据库或者进行其他的操作咯。 五、上传前文件类型的验证 我们可以用 js 来验证文件的后缀名, 在 form 的属性里加上
1
|
onsubmit="return isValidateFile('file');"
|
加上一个 js 方法
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
|
<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:
1 2 3 4 5 6 7 8 9 10 11 12 13 14
|
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; }
|
文件上传:
1 2 3 4 5 6 7
|
public function uploadPic(){ $upToken = $this->getUptoken(); $data['upToken'] = $upToken; $this->load->view('upload',$data); }
|
303 重定向解析:
1 2 3 4 5 6
|
public function receiveInfo(){ $upload_ret = $_GET['upload_ret']; $json_ret = base64_decode($upload_ret); $result=json_decode($json_ret); echo "key".$result->key; }
|
文件下载:
1 2 3 4 5 6 7 8 9 10 11 12 13
|
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"; }
|
表单:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32
|
<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>
|