PHPackages                             kollarovic/thumbnail - 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. [Image & Media](/categories/media)
4. /
5. kollarovic/thumbnail

ActiveLibrary[Image & Media](/categories/media)

kollarovic/thumbnail
====================

Generating image thumbnails

4.0.0(2y ago)1035.5k—5.6%16[1 PRs](https://github.com/Kollarovic/ThumbnailHelper/pulls)2MITPHPPHP >=8.0

Since Mar 21Pushed 1y ago3 watchersCompare

[ Source](https://github.com/Kollarovic/ThumbnailHelper)[ Packagist](https://packagist.org/packages/kollarovic/thumbnail)[ RSS](/packages/kollarovic-thumbnail/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (7)Dependencies (7)Versions (10)Used By (2)

Usage
-----

[](#usage)

```
{var $image='images/image.jpg'}

```

Installation
------------

[](#installation)

composer.json

```
composer require kollarovic/thumbnail

```

config.neon

```
extensions:
	thumbnail: Kollarovic\Thumbnail\DI\Extension
```

Configuration
-------------

[](#configuration)

config.neon

```
thumbnail:
	thumbPathMask: 'images/thumbs/{filename}-{width}x{height}.{extension}'
	placeholder: 'http://dummyimage.com/{width}x{height}/efefef/f00&text=Image+not+found'

```

MD5 thumbnail saving
--------------------

[](#md5-thumbnail-saving)

`{md5}` param in `thumbPathMask` takes file path and file name, converts it to md5 hash and then saves it in nested directories to avoid having millions of files in one folder. For example let's say md5 hash of my src location `somedir/project/www/images/users/1/profile.jpg` is e728fdeab7e2edda33f36fbf7a2b7c82 so using this `thumbPathMask`:

```
thumbPathMask: 'images/thumbs/{md5}/{width}x{height}-{crop}.{extension}'
```

it gets stored in `images/thumbs/e/7/2/e728fdeab7e2edda33f36fbf7a2b7c82/{width}x{height}-{crop}.jpg`

###  Health Score

45

—

FairBetter than 93% of packages

Maintenance33

Infrequent updates — may be unmaintained

Popularity38

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity74

Established project with proven stability

 Bus Factor1

Top contributor holds 95.7% 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 ~528 days

Recently: every ~405 days

Total

7

Last Release

927d ago

Major Versions

1.0.1 → 2.0.02019-05-26

2.0.0 → 3.0.02019-05-27

v2.0.2 → 4.0.02023-11-03

PHP version history (3 changes)1.0.0PHP >=5.3.1

3.0.0PHP >=7.1

4.0.0PHP >=8.0

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/3847103?v=4)[Mario Kollarovic](/maintainers/Kollarovic)[@Kollarovic](https://github.com/Kollarovic)

---

Top Contributors

[![Kollarovic](https://avatars.githubusercontent.com/u/3847103?v=4)](https://github.com/Kollarovic "Kollarovic (45 commits)")[![simPod](https://avatars.githubusercontent.com/u/327717?v=4)](https://github.com/simPod "simPod (2 commits)")

---

Tags

thumbnailnetteimagelatte

### Embed Badge

![Health badge](/badges/kollarovic-thumbnail/health.svg)

```
[![Health](https://phpackages.com/badges/kollarovic-thumbnail/health.svg)](https://phpackages.com/packages/kollarovic-thumbnail)
```

###  Alternatives

[intervention/image

PHP Image Processing

14.3k194.3M2.2k](/packages/intervention-image)[pavlista/nette-palette

Palette support for Nette Framework and Latte template engine

1657.4k](/packages/pavlista-nette-palette)[sybio/image-workshop

Powerful PHP class using GD library to work easily with images including layer notion (like Photoshop or GIMP)

860918.1k11](/packages/sybio-image-workshop)[h4cc/wkhtmltoimage-amd64

Convert html to image using webkit (qtwebkit). Static linked linux binary for amd64 systems.

20110.7M15](/packages/h4cc-wkhtmltoimage-amd64)[intervention/image-laravel

Laravel Integration of Intervention Image

1536.5M102](/packages/intervention-image-laravel)[james-heinrich/phpthumb

The PHP thumbnail generator

318516.1k6](/packages/james-heinrich-phpthumb)

PHPackages © 2026

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