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

karpalex98 / yii2-upload-behavior

维护者

详细信息

README

安装

FileUploadBehavior

用法

ImageUploadBehavior

用法

许可证

链接