网上关于七牛云存储的教程除了官网上的 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
$access Key = 'Imn35KC5pRX7Ov3scxbYkvNk6oIx7zWsBRp16' ; $secret Key = 's29vc9tlCvs23wRh7QScYTuzCDmEroKj1ddssz' ; Qiniu_SetKeys($access Key, $secret Key);
然后建一个上传策略对象,将你的 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 >