This behavior allow you to add file and image uploading logic with ActiveRecord behavior.
Attach the behavior to your model class:
public function behaviors()
{
return [
'file-upload' => [
'class' => '\lagman\upload\FileUploadBehavior',
'attribute' => 'fileUpload',
'filePath' => '[[web_root]]/uploads/[[id]].[[extension]]',
'fileUrl' => '/uploads/[[id]].[[extension]]',
],
];
}
Possible path/url placeholders:
- [[app_root]] - application root
- [[web_root]] - web root
- [[model]] - model name
- [[id]] - model id
- [[id_path]] - id subdirectories structure
- [[parent_id]] - parent object primary key value
- [[basename]] - original filename with extension
- [[filename]] - original filename without extension
- [[extension]] - original extension
- [[base_url]] - site base url
Add validation rule:
public function rules()
{
return [
['fileUpload', 'file'],
];
}
Setup proper form enctype:
$form = \yii\bootstrap\ActiveForm::begin([
'enableClientValidation' => false,
'options' => [
'enctype' => 'multipart/form-data',
],
]);
File should be uploading fine.
You can get uploaded file url using model call:
echo $model->getUploadedFileUrl('fileUpload');
Image upload behavior extends file upload behavior with image thumbnails generation. You can configure set of different thumbnail profiles to generate.
Attach the behavior to your model class:
public function behaviors()
{
return [
'image-upload' => [
'class' => '\lagman\upload\ImageUploadBehavior',
'attribute' => 'imageUpload',
'thumbs' => [
'thumb' => ['width' => 400, 'height' => 300],
],
'filePath' => '[[web_root]]/images/[[model]]/[[id]].[[extension]]',
'fileUrl' => '/images/[[model]]/[[id]].[[extension]]',
'thumbPath' => '[[web_root]]/images/[[model]]/[[profile]]_[[id]].[[extension]]',
'thumbUrl' => '/images/[[model]]/[[profile]]_[[id]].[[extension]]',
],
];
}
Possible path/url placeholders:
- [[app_root]] - application root
- [[web_root]] - web root
- [[model]] - model name
- [[id]] - model id
- [[id_path]] - id subdirectories structure
- [[basename]] - original filename with extension
- [[filename]] - original filename without extension
- [[extension]] - original extension
- [[base_url]] - site base url
- [[profile]] - thumbnail profile name
Add validation rule:
public function rules()
{
return [
['imageUpload', 'file', 'types' => 'jpeg, gif, png'],
];
}
Setup proper form enctype:
$form = \yii\bootstrap\ActiveForm::begin([
'enableClientValidation' => false,
'options' => [
'enctype' => 'multipart/form-data',
],
]);
File should be uploading fine.
You can get uploaded image url using model call:
echo $model->getUploadedFileUrl('imageUpload');
You can also get generated thumbnail image url:
echo $model->getThumbFileUrl('imageUpload', 'thumb');
MIT