callmez/yii2-file-system

This extension provides a filesystem solution for Yii 2.

yii2-file-system

Yii2-file-system是 Flysystem基础上基于 Yii2 框架的实现的扩展。 任何存储,统一的函数调用, _(*1)

扩展存储

• Qinu 七牛云存储

将要实现的功能 (欢迎PR)

• 阿里云存储
• 又拍云存储 (未实现大文件流API[还是老牌存储...], 如果实现功能后.大文件操作会有资源要求)
• 百度云存储
• 新浪云存储

使用要求

• php >= 5.4
• Flysystem

使用教程

使用Componser安装 (以下2种方式)

• 命令行执行 composer require callmez/yii2-file-system

• 编辑composer.json, _(*2)

  "require": {
    ...
    "callmez/yii2-file-system": "*"
  },
  

编辑配置文件(2种使用方式)

• 编辑config/main.php, _(*3)

  'components' => [
  'fileSystem' => [
    'class' => 'callmez\file\system\Collection',
        'fileSystems' => [
            //根据需求可设置多个存储, 以下来使用例子
            'local' => function() {
                return new \callmez\file\system\FileSystem(
                    new \callmez\file\system\adapters\Local(\Yii::getAlias('@webroot\images'))
                );
            },
            'qiniu' => function() {
                return new \callmez\file\system\FileSystem(
                    new \callmez\file\system\adapters\Qiniu(
                        '七牛空间的 bucket',
                        '七牛空间的 access key',
                        '七牛空间的 access secret',
                        '七牛的空间域名,默认为 {bucket}.qiniu.com 选填'
                    )
                );
            }
        ]
  ]
  ]
  

• 使用例子(推荐wrapper方式), _(*4)

  // 集合方式
  $local = Yii::$app->fileSystem->get('local');
  $local->write('test.txt', 'hello world');
  echo $local->read('test.txt');
  
  $qiniu = Yii::$app->fileSystem->get('qiniu');
  $qiniu->write('test.txt', 'hello world');
  echo $qiniu->read('test.txt');
  
  // wrapper 方式 (推荐)
  //等同于Yii::$app->fileSystem->get('local')->write('test.txt', 'hello world');
  Yii::$app->fileSystem->write('local://test.txt', 'hello world'); 
  //等同于Yii::$app->fileSystem->get('qiniu')->write('test.txt', 'hello world');
  Yii::$app->fileSystem->write('qiniu://test.txt', 'hello world');