Uploud system for yii2 projects
Uploud system for yii2 projects
Installation
The preferred way to install this extension is through composer.
Either run
php composer.phar require --prefer-dist fgh151/yii2-upload-behavior "*"
or add
"fgh151/yii2-upload-behavior": "*"
to the require section of your composer.json file.
Update database schema
php yii migrate/up --migrationPath=@vendor/fgh151/yii2-upload-behavior/migrationsUsage
For example we have User model, which need photo.
Create table and model UserLinkPhoto. Sample code:
<?php
namespace common\models\user;
use common\models\user\User;
use fgh151\upload\models\Upload;
use Yii;
/**
* This is the model class for table "userLinkPhoto".
*
* @property int $userId
* @property int $uploadId
*
* @property User $user
* @property Upload $photo
*/
class UserLinkPhoto extends \yii\db\ActiveRecord
{
/**
* @inheritdoc
*/
public static function tableName()
{
return 'userLinkPhoto';
}
/**
* @inheritdoc
*/
public function rules()
{
return [
[['userId', 'uploadId'], 'required'],
[['userId', 'uploadId'], 'integer'],
];
}
/**
* @inheritdoc
*/
public function attributeLabels()
{
return [
'userId' => 'User ID',
'uploadId' => 'Upload ID',
];
}
/**
* @return \yii\db\ActiveQuery
*/
public function getUser()
{
return $this->hasOne(User::className(), ['id' => 'doctorId']);
}
/**
* @return \yii\db\ActiveQuery
*/
public function getPhoto()
{
return $this->hasOne(Upload::className(), ['id' => 'uploadId']);
}
}This class will store mapping entity and upload file. Then add behavior to User model:
/**
* This field need fo form and validation
*/
public $imagesField;
public function behaviors()
{
return [
[
'class' => FileUploadBehavior::className(), //Behavior class
'attribute' => 'imagesField',
'storageClass' => UserLinkPhoto::className(), //Mapping class
'storageAttribute' => 'userId', //Entity indefier in mapping clas
'folder' => 'user' //folder on server where store files, example '@frontend/web/upload/user'
]
];
}Now you can access files via hasMany property:
public function getPhoto()
{
return $this->hasMany(Upload::className(), ['id' => 'uploadId'])
->viaTable(UserLinkPhoto::tableName(), ['userId' => 'id']);
}Or direct request:
public function getPhotoPath()
{
return Yii::getAlias('@frontend') . '/web/upload/user/' .
substr(md5($this->photo->fsFileName), 0, 2) .
'/' . $this->id . '/' . $this->photo->fsFileName;
}Form field example:
<?= $form->field($model, 'imagesField[]')->fileInput() ?>
