PHPackages                             laker-ls/yii2-upload-image - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File & Storage](/categories/file-storage)
4. /
5. laker-ls/yii2-upload-image

ActiveYii2-extension[File & Storage](/categories/file-storage)

laker-ls/yii2-upload-image
==========================

A behavior to upload image through HTML editor.

1.1.2(4y ago)134BSD-3-ClausePHP

Since May 14Pushed 4y agoCompare

[ Source](https://github.com/laker-ls/yii2-upload-image)[ Packagist](https://packagist.org/packages/laker-ls/yii2-upload-image)[ Docs](https://github.com/laker-ls/yii2-upload-image)[ RSS](/packages/laker-ls-yii2-upload-image/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependencies (1)Versions (7)Used By (0)

 yii2-upload-image
===================

[](#----yii2-upload-image)

[![Stable Version](https://camo.githubusercontent.com/2520243babafd092bc0d82c5f8542a4bbe5d4556d99b97a5590e68a28f5775e2/68747470733a2f2f706f7365722e707567782e6f72672f6c616b65722d6c732f796969322d75706c6f61642d696d6167652f762f737461626c65)](https://packagist.org/packages/laker-ls/yii2-upload-image)[![Unstable Version](https://camo.githubusercontent.com/cb6ecc68ae07385c1175d2b145ea51dd7186a7ba3fa8962d836f6e056783b9f3/68747470733a2f2f706f7365722e707567782e6f72672f6c616b65722d6c732f796969322d75706c6f61642d696d6167652f762f756e737461626c65)](https://packagist.org/packages/laker-ls/yii2-upload-image)[![License](https://camo.githubusercontent.com/6a3eaa5b31599649e0bbe5b2e68aa4ebcf6d7cf44e1e2f88ad84420ef1e615ea/68747470733a2f2f706f7365722e707567782e6f72672f6c616b65722d6c732f796969322d75706c6f61642d696d6167652f6c6963656e7365)](https://packagist.org/packages/laker-ls/yii2-upload-image)[![Total Downloads](https://camo.githubusercontent.com/adae7f9b86080bf6d87cfa8689532f31b352e5d0e826601d75b89b1a8c588b1a/68747470733a2f2f706f7365722e707567782e6f72672f6c616b65722d6c732f796969322d75706c6f61642d696d6167652f646f776e6c6f616473)](https://packagist.org/packages/laker-ls/yii2-upload-image)

Это расширение является поведением для yii2. Используется для загрузки изображений при использовании любых HTML редакторов и файловых менеджеров, например CKEditor и ELfinder. HTML редакторы передают изображение в строке следующего вида ``, где в `src` указывается фактический путь изображения, которое загружено на сервер с помощью файлового менеджера, а в `style` передаются размеры миниатюры. Расширение ищет изображения в указанных полях и перемещает их в другие папки, по умолчанию `/upload/image_full`, а так же создает миниатюры, по умолчанию в `/upload/image_mini`. Размеры миниатюры получаются из `style`, если не указаны, то миниатюра будет реальных размеров, пути изображений заменяются на актуальные пути миниатюр. При удалении записи приложение удаляет миниатюру и переносит оригинал изображения в место, куда загружает изображения файловый менеджер.

Установка
---------

[](#установка)

Рекомендуемый способ установки этого расширения является использование [composer](http://getcomposer.org/download/). Проверьте [composer.json](https://github.com/laker-ls/yii2-nested-set-menu/blob/master/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"

```

> Смотрите [список изменений](https://github.com/laker-ls/yii2-nested-set-menu/blob/master/CHANGE.md) для подробной информации о версиях.

Использование
-------------

[](#использование)

В модели необходимо подключить поведение и задать параметр `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`.

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~157 days

Recently: every ~196 days

Total

6

Last Release

1771d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3cdfc69e33bad0eff68f1c1f38b3d46a9acb8262d872f749e8aff9284278f1df?d=identicon)[lakerLS](/maintainers/lakerLS)

---

Top Contributors

[![laker-ls](https://avatars.githubusercontent.com/u/32402760?v=4)](https://github.com/laker-ls "laker-ls (6 commits)")

---

Tags

yii2extensionBehavior

### Embed Badge

![Health badge](/badges/laker-ls-yii2-upload-image/health.svg)

```
[![Health](https://phpackages.com/badges/laker-ls-yii2-upload-image/health.svg)](https://phpackages.com/packages/laker-ls-yii2-upload-image)
```

###  Alternatives

[mohorev/yii2-upload-behavior

Upload behavior for Yii 2

128265.5k9](/packages/mohorev-yii2-upload-behavior)[sjaakp/yii2-illustrated-behavior

ActiveRecord Behavior with associated Widget for Yii2.

423.1k](/packages/sjaakp-yii2-illustrated-behavior)[fedemotta/yii2-aws-sdk

This extension provides the AWS SDK integration for the Yii2 framework

15430.4k2](/packages/fedemotta-yii2-aws-sdk)[liyunfang/yii2-upload-behavior

Upload behavior for Yii 2

161.7k](/packages/liyunfang-yii2-upload-behavior)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)