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

Image upload behavior 扩展了文件上传行为，包括图像缩略图的生成。您可以配置要生成的不同缩略图配置文件。

用法

将行为附加到您的模型类

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

链接

• 官方网站
• GitHub 上的源代码
• Packagist 上的 composer 包