years/yii2-storage

Resource (Cloud) Storage SDK for Yii2

Yii2 storege - upload behavior for ActiveRecord

This package is one ActiveRecord behavior. It allows you to keep the uploaded file as-is. It support multiple attributes and files., _(*1)

Based on Flysystem, qiniu and oss supported., _(*2)

Installation

The preferred way to install this extension is through composer., _(*3)

Either run, _(*4)

php composer.phar require --prefer-dist years/yii2-storage "*"

or add, _(*5)

"years/yii2-storage": "*"

to the require section of your composer.json., _(*6)

Configuration

Add component 'storage', _(*7)

'components' => [
        'storage' => [
            'class' => 'years\storage\Storage',
        ],
   ]

Add key filesystems to params.php, _(*8)

return [
     xxxxx
    'filesystems' => [
        'default' => 'qiniu',
        'disks' => [
            'local' => [
                'driver' => 'local',
                'root' => '@webroot/upload',
            ],

            's3' => [
                'driver' => 's3',
                'key' => 'your-key',
                'secret' => 'your-secret',
                'region' => 'your-region',
                'bucket' => 'your-bucket',
            ],

            'qiniu' => [
                'driver'  => 'qiniu',
                'domains' => [
                    'default'   => 'olys54us5.bkt.clouddn.com', //你的七牛域名
                    'https'     => '',         //你的HTTPS域名
                    'custom'    => '',                //你的自定义域名
                ],
                'access_key'=> 'xxxxx-BCT2',  //AccessKey
                'secret_key'=> 'xxxx',  //SecretKey
                'bucket'    => 'xxx',  //Bucket名字
                'notify_url'=> '',  //持久化处理回调地址
            ],

            'oss' => [
                'driver'        => 'oss',
                'access_id'     => 'xxxx',
                'access_key'    => 'xxx',
                'bucket'        => 'xxx',
                'endpoint'      => 'oss-cn-hangzhou-internal.aliyuncs.com',
                'isCName'       => false,
                'debug'         => true
            ],
        ],
    ],
];

UploadBehavior

This behavior allow you to add file uploading logic with ActiveRecord behavior., _(*9)

Usage

Attach the behavior to your model class:, _(*10)

public function behaviors()
{
    return [
        [
            'class' => '\years\storage\behaviors\UploadBehavior',
            'attributes' => 'avatar',
            'disk' => 'qiniu',
            'directory' => 'images',
        ],
    ];
}

Add validation rule:, _(*11)

public function rules()
{
    return [
        ['avatar', 'file'],   
    ];
}

Setup proper form enctype:, _(*12)

$form = \yii\bootstrap\ActiveForm::begin([
    'enableClientValidation' => false,
    'options' => [
        'enctype' => 'multipart/form-data',
    ],
]);

File should be uploading fine., _(*13)

Licence

MIT, _(*14)