README

laravel-qcloud-cos

腾讯云V4对象存储的composer包

***************************

laravel安装

通过composer安装

运行以下命令以获取最新版本

使用composer命令安装扩展包

composer require jingling0101/laravel-qcloud-cos

对于laravel >= 5.5，这样就完成了。此包支持Laravel新的包发现。

如果您使用的是Laravel < 5.5，您还需要将YueCode\Cos\QCloudCosServiceProvider::class添加到您的config/app.php providers数组中

如果laravel版本小于5.5，需要将YueCode\Cos\QCloudCosServiceProvider::class添加到 config/app.php 文件中如下：

'providers' => [

        /*
         * Application Service Providers...
         */
         ......
        YueCode\Cos\QCloudCosServiceProvider::class,
    ],

在Laravel 5中发布配置设置，使用以下命令

执行命令将COS配置文件复制到config目录

php artisan vendor:publish --provider="YueCode\Cos\QCloudCosServiceProvider"

配置配置

配置config/cos.php

config/cos.php 

用法

使用

......

    // 云对象存储V4 Bucket 名称 test-1251111111
    // $bucket = 'your bucket';
    $bucket = 'test'; // 注 Bucket 名称不包含appid test-1251111111
    
    $cos = app('cos');

     /*
     * 创建目录
     * @param  string  $bucket bucket名称
     * @param  string  $folder       目录路径
     * @param  string  $bizAttr    目录属性
     */
     $cos->createFolder($bucket, $folder, $bizAttr);
    
    /**
     * 上传文件,自动判断文件大小,如果小于20M则使用普通文件上传,大于20M则使用分片上传
     * @param  string  $bucket   bucket名称
     * @param  string  $srcPath      本地文件路径
     * @param  string  $dstPath      上传的文件路径
     * @param  string  $bizAttr      文件属性
     * @param  string  $slicesize    分片大小(512k,1m,2m,3m)，默认:1m
     * @param  string  $insertOnly   同名文件是否覆盖
     * @return [type]                [description]
     */
     $cos->upload($bucket, $srcPath, $dstPath, $bizAttr, $sliceSize, $insertOnly);

    /*
     * 目录列表
     * @param  string  $bucket bucket名称
     * @param  string  $path     目录路径，sdk会补齐末尾的 '/'
     * @param  int     $num      拉取的总数
     * @param  string  $pattern  eListBoth,ListDirOnly,eListFileOnly  默认both
     * @param  int     $order    默认正序(=0), 填1为反序,
     * @param  string     透传字段,用于翻页,前端不需理解,需要往前/往后翻页则透传回来
     */
     $cos->listFolder($bucket, $folder, $num, $pattern, $order, $context);
 

    /*
     * 目录列表(前缀搜索)
     * @param  string  $bucket bucket名称
     * @param  string  $prefix   列出含此前缀的所有文件
     * @param  int     $num      拉取的总数
     * @param  string  $pattern  eListBoth(默认),ListDirOnly,eListFileOnly
     * @param  int     $order    默认正序(=0), 填1为反序,
     * @param  string     透传字段,用于翻页,前端不需理解,需要往前/往后翻页则透传回来
     */
     $cos->prefixSearch($bucket, $prefix, $num, $pattern, $order, $context);


    /*
     * 目录更新
     * @param  string  $bucket bucket名称
     * @param  string  $folder      文件夹路径,SDK会补齐末尾的 '/'
     * @param  string  $bizAttr   目录属性
     */
     $cos->updateFolder($bucket, $folder, $bizAttr);

     /*
      * 查询目录信息
      * @param  string  $bucket bucket名称
      * @param  string  $folder       目录路径
      */
      $cos->statFolder($bucket, $folder);

    /*
     * 查询文件信息
     * @param  string  $bucket  bucket名称
     * @param  string  $path        文件路径
     */
     $cos->stat($bucket, $path);


    /*
     * 删除文件
     * @param  string  $bucket
     * @param  string  $path      文件路径
     */
     $cos->delFile($bucket, $path);

    /*
     * 删除目录
     * @param  string  $bucket bucket名称
     * @param  string  $folder       目录路径
     *  注意不能删除bucket下根目录/
     */
     $cos->delFolder($bucket, $folder);
  

***************************

Lumen安装

通过composer安装

运行以下命令以获取最新版本

composer require jingling0101/laravel-qcloud-cos

更改引导文件。按照以下方式将以下片段添加到引导文件bootstrap/app.php中的providers部分：

将以下代码添加到bootstrap/app文件中 Register Service Providers 部分

$app->register(YueCode\Cos\QCloudCosServiceProvider::class);

配置配置

配置config/cos.php

config/cos.php