🌾 简单多文件上传插件
v1.1.0
版本
2024-09-07
版本更新时间
7654
安装
25
star
简介
简单易用多文件上传插件。目前支持以下多文件上传 。
特性
云端 | 多文件上传 | Base64图片上传 | 服务器文件上传 |
---|---|---|---|
🍏 私有云 | ✅ | -- | ✅ |
🍓 阿里云 | ✅ | ✅ | ✅ |
🍋 腾讯云 | ✅ | ✅ | ✅ |
🍇 七牛云 | ✅ | ✅ | ✅ |
🍇 亚马逊(S3) | ✅ | ✅ | ✅ |
安装
composer require tinywan/storage
基本用法
use Tinywan\Storage\Storage;
$res = Storage::uploadFile();
var_dump(json_encode($res));
上传成功信息
[
{
"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": "/storage/fd2d472da56c71a6da0a5251f5e1b586.png",
"uniqid ": "03414c9bdaf7a38148742c87b96b8167",
"size": 15050,
"mime_type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
"extension": "xlsx"
}
...
]
字段描述
字段 | 描述 | 示例值 |
---|---|---|
key | 上传文件key | webman |
origin_name | 原始文件名 | 常用编程软件和工具.xlsx |
save_name | 保存文件名 | 03414c9bdaf7a38148742c87b96b8167.xlsx |
save_path | 文件保存路径(相对) | /var/www/webman-admin/runtime/storage/03414c9bdaf7a38148742c87b96b8167.xlsx |
url | url访问路径 | /storage/03414c9bdaf7a38148742c87b96b8167.xlsx |
unique_id | uniqid | 03414c9bdaf7a38148742c87b96b8167 |
size | 文件大小 | 15050(字节) |
mime_type | 文件类型 | application/vnd.openxmlformats-officedocument.spreadsheetml.sheet |
extension | 文件扩展名 | xlsx |
失败,抛出
StorageAdapterException
异常
上传规则
默认情况下是上传到本地服务器,会在runtime/storage
目录下面生成以当前日期为子目录,以文件流的sha1编码为文件名的文件,例如上面生成的文件名可能是:
runtime/storage/fd2d472da56c71a6da0a5251f5e1b586.png
如果你希望上传的文件是可以直接访问或者下载的话,可以使用public
存储方式。
你可以在config/plugin/tinywan/storage/app.php
配置文件中配置上传根目录,例如:
'local' => [
'adapter' => \Tinywan\Storage\Adapter\LocalAdapter::class,
'root' => public_path() . '/storage',
],
浏览器访问:http://127.0.0.1:8787/storage/fd2d472da56c71a6da0a5251f5e1b586.png
上传验证
支持使用验证类对上传文件的验证,包括文件大小、文件类型和后缀
字段 | 描述 | 示例值 |
---|---|---|
single_limit | 单个文件的大小限制,默认200M | 1024 1024 200 |
total_limit | 所有文件的大小限制,默认200M | 1024 1024 200 |
nums | 文件数量限制,默认10 | 10 |
include | 被允许的文件类型列表 | ['xlsx','pdf'] |
exclude | 不被允许的文件类型列表 | ['png','jpg'] |
支持上传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
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"
}