PHPackages                             rokka/client-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. [Image &amp; Media](/categories/media)
4. /
5. rokka/client-bundle

ActiveSymfony-bundle[Image &amp; Media](/categories/media)

rokka/client-bundle
===================

Defines services for accessing the Rokka image service in the symfony framework

1.4.1(2y ago)9132.0k↓19.3%1[1 issues](https://github.com/rokka-io/rokka-client-bundle/issues)MITPHPPHP ^7.2 || ^8.0

Since Mar 21Pushed 2y ago4 watchersCompare

[ Source](https://github.com/rokka-io/rokka-client-bundle)[ Packagist](https://packagist.org/packages/rokka/client-bundle)[ RSS](/packages/rokka-client-bundle/feed)WikiDiscussions 1.x Synced 1mo ago

READMEChangelog (10)Dependencies (6)Versions (18)Used By (0)

Rokka Symfony Bundle
====================

[](#rokka-symfony-bundle)

[![Latest Stable Version](https://camo.githubusercontent.com/e89ec3e7633a1e913c015b3516e08c435f6dcc0089973cb8e2c2ea8b862a5825/68747470733a2f2f706f7365722e707567782e6f72672f726f6b6b612f636c69656e742d62756e646c652f76657273696f6e2e706e67)](https://packagist.org/packages/rokka/client-bundle)

A [Symfony](http://symfony.com/) bundle for the [Rokka](https://rokka.io/) image service.

[rokka](https://rokka.io) is digital image processing done right. Store, render and deliver images. Easy and blazingly fast. This bundle allows to upload and manage your image files to rokka and deliver them in the right format, as light and as fast as possible. And you only pay what you use, no upfront and fixed costs.

Free account plans are available. Just install the plugin, register and use it.

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

[](#installation)

The rokka Symfony bundle comes with a flex recipe.

Do the following.

```
composer config extra.symfony.allow-contrib true
composer require rokka/client-bundle

```

Then you can add your api key and organization to the `.env` file or edit `config/packages/rokka.yaml`.

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

[](#configuration)

Enter your api key and organization strings.

```
rokka_client:
    api_key: 'key-here'
    organization: 'my-organization'

    # Optional, not needed for most users
    #base_url: https://api.rokka.io

```

base\_url is to override the API location. We use this for testing mainly, so no need to change it ever.

Usage
-----

[](#usage)

The bundle will create two services for you, `rokka.client.image` and `rokka.client.user`. These give you access to the basic functionality from the [rokka/client](https://github.com/rokka-io/rokka-client-php) library, pre-configured with your credentials.

This bundle also provides console commands to interact with rokka.io. If you only want a CLI for rokka, you can also install the [rokka PHP CLI tool](https://github.com/rokka-io/rokka-client-php-cli) as stand-alone phar.

See the [official documentation](https://rokka.io/documentation) for further information on how to use rokka.

Twig
----

[](#twig)

The rokka twig extension is automatically included. It provides a couple of twig filters and functions to build rokka image URLs in twig templates. Some filters even allow to upload images on the fly:

```
{{ '/path/to/image' | rokka_stack_url('preview', seo='my-seo-image-url-fragment', seoLanguage = 'fr') }}

{{ rokka_generate_url(my_rokka_hash, 'preview', seo='my-image-url-fragement') }}

```

The [README of the rokka twig package](https://github.com/rokka-io/rokka-client-php-twig) documents how to use the filters.

Image paths are by default assumed to be relative to the `public` directory of the Symfony application. You can configure a different image root path with:

```
rokka_client:
    web_path_resolver:
        root_dir: "%kernel.project_dir%/path/to/images"

```

See the [README of the rokka twig package](https://github.com/rokka-io/rokka-client-php-twig) for further customization options. To use those options, you will need to overwrite services of this bundle.

Moving from LiipImagineBundle
-----------------------------

[](#moving-from-liipimaginebundle)

If you use imagine and want to switch to rokka, create a rokka stack for each imagine filter you have. And then replace `imagine_filter` with `rokka_stack_url` in your twig templates (maybe also state the format, if you don't want jpg).

If your images are not stored on the file system, then you need to do some further adjustments. The twig extension readme explains how to load images from other sources.

###  Health Score

42

—

FairBetter than 90% of packages

Maintenance18

Infrequent updates — may be unmaintained

Popularity38

Limited adoption so far

Community18

Small or concentrated contributor base

Maturity77

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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 ~167 days

Recently: every ~180 days

Total

18

Last Release

860d ago

Major Versions

0.3.1 → 1.0.02017-11-04

PHP version history (5 changes)0.2.1PHP &gt;=5.5

1.0.0PHP ^5.6 || ^7.0

1.2.0PHP ^7.0

1.2.1PHP ^7.1 || ^8.0

1.4.0PHP ^7.2 || ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/803a02308898d7176ad6601cc9f1bc9b057a725d5b35f6c0c54995b02a97a977?d=identicon)[rokka](/maintainers/rokka)

![](https://www.gravatar.com/avatar/04293348c41a664329fc652b5885ec3c073e8cca5ab159312eab2a6e8983bcd5?d=identicon)[chregu](/maintainers/chregu)

---

Top Contributors

[![chregu](https://avatars.githubusercontent.com/u/47106?v=4)](https://github.com/chregu "chregu (44 commits)")[![dbu](https://avatars.githubusercontent.com/u/76576?v=4)](https://github.com/dbu "dbu (36 commits)")[![thePanz](https://avatars.githubusercontent.com/u/226021?v=4)](https://github.com/thePanz "thePanz (9 commits)")[![Tobion](https://avatars.githubusercontent.com/u/610090?v=4)](https://github.com/Tobion "Tobion (5 commits)")[![ChristianRiesen](https://avatars.githubusercontent.com/u/1446701?v=4)](https://github.com/ChristianRiesen "ChristianRiesen (4 commits)")[![mms-uret](https://avatars.githubusercontent.com/u/900354?v=4)](https://github.com/mms-uret "mms-uret (4 commits)")[![michellesanver](https://avatars.githubusercontent.com/u/570982?v=4)](https://github.com/michellesanver "michellesanver (1 commits)")

---

Tags

imageimagesSymfony Bundlerokkarokka.ioimagemanipulation

###  Code Quality

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/rokka-client-bundle/health.svg)

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

###  Alternatives

[jbzoo/image

A PHP class that simplifies working with images

171126.9k3](/packages/jbzoo-image)[andrewgjohnson/imagettftextblur

imagettftextblur is a drop in replacement for imagettftext with added parameters to add blur, glow and shadow effects to your PHP GD images

27198.4k1](/packages/andrewgjohnson-imagettftextblur)[ayvazyan10/nova-imagic

Imagic is a Laravel Nova field package that allows for image manipulation capabilities, such as cropping, resizing, quality adjustment, and WebP conversion. It utilizes the powerful Intervention Image class for image manipulation.

144.3k1](/packages/ayvazyan10-nova-imagic)

PHPackages © 2026

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