PHPackages                             uilewis/laravel-qcloud-cos - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File & Storage](/categories/file-storage)
4. /
5. uilewis/laravel-qcloud-cos

ActiveLibrary[File & Storage](/categories/file-storage)

uilewis/laravel-qcloud-cos
==========================

腾讯云COS对象存储 laravel qclouds cos

05PHP

Since Jul 20Pushed 4y ago2 watchersCompare

[ Source](https://github.com/uilewis/laravel-qcloud-cos)[ Packagist](https://packagist.org/packages/uilewis/laravel-qcloud-cos)[ RSS](/packages/uilewis-laravel-qcloud-cos/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

laravel-qcloud-cos v4.2.3 for Laravel 5
=======================================

[](#laravel-qcloud-cos-v423-for-laravel-5)

[](#)

laravel-qcloud-cos

腾讯云V4对象存储的composer包

###### \*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*

[](#-1)

laravel Installation
====================

[](#laravel-installation)

### Install via composer

[](#install-via-composer)

Run the following command to pull in the latest version:

###### composer命令安装扩展包

[](#composer命令安装扩展包)

```
composer require uilewis/laravel-qcloud-cos
```

##### For laravel >=5.5 that's all. This package supports Laravel new Package Discovery.

[](#for-laravel-55-thats-all-this-package-supports-laravel-new-package-discovery)

##### If you are using Laravel < 5.5, you also need to add YueCode\\Cos\\QCloudCosServiceProvider::class to your `config/app.php` providers array:

[](#if-you-are-using-laravel--55-you-also-need-to-add-yuecodecosqcloudcosserviceproviderclass-to-your-configappphp-providers-array)

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

[](#如果laravel版本小于55-需要添加yuecodecosqcloudcosserviceproviderclass到-configappphp-文件中如下)

```
'providers' => [

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

### To publish the config settings in Laravel 5 use:

[](#to-publish-the-config-settings-in-laravel-5-use)

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

[](#执行命令复制cos配置文件到config目录)

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

### Configure config

[](#configure-config)

###### 配置config/cos.php

[](#配置configcosphp)

```
config/cos.php
```

Usage
=====

[](#usage)

###### 使用

[](#使用)

```
......

    // 云对象存储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 Installation
==================

[](#lumen-installation)

### Install via composer

[](#install-via-composer-1)

Run the following command to pull in the latest version:

```
composer require uilewis/laravel-qcloud-cos
```

Bootstrap file changes. Add the following snippet to the bootstrap/app.php file under the providers section as follows:

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

[](#添加以下代码到bootstrapapp-文件中-register-service-providers-部分)

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

### Configure config

[](#configure-config-1)

###### 配置config/cos.php

[](#配置configcosphp-1)

```
config/cos.php
```

###  Health Score

16

—

LowBetter than 5% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity29

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/a2c842d8d24461c4a8900f4d1bfe3055eb6694fa2405e9ee5d688ffa6e5c6d57?d=identicon)[uilewis](/maintainers/uilewis)

---

Top Contributors

[![lewis755](https://avatars.githubusercontent.com/u/65954127?v=4)](https://github.com/lewis755 "lewis755 (2 commits)")

### Embed Badge

![Health badge](/badges/uilewis-laravel-qcloud-cos/health.svg)

```
[![Health](https://phpackages.com/badges/uilewis-laravel-qcloud-cos/health.svg)](https://phpackages.com/packages/uilewis-laravel-qcloud-cos)
```

###  Alternatives

[knplabs/gaufrette

PHP library that provides a filesystem abstraction layer

2.5k39.8M123](/packages/knplabs-gaufrette)[google/cloud-storage

Cloud Storage Client for PHP

34390.8M125](/packages/google-cloud-storage)[illuminate/filesystem

The Illuminate Filesystem package.

15261.6M2.6k](/packages/illuminate-filesystem)[superbalist/flysystem-google-storage

Flysystem adapter for Google Cloud Storage

26320.6M30](/packages/superbalist-flysystem-google-storage)[creocoder/yii2-flysystem

The flysystem extension for the Yii framework

2931.7M62](/packages/creocoder-yii2-flysystem)[flowjs/flow-php-server

PHP library for handling chunk uploads. Works with flow.js html5 file uploads.

2451.6M15](/packages/flowjs-flow-php-server)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)