PHPackages                             christophlehmann/imgproxy - 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. christophlehmann/imgproxy

ActiveTypo3-cms-extension[Image & Media](/categories/media)

christophlehmann/imgproxy
=========================

TYPO3 Extension for serving images with imgproxy.

0.0.3(2y ago)1543.1k↓21.2%6[3 PRs](https://github.com/christophlehmann/imgproxy/pulls)GPL-2.0-or-laterPHP

Since Oct 27Pushed 6mo ago2 watchersCompare

[ Source](https://github.com/christophlehmann/imgproxy)[ Packagist](https://packagist.org/packages/christophlehmann/imgproxy)[ RSS](/packages/christophlehmann-imgproxy/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (1)Versions (4)Used By (0)

TYPO3 Extension: ImgProxy
=========================

[](#typo3-extension-imgproxy)

Use [imgproxy](https://github.com/imgproxy/imgproxy) to render images asynchronously and serve them in new formats like webp and avif when the client supports them.

Basically TYPO3 now just renders a processing url and imgproxy serves the resulting image. The image processing is really fast compared to GraphicsMagick and ImageMagick and less memory hungry.

It does not store thumbnail informations in `sys_file_processedfile` nor save generated images locally, so for production usage a caching proxy is highly recommended.

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

[](#installation)

`composer require christophlehmann/imgproxy`

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

[](#configuration)

- `improxyUrl` is the url of imgproxy.
- `key` & `salt` are used for signing the urls. Generate them with `echo $(xxd -g 2 -l 64 -p /dev/random | tr -d '\n')`.
- `helperUrl` can be used to tell imgproxy how it reaches the source image. Handy in development environment: Set it to the projects live url and you don't need the images locally.
- `allowedExtensions` List of file extensions that should be handled with imgproxy
- `formatQuality` Can be used to define different compressions for avif,webp,.. Default: empty (TYPO3s quality setting is used). Example: `jpeg:70:avif:40:webp:60`

Run imgproxy locally with docker
--------------------------------

[](#run-imgproxy-locally-with-docker)

1. Set `imgproxyUrl` to `http://localhost:8080`
2. Set `helperUrl` to `local:///` when the docker container can't reach your local webserver
3. Start imgproxy

```
docker run \
  --env IMGPROXY_KEY=*yourkey* \
  --env IMGPROXY_SALT=*yoursalt* \
  --env IMGPROXY_ENABLE_WEBP_DETECTION=true \
  --env IMGPROXY_ENABLE_AVIF_DETECTION=true \
  --env IMGPROXY_LOCAL_FILESYSTEM_ROOT=/data \
  --volume /path/to/documentroot:/data \
  --publish 127.0.0.1:8080:8080 \
  -it darthsim/imgproxy
```

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance45

Moderate activity, may be stable

Popularity40

Moderate usage in the ecosystem

Community14

Small or concentrated contributor base

Maturity35

Early-stage or recently created project

 Bus Factor1

Top contributor holds 50% 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 ~52 days

Total

3

Last Release

830d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8e2a03e451b8ad5281ca437e00e44b1a50752d576afaba66db97d503beab31f2?d=identicon)[christophlehmann](/maintainers/christophlehmann)

---

Top Contributors

[![christophlehmann](https://avatars.githubusercontent.com/u/4953689?v=4)](https://github.com/christophlehmann "christophlehmann (3 commits)")[![helsner](https://avatars.githubusercontent.com/u/16156392?v=4)](https://github.com/helsner "helsner (2 commits)")[![tmaroschik](https://avatars.githubusercontent.com/u/771756?v=4)](https://github.com/tmaroschik "tmaroschik (1 commits)")

---

Tags

compressionimage-processingimgproxytypo3webvitalsperformancecompressionimageswebvitals

### Embed Badge

![Health badge](/badges/christophlehmann-imgproxy/health.svg)

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

###  Alternatives

[wp-media/imagify-plugin

Image optimization plugin for WordPress by WP Media.

7960.9k](/packages/wp-media-imagify-plugin)[moc/imageoptimizer

Flow package that optimizes generated thumbnail images (jpg, png, gif, svg) for web presentation.

31106.8k](/packages/moc-imageoptimizer)[schmitzal/tinyimg

Image compression for all pngs and jpgs uploaded to the backend (using the tinypng API)

16125.5k](/packages/schmitzal-tinyimg)[schnitzler/fluid-styled-responsive-images

Enables creation of responsive images for fluid styled content elements.

279.7k1](/packages/schnitzler-fluid-styled-responsive-images)[somehow-digital/typo3-media-processing

Media Processing

101.1k](/packages/somehow-digital-typo3-media-processing)

PHPackages © 2026

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