使用PHP实现七牛云存储图片（文件）上传

背景

最近在用PHP和laravel框架做一个图片网站，需要将图片存贮到云端，搜索下了对比了下功能，发现七牛云存储不错（主要小流量免费），便选择使用七牛作为图片存储空间。要实现的功能很简单，选择本地图片上传到七牛，上传成功后添加图片及上传者信息到数据库。本文主要讲php通过七牛php-sdk显现简单的图片上传。

准备

1、已存在php5.4，laravel5，mysql5.5（没有使用到），composer,七牛账号（注册[传送门](https://portal.qiniu.com/signup)）2、安装php-sdk，采用composer安装，打开laravel根目录下的composer.json，添加"qiniu/php-sdk": "~7.0"到require关键字下，保存，运行composer update安装，即完成php-sdk的安装。![composer配置](http://img.blog.csdn.net/20150413194853209)3、在config目录下添加qiniu.php配置文件，配置七牛相关的信息，配置如下

<?php    /**     * 七牛上传配置     */    return [            'accessKey'=>'yourAccesskey',            'secretKey'=>'yourSecretkey',            'bucket'=>'fpstatic',//上传空间名称            'domain'=>'http://7xidgf.com1.z0.glb.clouddn.com'    ];//空间域名

4、添加UploadController 控制器，并在router.php文件中添加一条路由，如下`Route::controller('upload','UploadController');`

代码实现

先贴整个控制器代码

<?php namespace App\Http\Controllers;use App\Http\Requests;use App\Http\Controllers\Controller;use Illuminate\Http\Request;use PhpParser\Node\Expr\Variable;use Illuminate\Support\Facades\Redis;use Illuminate\Support\Facades\Input;//导入七牛相关类use Qiniu\Auth;use Qiniu\Storage\BucketManager;use Qiniu\Storage\UploadManager;class UploadController extends Controller {    public function __construct(){        $this->middleware('activeUsers');    }    public function getIndex()    {        var_dump(isset($ret));        $data=$this->getPageData();//获取页面显示所需数据        $data['uploadSelected']=true;        return view('portal/upload')->with('data',$data);    }    /**     * 获取页面显示所需数据     * @return multitype:boolean \Illuminate\Support\Facades\mixed NULL     */    private function getPageData(){        $data=[];//返回视图数据        $data['loginCount']=Redis::get('loginNum');//登陆人数        $data['activeUsersCount']=Input::get('activeUsers');//活跃人数        return $data;    }    public function postDoupload(){        $token=$this->getToken();        $uploadManager=new UploadManager();        $name=$_FILES['file']['name'];        $filePath=$_FILES['file']['tmp_name'];        $type=$_FILES['file']['type'];        list($ret,$err)=$uploadManager->putFile($token,$name,$filePath,null,$type,false);        if($err){//上传失败            var_dump($err);            return redirect()->back()->with('err',$err);//返回错误信息到上传页面        }else{//成功            //添加信息到数据库            return redirect()->back()->with('key',$ret['key']);//返回结果到上传页面        }    }    /**     * 生成上传凭证     * @return string     */    private function getToken(){        $accessKey=config('qiniu.accessKey');        $secretKey=config('qiniu.secretKey');        $auth=new Auth($accessKey, $secretKey);        $bucket=config('qiniu.bucket');//上传空间名称        //设置put policy的其他参数        //$opts=['callbackUrl'=>'http://www.callback.com/','callbackBody'=>'name=$(fname)&hash=$(etag)','returnUrl'=>"http://www.baidu.com"];        return $auth->uploadToken($bucket);//生成token          }}

视图代码

@extends('common/index')@section('content')    <div class="row clearfix">        <div class="col-md-4 column">        </div>        <div class="col-md-4 column">            <form name="form" role="form" method="post" action="{{url('/upload/doupload')}}" enctype="multipart/form-data" onsubmit="return isValidateFile('file');">                <input type="hidden" name="_token" value="{{ csrf_token() }}">                <div class="form-group">                     <label for="exampleInputFile">选择文件</label><input type="file" name='file' />                    <p class="help-block">                    </p>                </div>                 <button type="submit" class="btn btn-default">上传</button>            </form>        </div>        <div class="col-md-4 column">            @if (session('key'))            <img alt="140x140" src="<?php echo config('qiniu.domain').'/'.session('key')?>?imageView2/2/w/400/h/400" class="img-rounded" />            @endif        </div>    </div>    <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" || extend =="gif")) {          alert("请上传后缀名为jpg、png或gif的文件!");          return false;          }        }        return true;      }    </script>@endsection

详解：

1、流程：    上传页面选择图片，点击提交，提交到/upload/doupload，路由解析到uploadController下的postDoupload（不懂查看laravel手册路由章节，不用laravel就无所谓了，提交到对控制器器方法即可）2上传流程![上传流程](http://img.blog.csdn.net/20150413204935125)so我们首先要生成uptoken3、导入七牛sdk相关的类

use Qiniu\Auth;use Qiniu\Storage\BucketManager;use Qiniu\Storage\UploadManager;

读取配置文件中的key，生成token方法    /**     * 生成上传凭证     * @return string     */    private function getToken(){        $accessKey=config('qiniu.accessKey');        $secretKey=config('qiniu.secretKey');        $auth=new Auth($accessKey, $secretKey);        $bucket=config('qiniu.bucket');//上传空间名称        //设置put policy的其他参数        //$opts=['callbackUrl'=>'http://www.callback.com/','callbackBody'=>'name=$(fname)&hash=$(etag)','returnUrl'=>"http://www.baidu.com"];        return $auth->uploadToken($bucket);//生成token          }

然后就要上传文件了，文件post到了这个方法

    public function postDoupload(){        $token=$this->getToken();        $uploadManager=new UploadManager();        $name=$_FILES['file']['name'];        $filePath=$_FILES['file']['tmp_name'];        $type=$_FILES['file']['type'];        list($ret,$err)=$uploadManager->putFile($token,$name,$filePath,null,$type,false);        if($err){//上传失败            var_dump($err);            return redirect()->back()->with('err',$err);//返回错误信息到上传页面        }else{//成功            //添加信息到数据库            return redirect()->back()->with('key',$ret['key']);//返回结果到上传页面        }    }

这里关键的一点是
$uploadManager->putFile($token,$name,$filePath,null,$type,false);
官方文档是这样的
list($ret, $err) = $uploadMgr->putFile($token, null, __file__);
坑爹的一点是,__file__不讲清楚，那只好去查他的源码了，
查看后得到，putFile方法参数依次为token，存储的文件名，真是路径，参数，和文件类型，传入相应的参数即可成功完成上传
4，在文件上传页面，点击提交之前检测文件是否为图片格式，这里参考的是一位网友的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" || extend =="gif")) {          alert("请上传后缀名为jpg、png或gif的文件!");          return false;          }        }        return true;      }    </script>

要注意的是记得给html页面中form的name属性设置为“form”

5、上传成功后，将上传的图片显示在上传页面（当然也可以是其他页面，仅测试），直接使用上传成功后返回的key（即文件名）以及空间域名来生成完整的地址（当然不建议这样）

总结

这仅仅是一个简单的例子，实现上传到七牛云存储的方法还有很多种（比如直接利用表单上传），具体可搜索【php 七牛】关键字。同时利用七牛也能进行功能丰富的图片处理，可查看七牛文档。 [代码地址](https://github.com/kpmving/FP "optional title")

参考

1.[PHP使用七牛云存储之图片的上传、下载、303重定向教程，CI框架实例](http://www.tuicool.com/articles/yARFVvQ)2.[PHP SDK 使用指南](http://developer.qiniu.com/docs/v6/sdk/php-sdk.html#io-put-flow)