README

Laravel下的一个上传组件，支持直接上传到第三方云存储。

安装

composer require sunnyshift/laravel-uploader

添加服务提供者

SunnyShift\Uploader\UploaderServiceProvider::class,

生成资源文件

php artisan vendor:publish --provider=SunnyShift\\LaravelUploader\\UploadServiceProvider

使用

将上传组件添加到页面

@uploader(['name' => 'avatar', 'max' => 3, 'accept' => 'jpg,png,gif'])

添加资源文件
```
@uploader('assets')
```
该组件依赖jQuery，因此在引入资源文件时必须先引入jQuery。

直接上传到云存储

该组件支持直接上传到第三方云存储，实际上就是模拟了表单上传的方式。从流程上来说，相比于传统先上传到服务器，再从服务器上传到云存储，少了一步转发。从架构上来说，原来的上传都统一通过网站服务器进行，上传量过大时，瓶颈在网站服务器，可能需要扩容网站服务器。采用表单上传后，上传都是直接从客户端发送到云存储。上传量过大时，压力都在云存储上，由云存储来保障服务质量。

目前支持的第三方云存储： 本地(local) 百度云(bos) 腾讯云(cos) 阿里云(oss) 七牛云(qiniu) 新浪云(scs) 又拍云(upyun)

其中的本地不算云存储，只是标识表示仍支持本地磁盘存储。

青云的鉴权方式比较独特，因此暂时无法支持。
UCloud的鉴权方式过于复杂，暂时不打算支持。

1.配置

百度云：

'disks' => [
    'bos' => [
        'driver'       => 'bos',
        'access_key_id'    =>  'xxxxxxxxxx',
        'access_key_secret'   => 'xxxxxxxxxx',
        'bucket'       => 'xxx',
        'region'    =>  'gz'    //改成存储桶相应地域
    ],
]

腾讯云：

'cos' => [
        'driver'       => 'cos',
        'app_id'    =>  '123456789',
        'secret_id'   => 'xxxxxxxxxxx',
        'secret_key'   => 'xxxxxxxxxxx',
        'bucket'       => 'xxxxxxxxx',
        'region'    =>  'sh'    //改成存储桶相应地域
    ]

注意，腾讯云存储时不是以资源的访问路径存储的，会加上appid和存储桶的参数。主要是腾讯云上传后没有返回资源的相对路径，而且这样的存储方式也是官方推崇的。

阿里云：

'oss' => [
        'driver'       => 'oss',
        'access_key'   => 'xxxxxxxxxx',
        'secret_key'   => 'xxxxxxxxxx',
        'bucket'       => 'xxxxx',
    ],

七牛云：

'qiniu' => [
        'driver'     => 'qiniu',
        'access_key' => 'xxxxxxxxxxxxxxxxxx',
        'secret_key' => 'xxxxxxxxxxxxxxxxxx',
        'bucket'     => 'xxxxxxxxxxxxxxxxxx',
        'domain'     => 'xxxxxxxxxxx'
    ],

新浪云：

'scs' => [
        'driver'       => 'scs',
        'access_key'    =>  'xxxxxx',
        'secret_key'   => 'xxxxxxx',
        'bucket'       => 'xxxxxxxx'
    ]

又拍云：

'upyun' => [
        'driver'     => 'upyun',
        'operator'   => 'xxxxx',
        'password'   => 'xxxxxx',
        'bucket'     => 'xxxxxx',
        'domain'     => 'xxxxxx',
        'form_api_secret'     =>  'xxxxx',
    ]

2.设置云存储

FILESYSTEM_DRIVER=qiniu

扩展

当然，您也可以扩展支持的云存储，这很简单。

1.新增驱动

<?php
use SunnyShift\Uploader\Contracts\UploaderContract;

class MyStorage implements UploaderContract {
        /**
     * 请求url
     * @return string
     */
    public function url() : string;

    /**
     * 请求头
     * @return array
     */
    public function header() : array;

    /**
     * 请求体
     * @return array
     */
    public function params() : array;

    /**
     * 文件表单名
     * @return string
     */
    public function fileName() : string;

    /**
     * 响应的url的键.
     * @return string
     */
    public function responseKey() : string;
}

2.拓展

Uploader::extend('mystorage', function($app) {
    return new MyStorage();
});

3.使用

FILESYSTEM_DRIVER=mystorage

或者

Uploader::setAdapter('mystorage');

说明

自带的上传组件UI是按照WEUI的上传功能设计的，可能不能满足您业务的需求，那么您可以自行构建UI后再把一些请求参数传到前台。这也很简单：

$data = Uploader::build($jsoned = true);

其中data包含实现SunnyShift\Uploader\Contracts\UploaderContract的所有参数，可以根据具体业务使用。

许可协议

MIT

sunyshift / laravel-uploader

维护者

详细信息