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);
}

Детали

Получить изображения

$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)

Удалить изображение / изображения

$model->removeImage($image); //you must to pass image (object)

$model->removeImages(); //will remove all images of this model

Установить основное изображение

$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
    }
}

Получить размеры изображения

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

Получить оригинальное изображение
```
$img = $model->getImage();
echo $img->getPathToOrigin();
```

Установка

Запустить
```
 php composer.phar require --prefer-dist alex290/yii2-images "*"
```
или добавить
```
 "alex290/yii2-images": "*"
```
в секцию require вашего composer.json файла.
run
```
   php composer.phar update
 
```

run migrate

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

Настройка модуля

'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.
        ],
    ],

attach behaviour to your model (be sure that your model has "id" property)

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

Thats all!

alex290 / yii2-images

Maintainers

Details

README

Пример использования:

Детали

Установка