PHPackages                             cnerstudio/think-filesystem - 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. cnerstudio/think-filesystem

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

cnerstudio/think-filesystem
===========================

thinkphp6.1 for filesystem,include Aliyun and Qiniu COS OBS

v3.1.18(1y ago)030MITPHPPHP >=8.0.0

Since Oct 27Pushed 1y ago1 watchersCompare

[ Source](https://github.com/cnerstudio/think-filesystem)[ Packagist](https://packagist.org/packages/cnerstudio/think-filesystem)[ RSS](/packages/cnerstudio-think-filesystem/feed)WikiDiscussions v1 Synced 1mo ago

READMEChangelogDependencies (14)Versions (41)Used By (0)

think-filesystem

[](#think-filesystem)

 thinkphp6.1 的文件系统扩展包，支持上传阿里云OSS和七牛和腾讯云COS和华为云OBS和awsS3

包含
--

[](#包含)

1. php >= 7.1
2. thinkphp >=6.1.0

支持
--

[](#支持)

1. 阿里云
2. 七牛云
3. 腾讯云
4. 华为云
5. AwsS3
6. sfpt

安装
--

[](#安装)

第一步：

```
$ composer require cnerstudio/think-filesystem
```

第二步： 在config/filesystem.php中添加配置

```
'aliyun' => [
    'type'         => 'aliyun',
    'accessId'     => '******',
    'accessSecret' => '******',
    'bucket'       => 'bucket',
    'endpoint'     => 'oss-cn-hongkong.aliyuncs.com',
    'url'          => 'http://oss-cn-hongkong.aliyuncs.com',
],
'qiniu'  => [
    'type'      => 'qiniu',
    'accessKey' => '******',
    'secretKey' => '******',
    'bucket'    => 'bucket',
    'domain'       => '',
],
'qcloud' => [
    'type'       => 'qcloud',
    'region'      => '***', //bucket 所属区域 英文
    'appId'      => '***', // 域名中数字部分
    'secretId'   => '***',
    'secretKey'  => '***',
    'bucket'          => '***',
    'timeout'         => 60,
    'connect_timeout' => 60,
    'cdn'             => '您的 CDN 域名',
    'scheme'          => 'https',
    'read_from_cdn'   => false,
]
'obs'=>[
     'key'        => 'OBS_ACCESS_ID',
     'secret'     => 'OBS_ACCESS_KEY', //Huawei OBS AccessKeySecret
     'bucket'     => 'OBS_BUCKET', //OBS bucket name
     'endpoint'   => 'OBS_ENDPOINT',
     'cdn_domain' => 'OBS_CDN_DOMAIN',
     'ssl_verify' => 'OBS_SSL_VERIFY',
     'debug'      => 'APP_DEBUG',
],
's3'=>[
      'credentials'             => [
                'key'    => 'S3_KEY',
                'secret' => 'S3_SECRET',
      ],
      'region'                  => 'S3_REGION',
      'version'                 => 'latest',
      'bucket_endpoint'         => false,
      'use_path_style_endpoint' => false,
      'endpoint'                => 'S3_ENDPOINT',
      'bucket_name'             => 'S3_BUCKET',
],
'sftp'=>[
    'host' => 'example.com',
    'username' => 'username',
    'password' => 'password',
    // Settings for SSH key based authentication...
    'privateKey' => 'path/to/or/contents/of/privatekey',
    'passphrase' => 'passphrase-for-privateKey',
    // Optional SFTP Settings...
    'port' => 22,
    'root' => '/path/to/root',
    'timeout' => 10,
]

```

第三步： 开始使用。 请参考thinkphp文档 文档地址：[https://www.kancloud.cn/manual/thinkphp6\_0/1037639 ](https://www.kancloud.cn/manual/thinkphp6_0/1037639)

### demo

[](#demo)

```
$file = $this->request->file( 'image' );
      try {
            validate(
                ['image' => [
                        // 限制文件大小(单位b)，这里限制为4M
                        'fileSize' => 10 * 1024 * 1000,
                        // 限制文件后缀，多个后缀以英文逗号分割
                        'fileExt'  => 'gif,jpg,png,jpeg'
                    ]
                ])->check( ['image' => $file] );

            $path     = \yzh52521\filesystem\facade\Filesystem::disk( 'public' )->putFile( 'test',$file);
            $url      = \yzh52521\filesystem\facade\Filesystem::disk( 'public' )->url( $path );
            return json( ['path' => $path,'url'  => $url] );
      } catch ( \think\exception\ValidateException $e ) {
            echo $e->getMessage();
     }
```

授权
--

[](#授权)

MIT

感谢
--

[](#感谢)

1. thinkphp
2. overtrue/flysystem-qiniu
3. league/flysystem
4. overtrue/flysystem-cos

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance33

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity63

Established project with proven stability

 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.

###  Release Activity

Cadence

Every ~15 days

Recently: every ~69 days

Total

41

Last Release

699d ago

Major Versions

v1.0.4 → v2.0.72022-10-31

v2.0.9 → v3.0.62022-10-31

v2.0.10 → v3.0.82022-11-02

v2.0.12 → v3.0.112022-11-20

v1.1.3 → v3.1.182024-06-17

PHP version history (5 changes)v1.0.0PHP >=7.1.0

v2.0.0PHP >=7.2.5

v3.0.0PHP >=8.0.2

v3.0.15PHP ^8.0.2

v3.1.18PHP >=8.0.0

### Community

Maintainers

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

---

Top Contributors

[![yuanzhihai](https://avatars.githubusercontent.com/u/15060466?v=4)](https://github.com/yuanzhihai "yuanzhihai (6 commits)")

### Embed Badge

![Health badge](/badges/cnerstudio-think-filesystem/health.svg)

```
[![Health](https://phpackages.com/badges/cnerstudio-think-filesystem/health.svg)](https://phpackages.com/packages/cnerstudio-think-filesystem)
```

###  Alternatives

[yzh52521/think-filesystem

thinkphp6.1 for filesystem,include Aliyun and Qiniu COS OBS

113.8k](/packages/yzh52521-think-filesystem)[ymirapp/cli

Ymir command-line tool

2619.6k](/packages/ymirapp-cli)

PHPackages © 2026

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