README

该模块支持Imagick和GD库，您可以在模块设置中进行配置。

使用示例

$model = Model::findOne(12); //Model must have id

//If an image is first it will be main image for this model
$model->attachImage('../../image.png');

//But if you need set another image as main, use second arg
$model->attachImage('../../image2.png', true);

//get all images
$images = $model->getImages();
foreach($images as $img){
    //retun url to full image
    echo $img->getUrl();
    
    //return url to proportionally resized image by width
    echo $img->getUrl('300x');

    //return url to proportionally resized image by height
    echo $img->getUrl('x300');
    
    //return url to resized and cropped (center) image by width and height
    echo $img->getUrl('200x300');
}

//Returns main model image
$image = $model->getImage();

if($image){
    //get path to resized image 
    echo $image->getPath('400x300');
    
    //path to original image
    $image->getPathToOrigin();
    
    //will remove this image and all cache files
    $model->removeImage($image);
}

详细信息

1. 获取图像

   $model->getImage(); //returns main image for model (first added image or setted as main)
   
   $model->getImages(); //returns array with images
   
   //If there is no images for model, above methods will return PlaceHolder images or null
   //If you want placeholder set up it in module configuration (see documentation)

2. 删除图像 / 图像

   $model->removeImage($image); //you must to pass image (object)
   
   $model->removeImages(); //will remove all images of this model

3. 设置主图像

   $model->attachImage($absolutePathToImage, true); //will attach image and make it main
   
   foreach($model->getImages() as $img){
       if($img->getPrimaryKey() == $ourId){
           $model->setMainImage($img);//will set current image main
       }
   }

4. 获取图像尺寸

   $image = $model->getImage();
   $sizes = $image->getSizes(); // Array. Original image sizes
   $sizes = $image->getSizesWhen('x500');
   echo '<img width="'.$sizes['width'].'" height="'.$sizes['height'].'" src="'.$image->getUrl('x500').'" />';

5. 获取原始图像

   $img = $model->getImage();
   echo $img->getPathToOrigin();

安装

1. 运行

    php composer.phar require --prefer-dist alex290/yii2-images "*"
   

   或添加

    "alex290/yii2-images": "*"
   

   到您的composer.json文件的require部分。

2. 运行

      php composer.phar update
    

3. 运行migrate

    php yii migrate/up --migrationPath=@vendor/alex290/yii2-images/migrations
    

4. 配置模块

   'modules' => [
           'yii2images' => [
               'class' => 'alex290\yii2images\Module',
               //be sure, that permissions ok 
               //if you cant avoid permission errors you have to create "images" folder in web root manually and set 777 permissions
               'imagesStorePath' => 'images/store', //path to origin images
               'imagesCachePath' => 'images/cache', //path to resized copies
               'graphicsLibrary' => 'GD', //but really its better to use 'Imagick' 
               'placeHolderPath' => '@webroot/images/placeHolder.png', // if you want to get placeholder when image not exists, string will be processed by Yii::getAlias
               'imageCompressionQuality' => 100, // Optional. Default value is 85.
           ],
       ],

5. 将行为附加到您的模型上（请确保您的模型具有"id"属性）

       public function behaviors()
       {
           return [
               'image' => [
                   'class' => 'alex290\yii2images\behaviors\ImageBehave',
               ]
           ];
       }

这就完成了！