使用七牛云

作者：: truesnow
发布于：: 7年前
收录于：: 个人网站开发
: 1355 0

摘要：# 要点 - 使用七牛云 PHP SDK 上传图片到七牛云。 # 使用七牛首先在七牛云上 [注册](https://portal.qiniu.com/signup?type=1 ) 一个账号。七牛提供一些免费的服务，比如对象存储等。对于个人网站来说，用来...

# 要点

- 使用七牛云 PHP SDK 上传图片到七牛云。

# 使用七牛

首先在七牛云上 [注册](https://portal.qiniu.com/signup?type=1 ) 一个账号。七牛提供一些免费的服务，比如对象存储等。对于个人网站来说，用来存储文件是很不错的选择。

![](http://pb8quxvbv.bkt.clouddn.com/images/201807/6mtv2cVtQiawicn.png)

注册成功后登陆进入 [管理控制台](https://portal.qiniu.com/create )，需要先进行 [实名认证](https://portal.qiniu.com/user/profile)，需要审核，一般需要一两天。
点击 *对象存储 > 新建存储空间*，创建一个空间，一般可以以「项目 + 环境」的方式来命名，例如：*blog-test*、*blog-prod*，也可以直接用自定义的域名名称命名，如 *test-static.blog.com*、*static.blog.com*。

![](http://pb8quxvbv.bkt.clouddn.com/images/201807/2FknFn0gYPKIRTD.png)

创建成功后如图，会生成对应存储空间的域名，之后的配置中需要用到：

![](http://pb8quxvbv.bkt.clouddn.com/images/201807/uNXMQX8X33PZDXe.png)

AccessKey 和 SecretKey 在个人中心，配置时需要使用：

![](http://pb8quxvbv.bkt.clouddn.com/images/201807/M1q6BCFBVSfsFHs.png)

# 安装配置 SDK

七牛云官方 SDK 为 [qiniu/php-sdk](https://github.com/qiniu/php-sdk )，PHP SDK 官方文档参考 [PHP SDK](https://developer.qiniu.com/kodo/sdk/1241/php )。

其它基于官方 SDK 的有 [overtrue/laravel-filesystem-qiniu](https://github.com/overtrue/laravel-filesystem-qiniu )、[zgldh/qiniu-laravel-storage](https://github.com/zgldh/qiniu-laravel-storage) 等，这三个 SDK 是在 [packagist](https://packagist.org/) 上下载量最高的。

这里我们使用 [zgldh/qiniu-laravel-storage](https://github.com/zgldh/qiniu-laravel-storage)，因为做后台使用 laravel-admin 的时候发现，其 [云盘上传](http://laravel-admin.org/docs/#/zh/model-form-upload?id=%e4%ba%91%e7%9b%98%e4%b8%8a%e4%bc%a0) 使用的是这个 SDK。

下面看看如何使用 SDK 上传图片。

安装配置步骤：

- Composer 安装：

```
composer require zgldh/qiniu-laravel-storage

```

- *config/app.php* `providers` 数组新增配置：

```
zgldh\QiniuStorage\QiniuFilesystemServiceProvider::class,

```

- *config/filesystems.php* `disk` 数组新增七牛相关配置：

我们将配置写在 `env` 环境变量配置文件中，便于不同环境配置不同的账号、存储空间。

```
        'qiniu' => [
            'driver' => 'qiniu',
            'domains' => [
                'default' => env('QINIU_DOMAIN'), //你的七牛域名
                'https' => env('APP_URL'),//你的HTTPS域名
                'custom' => env('QINIU_CUSTOM_DOMAIN'),// 没啥用，请直接使用上面的 default 项
             ],
            'access_key' => env('QINIU_ACCESS_KEY'),
            'secret_key' => env('QINIU_SECRET_KEY'),
            'bucket' => env('QINIU_BUCKET', 'test'),
            'notify_url'=> '',//持久化处理回调地址
            'access' => 'public',//空间访问控制 public 或 private
            'url' => env('QINIU_DOMAIN'),
        ],

```

- *.env* 配置中加入以下配置：

各配置项的值在七牛云管理控制台中获取。

```
# qiniu
QINIU_ACCESS_KEY=
QINIU_SECRET_KEY=
QINIU_BUCKET=
QINIU_DOMAIN=
QINIU_CUSTOM_DOMAIN=

```

至此配置完成。

# 使用 SDK 上传图片

下面将完成一个表单上传图片到七牛云的简单示例。

首先定义路由如下：

*routes/web.php*

```
// 资源管理
Route::get('resources/create', 'ResourcesController@create')->name('resources.create');// 上传页面
Route::post('resources/store', 'ResourcesController@store')->name('resources.store');// 提交上传
Route::get('resources/show', 'ResourcesController@store')->name('resources.show');// 显示上传结果

```

上传页面控制器代码：
*app/Http/Controllers/ResourcesController.php*

```
<?php
namespace App\Http\Controllers;

class ResourcesController extends Controller
{
    public function create()
    {
        return $this->view('resources/create');
    }
}

```

视图：

*resources/views/resources/create.blade.php*

```
...

<form action="{{ route('resources.store') }}" method="POST" enctype="multipart/form-data" accept-charset="utf-8">
    {{ csrf_field() }}
    <div class="form-group">
        <label for="file">上传文件：</label>
        <input type="file" class="form-control" name="file">
    </div>
    <button type="submit" class="btn btn-primary">提交</button>
</form>

...

```

![](http://pb8quxvbv.bkt.clouddn.com/images/201807/6gZiNVphLyAUVZr.png)

控制器上传图片处理：

*app/Http/Controllers/ResourcesController.php*

```
<?php
namespace App\Http\Controllers;

use Illuminate\Http\Request;
use zgldh\QiniuStorage\QiniuStorage;

use Storage;

class ResourcesController extends Controller
{

...

public function store(Request $request)
    {
        $file = $request->file('file');
        $disk = QiniuStorage::disk('qiniu');

// 第一个参数为存储的路径，第二个参数为文件对象，上传成功后返回完整的包含路径的文件名称，文件名为随机字符串，将此值存入到数据库中
        $name = $disk->put('uploads/images/' . date('Ym'), $file);

// 获取文件的 url
        $url = $disk->downloadUrl($name);

// 或者：页面显示时使用此方法获取文件 url

// $url = Storage::url($name);

return $this->view('resources.show', compact('name', 'url'));
    }

}

```

显示上传结果：

*resources/views/resources/show.blade.php*

```
<table class="table text-center">
    <tbody>
        <tr>
            <th>资源名称</th>
            <td>{{ $name }}</td>
        </tr>
        <tr>
            <th>资源链接</th>
            <td>{{ $url }}</td>
        </tr>
        <tr>
            <th>资源内容</th>
            <td><img src="{{ $url }}" alt="{{ $name }}" width="100" height="100"></td>
        </tr>
    </tbody>
</table>

```

![](http://pb8quxvbv.bkt.clouddn.com/images/201807/4PI40hApxOXUV1P.png)

# laravel-admin 使用七牛云

参考：http://laravel-admin.org/docs/#/zh/model-form-upload

编辑和创建表单：

```
$form->image('portrait', '肖像')->move('/images/mottos/' . date('Ym'));
```

如此上传后的图片 url 为：http://pbam2avfd.bkt.clouddn.com/images/mottos/201807/20121105120810.jpg

在表格中显示：

```
$grid->portrait('肖像')->image();
```

# 参考

- [qiiu/php-sdk](https://github.com/qiniu/php-sdk)

- [七牛后台主页](https://portal.qiniu.com/create)

- [七牛 PHP SDK 官方文档](https://developer.qiniu.com/kodo/sdk/1241/php)

- [overtrue/laravel-filesystem-qiniu](https://github.com/overtrue/laravel-filesystem-qiniu)

- [zgldh/qiniu-laravel-storage](https://github.com/zgldh/qiniu-laravel-storage)

文章目录

使用七牛云

所有评论（0）