laker-ls / yii2-upload-image
通过HTML编辑器上传图片的行为。
1.1.2
2021-07-07 06:36 UTC
Requires
README
yii2-upload-image
这是一个为yii2提供的扩展行为。用于通过任何HTML编辑器和文件管理器(如CKEditor和ELfinder)上传图像。HTML编辑器通过以下格式的字符串传递图像:<img alt="" src="/upload/global/test.jpg" style="height:853px; width:1280px" />
,其中在src
中指定了通过文件管理器上传到服务器的实际图像路径,而在style
中传递了缩略图的大小。扩展会在指定的字段中搜索图像,并将它们移动到其他文件夹中,默认为/upload/image_full
,同时也会创建缩略图,默认为/upload/image_mini
。缩略图的大小会从style
中获取,如果没有指定,则缩略图将保持原始尺寸,图像路径将替换为实际的缩略图路径。删除记录时,应用程序将删除缩略图并将原始图像移动到文件管理器上传图像的位置。
安装
推荐使用 composer 安装此扩展。请检查 composer.json 以了解此扩展的要求和依赖项。
要安装,请运行
$ php composer.phar require laker-ls/yii2-upload-image "~1.1.2"
或者将以下行添加到 composer.json
的 require
部分:
"laker-ls/yii2-upload-image": "~1.1.2"
查看 变更日志 获取关于版本的详细信息。
使用方法
在模型中需要连接行为并设置参数 fields
。
必需参数
fields
必须包含一个数组,列出在HTML编辑器后需要处理的字段。
可选参数
qualityThumbnail
创建缩略图的质量,从1到100,默认为50。imageGlobal
包含文件管理器保存图像的路径。imageFull
包含行为将保存图像的路径。imageMini
包含创建缩略图的路径。imageNotFound
指定在处理图像错误时使用的图像路径。
注意:路径必须指定,且路径末尾不能有斜杠。例如,
upload/folder/
是无效的。
use lakerLS\HTMLfileManager\UploadImage; public function behaviors() { return [ 'uploadImage' => [ 'class' => UploadImage::class, 'fields' => ['image', 'text'], ] ]; }
许可证
yii2-upload-image 根据 BSD-3-Clause 许可证发布。可在 LICENSE.md
文件中查看。