rakan

Laravel 文件系统扩展包 + 文件管理系统

适配阿里云OSS,七牛云

• 安装

• 使用

• 属性

• 配置

• 方法

  • 设置网关
  • 设置目录前缀
  • 设置模块
  • 获取文件列表
  • 获取上传策略
  • 创建目录
  • 检查文件唯一性
  • 删除文件及目录

• 路由

• 文件系统

• TODO

• 感谢

• 资料

简介

通用文件管理器,支持阿里云OSS,七牛云,腾讯,华为 直传

安装

composer require telstatic/rakan

配置

修改config/filessystems.php,disk中添加
'oss' => [
    'driver' => 'oss'
],
'qiniu' => [
    'driver' => 'qiniu'
],

使用

Model user.php
<?php

namespace App\Models\User;

use TELstatic\Rakan\Traits\Rakan;
...

class User {
    use Rakan;
}

Controller FileController.php
<?php

namespace App\Http\Controller\User;

use App\Models\User;
use Illuminate\Http\Request;

class FileController {
    public $user;
    
    public function __constract(){
        $this->user =User::find(1); 
    }
    
    public function getFiles(Request $request){
        return $this->user->prefix('rakan')->module('default')->->getFiles($request);
    }

    public function getPolicy(){
        return $this->user->getPolicy();
    }
    
    public function createFolder(Request $request){
        return $this->user->createFolder($request->pid,$request->name);
    }
    
    public function deleteFiles(Request $request){
        return $this->user->deleteFiles($request->ids);
    }

    public function checkFile(Request $request){
        return $this->checkFile($request->path);
    }
}

属性

name	type	require	default	memo
prefix	string	true	rakan	目录前缀
module	string	true	default	模块
gateway	string	true	oss	网关
expire	int	false	3600	策略有效时间

配置

name	default	memo
OSS_HOST	null	OSS上传地址
OSS_BUCKET	null	OSS bucket
OSS_AK	null	OSS access_key
OSS_SK	null	OSS secret_key
OSS_ENDPOINT	null	OSS endpoint
OSS_EXPIRE	3600	策略有效时间 单位:s
QINIU_AK	null	七牛 access_key
QINIU_SK	null	七牛 secret_key
QINIU_HOST	null	七牛外链域名
QINIU_BUCKET	null	七牛 bucket
QINIU_EXPIRE	3600	策略有效时间 单位:s

方法

• gateway 设置网关

参数

name	type	require	default	memo
gateway	string	false	oss	网关 oss,qiniu 默认oss

• prefix 设置目录前缀

参数

name	type	require	default	memo
prefix	string	false	rakan	目录前缀

• module 设置模块

参数

name	type	require	default	memo
module	string	false	default	模块名

• getFiles 获取文件及目录

参数

name	type	require	default	memo
pid	string	false	0	父级目录ID

返回 ​ 形如: ​

{
    "parent": {
        "id": "1",
        "path": "platform/q47G4R",
        "name": "Root",
        "type": "folder",
        "pid": 0,
        "module": "admin",
        "target_id": 1,
        "sort": 255,
        "updated_at": "2018-08-21 20:07:39",
        "created_at": "2018-08-21 20:07:39",
        "url": null,
        "checked": false
    },
    "children": {
        "current_page": 1,
        "data": [
            {
                "id": "2",
                "pid": "1",
                "path": "platform/q47G4R/test1",
                "name": "test1",
                "module": "admin",
                "target_id": 1,
                "type": "folder",
                "sort": 255,
                "updated_at": "2018-08-23 09:12:15",
                "created_at": "2018-08-23 09:12:15",
                "url": null,
                "checked": false
            }
        ],
        "first_page_url": "http://www.test.local/admin?page=1",
        "from": 1,
        "last_page": 1,
        "last_page_url": "http://www.test.local/admin?page=1",
        "next_page_url": null,
        "path": "http://www.test.local/admin",
        "per_page": 50,
        "prev_page_url": null,
        "to": 1,
        "total": 1
    }
}

• createFolder 创建目录

参数 ​

name	type	require	default	memo
pid	string	true	null	父级目录ID
name	string	true	null	目录名称

返回

状态码 + 错误提示

形如: ​

{
    status:500,
    msg:'目录已存在'
}

{
    status:200,
    msg:'目录创建成功'
}

• checkFile 检查文件是否存在 注意网关设置

参数 ​

name	type	require	default	memo
path	string	true	null	文件路径

返回 ​

状态码 + 错误提示

形如 ​

{
    status :500,
    msg : '文件已存在'
}

{
    status :200,
    msg : ''
}

• deleteFiles 删除文件及目录 注意网关设置

参数

name	type	require	default	memo
ids	array	true	null	文件或目录ID集合

返回 ​

状态 + 错误提示

形如 ​

{
    status:200,
    msg:'删除成功'
}

{
    status:500,
    msg:'目录 test 不为空'
}

• getPolicy 获取上传策略 注意网关设置

返回 ​
形如 ​

{
    "data": {
        "OSSAccessKeyId": "{your-access_key}",
        "Policy": "eyleHBpcmF0aW9uIjoiMjAxOS0wMS0wM1QwMzozNTo1OFoiLCJjb25kaXRpb25zIjpbWyJjb250ZW50LWxlbmd0aC1yYW5nZSIsMCwxMDQ4NTc2MDAwXV19",
        "Signature": "oeE36A1SsWWBZJ6iWx3rSeSBWSQ=",
        "success_action_status": 200,
        "key": ""
    },
    "expire": "3600"
}

{
    "data": {
        "token": "JQ4aZNe87tA2FG-I01lxp7kJArP6opY_renx7MU:Tg8Zrx5XIVNY4fwhHK9nX200UcM=:eyJzY29wZSI6InRlbHN0YXRpYyIsImRlYWRsaW5lIjoxNTQ2NDg2NjE4fQ==",
        "key": ""
    },
    "expire": "3600"
}

回调路由

路由名称: rakan.callback
Tip: 将路由 rakan.callback 加入白名单

VerifyCsrfToken.php

protected $except = [
    'rakan/callback/*'
];

文件系统

    Storage::disk('qiniu')->putFileAs('avatars', new File($file), 'avatar3.jpg'); //指定文件名上传文件
    Storage::disk('qiniu')->put('avatars/avatar1.jpg', file_get_contents($file));//不指定文件名上传文件

    Storage::disk('qiniu')->prepend('file.log', 'Prepended Text');//文件头部追加
    Storage::disk('qiniu')->append('file.log', 'Appended Text');//文件尾部追加

    Storage::disk('qiniu')->copy('avatars/avatar1.jpg', 'faces/avatar1.jpg');//复制文件
    Storage::disk('qiniu')->move('avatars/avatar3.jpg', 'avatars/avatar5.jpg');//移动文件

    $visibility = Storage::disk('oss')->getVisibility('avatars/avatar5.jpg');//获取文件可见性,不支持七牛
    Storage::disk('qiniu')->setVisibility('avatars/avatar5.jpg', 'public');//设置文件可见性,不支持七牛

    Storage::disk('qiniu')->delete('avatars/avatar1.jpg');  //删除文件
    Storage::disk('qiniu')->delete(['avatars/avatar5.jpg', 'faces/avatar1.jpg']);//删除多个文件

    Storage::disk('qiniu')->makeDirectory('avatars/test');  //创建目录
    Storage::disk('qiniu')->deleteDirectory('avatars/test');  //删除目录及该目录下其他文件

    Storage::disk('qiniu')->files('/');     //获取指定目录下文件
    Storage::disk('qiniu')->allFiles('/');  //获取全部文件
    Storage::disk('qiniu')->directories('/');   //获取指定目录下目录
    Storage::disk('qiniu')->allDirectories('/');    //获取全部目录

    Storage::disk('qiniu')->exists('file.log'); //判断文件是否存在

   Storage::disk('qiniu')->get('file.log'); //获取文件内容

   Storage::disk('qiniu')->url('Pairs.jpg');    //获取文件访问地址

   Storage::disk('qiniu')->size('test/Paris.jpg');//获取文件大小
   Storage::disk('qiniu')->lastModified('test/Paris.jpg');//获取文件最后修改时间
   
   $file = '../public/images/faces/avatar3.jpg';
   
   $image_info = getimagesize($file);
   $image_data = fread(fopen($file, 'r'), filesize($file));
   $base64_image = 'data:'.$image_info['mime'].';base64,'.chunk_split(base64_encode($image_data));

   Storage::disk('oss')->base64('avatars/avatarx.jpg', $base64_image);//base64 字符串上传

对象存储支持一览

• 阿里云OSS
• 七牛云KODO
• 腾讯云COS
• 华为云OBS

TODO

1. 云适配
    腾讯COS,又拍云,etc.
2. 多文件类型适配
    根据不同MineType类型返回不同图标

TIPS

1. 配套前台 https://github.com/TELstatic/xayah
2. 测试代码 https://github.com/TELstatic/RakanDemo

感谢开源

hashids/hashids

apollopy/flysystem-aliyun-oss

zgldh/qiniu-laravel-storage

参考资料

阿里云OSS PHP-SDK

七牛云对象存储 PHP-SDK

Buy me a coffee

Liked some of my work? Buy me a coffee (or more likely a beer)

Thanks