PHPackages                             jbouzekri/phumbor-bundle - 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. [Templating & Views](/categories/templating)
4. /
5. jbouzekri/phumbor-bundle

ActiveSymfony-bundle[Templating & Views](/categories/templating)

jbouzekri/phumbor-bundle
========================

A Symfony Bundle to use the minimal Thumbor PHP client from webfactory/phumbor

4.0.0(8mo ago)26763.7k↓77.8%101MITPHPPHP >= 8.1CI failing

Since Apr 17Pushed 8mo ago1 watchersCompare

[ Source](https://github.com/jbouzekri/PhumborBundle)[ Packagist](https://packagist.org/packages/jbouzekri/phumbor-bundle)[ Docs](https://github.com/jbouzekri/PhumborBundle)[ RSS](/packages/jbouzekri-phumbor-bundle/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (10)Dependencies (7)Versions (15)Used By (1)

PhumborBundle
=============

[](#phumborbundle)

[![Tests](https://github.com/jbouzekri/PhumborBundle/actions/workflows/tests.yml/badge.svg)](https://github.com/jbouzekri/PhumborBundle/actions/workflows/tests.yml)

A Symfony Bundle to generate Thumbor image URLs, using the [PHP client from webfactory](https://github.com/webfactory/phumbor).

Prerequisites
-------------

[](#prerequisites)

Of course, you must have a [Thumbor server](https://github.com/thumbor/thumbor/wiki) installed and operationnal. If not, you can follow the [official installation documentation](https://github.com/thumbor/thumbor/wiki/Installing).

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

[](#installation)

Add `jbouzekri/phumbor-bundle` as a dependency in `composer.json`.

```
"jbouzekri/phumbor-bundle": "^3.0"
```

Enable the bundle in your AppKernel :

```
$bundles = array(
    ...
    new Jb\Bundle\PhumborBundle\JbPhumborBundle()
);
```

In your config.yml, configure at least the url of your Thumbor server and the secret :

```
jb_phumbor:
    server:
        url: http://localhost
        secret: 123456789
```

Alternatively, you can also set the environment variables `THUMBOR_URL` and `THUMBOR_SECURITY_KEY` for these two settings, for example from your `.env`file or from inside your webserver configuration.

Quick use case
--------------

[](#quick-use-case)

You need to resize the image of your article to fit in a square of 50x50. Define the following transformation in your config.yml :

```
jb_phumbor:
    transformations:
        article_list:
            fit_in: { width: 50, height: 50 }
```

Now you can use it in twig :

```
{{ thumbor(, 'article_list') }}
```

Documentation
-------------

[](#documentation)

- [Configuration Reference](src/Resources/doc/reference.md)
- [Service](src/Resources/doc/service.md)
- [Twig Helper](src/Resources/doc/twig_helper.md)

License
-------

[](#license)

MIT - see [LICENSE](LICENSE)

###  Health Score

56

—

FairBetter than 97% of packages

Maintenance59

Moderate activity, may be stable

Popularity47

Moderate usage in the ecosystem

Community21

Small or concentrated contributor base

Maturity79

Established project with proven stability

 Bus Factor1

Top contributor holds 61.5% 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 ~326 days

Total

14

Last Release

259d ago

Major Versions

1.2.2 → 2.0.02019-11-01

2.2.0 → 3.0.02022-05-08

3.3.0 → 4.0.02025-12-02

PHP version history (5 changes)3.0.0PHP ^7.2|8.0.\*|8.1.\*

3.1.0PHP ^7.2|8.0.\*|8.1.\*|8.2.\*

3.2.0PHP ^7.2|8.0.\*|8.1.\*|8.2.\*|8.3.\*

3.3.0PHP ^7.2|8.0.\*|8.1.\*|8.2.\*|8.3.\*|8.4.\*

4.0.0PHP >= 8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/18963e247548b59e56dae09599281b9c34e70113fc384a42925411d9b9307fd5?d=identicon)[jbouzekri](/maintainers/jbouzekri)

---

Top Contributors

[![jbouzekri](https://avatars.githubusercontent.com/u/880996?v=4)](https://github.com/jbouzekri "jbouzekri (64 commits)")[![mpdude](https://avatars.githubusercontent.com/u/1202333?v=4)](https://github.com/mpdude "mpdude (24 commits)")[![ViktorParakhonia](https://avatars.githubusercontent.com/u/6010280?v=4)](https://github.com/ViktorParakhonia "ViktorParakhonia (8 commits)")[![Spea](https://avatars.githubusercontent.com/u/495017?v=4)](https://github.com/Spea "Spea (3 commits)")[![jamosonic](https://avatars.githubusercontent.com/u/131831?v=4)](https://github.com/jamosonic "jamosonic (1 commits)")[![fenix20113](https://avatars.githubusercontent.com/u/5658996?v=4)](https://github.com/fenix20113 "fenix20113 (1 commits)")[![navitronic](https://avatars.githubusercontent.com/u/180519?v=4)](https://github.com/navitronic "navitronic (1 commits)")[![tpatartmajeur](https://avatars.githubusercontent.com/u/51753505?v=4)](https://github.com/tpatartmajeur "tpatartmajeur (1 commits)")[![beenanner](https://avatars.githubusercontent.com/u/723985?v=4)](https://github.com/beenanner "beenanner (1 commits)")

---

Tags

symfonybundlehelpertwigthumborphumbor

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/jbouzekri-phumbor-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/jbouzekri-phumbor-bundle/health.svg)](https://phpackages.com/packages/jbouzekri-phumbor-bundle)
```

PHPackages © 2026

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