README

# 通用文件上传到第三方说明文档

oss 阿里云
qiniu 七牛
cos 腾讯云

安装

composer require tinymeng/uploads -vvv

类库使用的命名空间为\\tinymeng\\uploads

目录结构

.
├── src                              代码源文件目录
│   ├── Connector
│   │   ├── Gateway.php            必须继承的抽象类
│   │   └── GatewayInterface.php   必须实现的接口
│   ├── exception
│   │   └── TinymengException.php
│   ├── Gateways
│   │   ├── Cos.php
│   │   └── Oss.php
│   │   └── Qiniu.php
│   ├── Helper
│   │   ├── FileFunction.php
│   │   ├── MimeType.php
│   │   ├── PathLibrary.php
│   │   └── Str.php                 字符串辅助类
│   └── Upload.php                   抽象实例类
├── composer.json                    composer文件
├── LICENSE                          MIT License
└── README.md                        说明文件

开始

use Storage

use Storage;

示例代码

        $config = [
              'accessKeyId'		=> '',
              'accessKeySecret' 	=> '',

              'isCName'			=> false,
              'securityToken'		=> null,
              'bucket'            => '',
              'endpoint'			=> '',// 阿里云地域地址，OSS必填
              'region' 	=> 'ap-beijing',// 存储桶所在地域，COS必须字段
              'timeout'           => '5184000',
              'connectTimeout'    => '10',
              'transport'     	=> 'http',//如果支持https，请填写https，如果不支持请填写http
              'max_keys'          => 1000,//max-keys用于限定此次返回object的最大数，如果不设定，默认为100，max-keys取值不能大于1000
        ];
        $drive = Upload::oss($config);
        $a = $drive->uploadFile("test6.png", $_FILES['file']['tmp_name'] );//file上传文件


        $image  = "11/22/33/7125_yangxiansen.jpg";
        $image2 = "111.png";
        $image3 = "2.txt";

        $drive = Upload::oss($config);
        $drive->write("test2.txt", "111222",$config);
        $drive->getMetadata($image2);                                                         //判断文件是否存在
        $drive->geturl($image2);                                                              //获得文件的 url
        $drive->has($image2);                                                                 //判断文件是否存在
        $drive->listContents('');                                                             //列出文件列表
        $drive->getSize($image2);                                                             //获得图片大小
        $drive->getMimetype($image2);                                                         //获得图片mime类型
        $drive->getTimestamp($image2);                                                        //获得图片上传时间戳
        $drive->read($image3);                                                                //获得文件信息
        $drive->readStream($image3);                                                          //获得文件信息
        $drive->rename($image3, '4.txt/');                                                    //重命名文件
        $drive->copy('4.txt/', '/txt/5.txt');                                                 //复制文件
        $drive->delete('/txt/5.txt');                                                         //删除文件
        $drive->write("/txt/4.txt", $drive->read("/4.txt");                                //上传文件
        $drive->write("/test2.txt", "111222");                                                //上传文件
        $drive->deleteDir('txt/');                                                            //删除文件夹
        $drive->createDir('test3/');                                                          //创建文件夹
        $handle = fopen('/tmp/email.png', 'r');
        $drive->writeStream("/write/test3.png", $handle);                                  //上传文件(文件流方式)
        $drive->writeStream("/test6.png", $drive->readStream('/write/test3.png') );         //上传文件(文件流方式)

注意：详细使用，可以参考单元测试里面的代码。

配置信息

方式一：使用配置文件（推荐）

在 vendor/tinymeng/uploads/config/TUploads.php 中配置默认参数：

return [
    'default' => 'oss',  // 默认使用的存储驱动
    
    'oss' => [
        'accessKeyId'     => '',
        'accessKeySecret' => '',
        'endpoint'        => '',
        'bucket'          => '',
        // ... 其他配置
    ],
    
    'cos' => [
        'secretId'  => '',
        'secretKey' => '',
        'bucket'    => '',
        'region'    => 'ap-beijing',
        // ... 其他配置
    ],
    
    'qiniu' => [
        'domain'     => '',
        'access_key' => '',
        'secret_key' => '',
        'bucket'     => '',
        // ... 其他配置
    ],
];

使用配置文件时，可以直接调用，配置会自动加载：

// 使用配置文件中的默认配置
$drive = Upload::oss();

// 或者覆盖部分配置
$drive = Upload::oss(['bucket' => 'my-bucket']);

方式二：直接传入配置

// 七牛云配置
$qiniuConfig = [
    'driver'        => 'qiniu',
    'domain'        => '',//你的七牛域名
    'access_key'    => '',//AccessKey
    'secret_key'    => '',//SecretKey
    'bucket'        => '',//Bucket名字
    'transport'     => 'http',//如果支持https，请填写https，如果不支持请填写http
];

// 阿里云OSS配置
$ossConfig = [
    'accessKeyId'		=> '',
    'accessKeySecret' 	=> '',
    'endpoint'			=> '',
    'isCName'			=> false,
    'securityToken'		=> null,
    'bucket'            => '',
    'timeout'           => '5184000',
    'connectTimeout'    => '10',
    'transport'     	=> 'http',//如果支持https，请填写https，如果不支持请填写http
    'max_keys'          => 1000,//max-keys用于限定此次返回object的最大数，如果不设定，默认为100，max-keys取值不能大于1000
];

// 腾讯云COS配置
$cosConfig = [
    'secretId'	=> '',
    'secretKey' => '',
    'bucket'    => '',
    'region' 	=> 'ap-beijing',
    'isCName'			=> false,
    'securityToken'		=> null,
    'timeout'           => '5184000',
    'connectTimeout'    => '10',
    'transport'     	=> 'http',//如果支持https，请填写https，如果不支持请填写http
    'max_keys'          => 1000,//max-keys用于限定此次返回object的最大数，如果不设定，默认为100，max-keys取值不能大于1000
    // 兼容字段（会自动映射）
    'accessKeyId'       => '',  // 兼容字段，会自动映射到 secretId
    'accessKeySecret'   => '',  // 兼容字段，会自动映射到 secretKey
    'urlPrefix'         => '',  // 自定义域名前缀
];

版本修复

2021-03-12 更新以下功能 Tag v1.0.2

1.增加oss上传设置元信息

可直接下载的文件
$option = [
    OssClient::OSS_CONTENT_TYPE => 'application/octet-stream',
];
$oss_upload_result = $drive->uploadFile($save_file_path, $upload_path,$option);

2020-11-12 更新以下功能 Tag v1.0.1

1.修改TinymengException异常类

协议

MIT

tinymeng / uploads

Maintainers

Details

README

安装

目录结构

开始

配置信息

方式一：使用配置文件（推荐）

方式二：直接传入配置

版本修复

协议