aleksey203 / yii2-upload-behavior
Yii2 ActiveRecord 文件/图片上传行为
1.2.3
2017-10-26 15:44 UTC
Requires
- php: >=5.4.0
- masterexploder/phpthumb: *
- yiisoft/yii2: *
README
此包包含两组类似的行为。第一个行为允许您保持上传的文件不变。第二个行为允许您为上传的图片生成一组缩略图。行为可以被多次附加到不同的属性上。
安装
安装此扩展的首选方式是通过 composer。
运行以下命令:
php composer.phar require --prefer-dist yii-dream-team/yii2-upload-behavior "*"
或者
"yii-dream-team/yii2-upload-behavior": "*"
将以下内容添加到您的 composer.json 文件的 require 部分:
FileUploadBehavior
此行为允许您使用 ActiveRecord 行为添加文件上传逻辑。
用法
将行为附加到您的模型类
public function behaviors()
{
return [
[
'class' => '\yiidreamteam\upload\FileUploadBehavior',
'attribute' => 'fileUpload',
'filePath' => '@webroot/uploads/[[pk]].[[extension]]',
'fileUrl' => '/uploads/[[pk]].[[extension]]',
],
];
}
您可以在路径模板配置中使用 Yii 路径别名,如 @app
、@webroot
、@web
。
您还可以在路径模板中使用额外的占位符。占位符 [[foobar]]
将被替换为相应的占位符值。
可能的路径/URL 占位符
[[model]]
- 模型类名[[pk]]
- 主键的值[[id]]
- 与[[pk]]
相同[[attribute_name]]
- 属性值,例如[[attribute_ownerId]]
[[id_path]]
- id 子目录结构(如果模型的主键是12345
,则占位符值将是1/2/3/4/5/0/0/0/0/0
)[[basename]]
- 带扩展名的原始文件名[[filename]]
- 不带扩展名的原始文件名[[extension]]
- 原始扩展名
添加验证规则
public function rules()
{
return [
['fileUpload', 'file'],
];
}
设置正确的表单 enctype
$form = \yii\bootstrap\ActiveForm::begin([
'enableClientValidation' => false,
'options' => [
'enctype' => 'multipart/form-data',
],
]);
文件应该可以正常上传。
您可以使用模型调用获取上传文件的 URL
echo $model->getUploadedFileUrl('fileUpload');
ImageUploadBehavior
ImageUploadBehavior 在文件上传行为的基础上扩展了图片缩略图的生成。您可以配置一组不同的缩略图配置文件以生成。
用法
将行为附加到您的模型类
public function behaviors()
{
return [
[
'class' => '\yiidreamteam\upload\ImageUploadBehavior',
'attribute' => 'imageUpload',
'thumbs' => [
'thumb' => ['width' => 400, 'height' => 300],
],
'filePath' => '@webroot/images/[[pk]].[[extension]]',
'fileUrl' => '/images/[[pk]].[[extension]]',
'thumbPath' => '@webroot/images/[[profile]]_[[pk]].[[extension]]',
'thumbUrl' => '/images/[[profile]]_[[pk]].[[extension]]',
],
];
}
您可以在路径模板配置中使用 Yii 路径别名,如 @app
、@webroot
、@web
。
您还可以在路径模板中使用额外的占位符。占位符 [[foobar]]
将被替换为相应的占位符值。
可能的路径/URL 占位符
[[model]]
- 模型类名[[pk]]
- 主键的值[[id]]
- 与[[pk]]
相同[[attribute_name]]
- 属性值,例如[[attribute_ownerId]]
[[id_path]]
- id 子目录结构(如果模型的主键是12345
,则占位符值将是1/2/3/4/5/0/0/0/0/0
)[[basename]]
- 带扩展名的原始文件名[[filename]]
- 不带扩展名的原始文件名[[extension]]
- 原始扩展名[[profile]]
- 缩略图配置文件名,在缩略图路径/URL 中使用它
添加验证规则
public function rules()
{
return [
['imageUpload', 'file', 'extensions' => 'jpeg, gif, png'],
];
}
设置正确的表单 enctype
$form = \yii\bootstrap\ActiveForm::begin([
'enableClientValidation' => false,
'options' => [
'enctype' => 'multipart/form-data',
],
]);
文件应该可以正常上传。
您可以使用模型调用获取上传图片的 URL
echo $model->getImageFileUrl('imageUpload');
您可以为没有上传图片的模型指定默认图片
echo $model->getImageFileUrl('imageUpload', '/images/empty.jpg');
您还可以获取生成的缩略图图片 URL
echo $model->getThumbFileUrl('imageUpload', 'thumb');
您可以为没有上传图片的模型指定默认缩略图图片
echo $model->getThumbFileUrl('imageUpload', 'thumb', '/images/thumb_empty.jpg');
许可
MIT