云存储

详细介绍

云存储应用插件，支持在 webman-admin 中设置云存储配置。用于向用户提供文件上传功能支持。

功能特性

安装使用

请在 webman-admin 的插件市场安装

一键替换本地存储到云端存储

使用场景： webman-admin 默认文件、附件、图片上传等都是默认上传到webman-admin项目目录下即本地服务器，访问文件使用相对路径拼接访问。如果你不想全部存在在本地，而是把上传文件统一存储在云端对象存储，如阿里云OSS等对象存储

注意：需要webman-admin官方管理后台大于版本 >= v0.6.32

在 plugin/admin/config/middleware.php 中添加全局中间件如下

// 全局中间件
return [
    '' => [
        // ... 这里省略其它中间件
        \plugin\storage\app\middleware\StorageMiddleware::class
    ]
];

一键替换webman-admin所有文件上传就这么简单，配置一个中间件就可以啦！

接口使用

使用场景： 自定义接口上传文件直接调用即可，如：给APP写一个api接口

use plugin\storage\api\Storage;

/** 默认上传 */
Storage::uploadFile();

/** 指定上传（阿里云） */
Storage::disk(Storage::MODE_OSS)->uploadFile();

上传成功信息

[
    {
        "key": "webman",
        "origin_name": "常用编程软件和工具.xlsx",
        "save_name": "03414c9bdaf7a38148742c87b96b8167.xlsx",
        "save_path": "runtime/storage/03414c9bdaf7a38148742c87b96b8167.xlsx",
        "save_path": "/var/www/webman-admin/public/storage/03414c9bdaf7a38148742c87b96b8167.xlsx",
        "url": "http://www.tinywan.com/upload/e0a1cd61ae1f07c3e692e82f465204256fb5e390.png",
        "uniqid ": "03414c9bdaf7a38148742c87b96b8167",
        "size": 15050,
        "mime_type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
        "extension": "xlsx"
    }
    ...
]

字段描述

Base64 图片上传

使用场景： 前端直接截图（头像、Canvas等）一个Base64数据流的图片直接上传到云端

使用案例

请求参数

{
    "extension": "png",
    "base64": "data:image/jpeg;base64,/9j/4AAQSkxxxxxxxxxxxxZJRgABvtyQBIr/MPTPTP/2Q=="
}

请求案例（阿里云）

use Tinywan\Storage\Storage;

public function upload(Request $request)
{
    $base64 = $request->post('base64');
    $response = Storage::disk(Storage::MODE_OSS, false)->uploadBase64($base64,'png');
    var_dump($response);
}

响应参数

{
    "origin_name": "/var/www/webman-admin/runtime/storage/webman.png",
    "save_path": "storage/6edf04d7c26f020cf5e46e6457620220402213414.png",
    "url": "http://webman.oss.tinywan.com/storage/6ed9ffd54d0df57620220402213414.png",
    "unique_id": "6edf04d7c26f020cf5e46e6403213414",
    "size": 3505604,
    "extension": "png"
}

服务端文件上传

使用场景： 服务端导出文件需要上传到云端存储，或者零时下载文件存储。

使用案例

请求案例（阿里云）

use Tinywan\Storage\Storage;
$serverFile = runtime_path() . DIRECTORY_SEPARATOR . 'storage/webman.png';
$res = Storage::disk(Storage::MODE_OSS, false)->uploadServerFile($serverFile);

响应参数

{
    "origin_name": "/var/www/webman-admin/runtime/storage/webman.png",
    "save_path": "storage/6edf04d7c26f020cf5e46e6457620220402213414.png",
    "url": "http://webman.oss.tinywan.com/storage/6ed9ffd54d0df57620220402213414.png",
    "unique_id": "6edf04d7c26f020cf5e46e6403213414",
    "size": 3505604,
    "extension": "png"
}

支持上传SDK

1. 阿里云对象存储

composer require aliyuncs/oss-sdk-php

2. 腾讯云对象存储

composer require qcloud/cos-sdk-v5

3. 七牛云云对象存储

composer require qiniu/php-sdk

4. 亚马逊（S3）对象存储**

composer require league/flysystem-aws-s3-v3

联系方式

QQ：756684177
邮箱：756684177@qq.com
微信：Tinywan8