README

这是对 Patroklo/yii2-widget-upload-crop 的分支

特性

• 上传图片
• 裁剪图片
• 使用Imagine
• 缓存排序到子目录

Composer

安装此扩展的首选方式是通过 Composer。

运行 php composer.phar require sadovojav/yii2-image-cutter "dev-master"

或在您的 composer.json 文件的 require 部分添加 "sadovojav/yii2-image-cutter": "dev-master"

使用方法

• 添加到模型行为

    use sadovojav\cutter\behaviors\CutterBehavior;

    public function behaviors()
    {
        return [
            'image' => [
                'class' => CutterBehavior::className(),
                'attributes' => 'image',
                // 'attributes' => ['image1', 'image2'],
                'baseDir' => '/uploads/crop',
                'basePath' => '@webroot',
            ],
        ]
    }
    
    public function rules()
    {
        return [
            ['image', 'file', 'extensions' => 'jpg, jpeg, png', 'mimeTypes' => 'image/jpeg, image/png'],
        ];
    }

参数

• integer attributes required (string/array) - 图片属性
• integer baseDir required - 基础目录
• integer basePath required - 基础路径
• integer quality = 92 - 裁剪结果质量

• 在视图中使用

没有客户端验证

    <div class="form-group">
        <label class="control-label">Image</label>
        <?= \sadovojav\cutter\Cutter::widget([
            'model' => $model,
            'attribute' => 'image'
        ]); ?>
    </div>

或者

有客户端验证

    <?= $form->field($model, 'image')->widget(\sadovojav\cutter\Cutter::className(), [
        //options
    ]); ?>

小部件方法选项

• model (string) (必填)

定义将用于创建表单输入字段的模型。

• attribute (string) (必填)

定义将用于创建表单输入字段的模型属性。

• useWindowHeight (bool) (可选)

使用当前窗口的高度进行表单图片裁剪

• imageOptions (array) (可选)

选项列表，将添加到用于在模态中定义裁剪数据的图片字段。格式应为 ['option' => 'value']。

• cropperOptions (array) (可选)

选项列表，将在创建裁剪对象时添加到JavaScript中。有关可以添加哪些选项的更多信息，您可以 阅读此网页。