PHPackages                             phings-studio/miranda-image-proxy - 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. phings-studio/miranda-image-proxy

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

phings-studio/miranda-image-proxy
=================================

High-performance, memory-safe PHP image proxy.

00PHP

Since Jun 26Pushed 1mo agoCompare

[ Source](https://github.com/PHINGS-STUDIO/miranda-image-proxy)[ Packagist](https://packagist.org/packages/phings-studio/miranda-image-proxy)[ RSS](/packages/phings-studio-miranda-image-proxy/feed)WikiDiscussions main Synced 2w ago

READMEChangelogDependenciesVersions (1)Used By (0)

Miranda Image Proxy
===================

[](#miranda-image-proxy)

A high-performance, object-oriented PHP image proxy designed for maximum TTFB (Time to First Byte) rescue, memory protection, and next-gen format conversion.

The Origin Story
----------------

[](#the-origin-story)

This proxy was not built in a vacuum; it was built out of necessity. When content managers upload raw, high-resolution, uncompressed images directly into a CMS dashboard, frontend performance and Time to First Byte (TTFB) drop dead.

Instead of forcing a rewrite of the entire legacy upload logic, the Miranda Image Proxy acts as a bulletproof middleware. It intercepts these massive payloads, bypasses processing when unnecessary, optimizes formats on the fly, and caches the result. It is designed to survive heavy loads without triggering PHP memory limits (OOM crashes).

Core Features
-------------

[](#core-features)

- **Aggressive Desktop-Bypass:** If the requested size matches the original (and it is not a mobile device), PHP logic halts instantly and delivers the file via `readfile`.
- **Next-Gen Formatting:** Automatically converts standard images to `AVIF` or `WebP` based on the browser's `Accept` headers.
- **Smart Mobile Detection:** Dynamically reduces quality and scales down massive images when mobile user agents are detected.
- **Memory Protection:** Pre-calculates required memory allocation. Safely falls back to original image delivery if the server's `memory_limit` threshold is reached.
- **Built-in Cache Engine:** Generates ETag-hashed, immutable cached assets to eliminate redundant processing.

Requirements
------------

[](#requirements)

- PHP 8.0+
- GD Library enabled

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

[](#installation)

### Method A: Composer (Recommended)

[](#method-a-composer-recommended)

The most robust way to install the proxy and utilize the PSR-4 autoloader.

```
composer require phings-studio/miranda-image-proxy
```

###  Health Score

19

—

LowBetter than 9% of packages

Maintenance61

Regular maintenance activity

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

 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.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/289497522?v=4)[PHINGS-STUDIO](/maintainers/PHINGS-STUDIO)[@PHINGS-STUDIO](https://github.com/PHINGS-STUDIO)

---

Top Contributors

[![PHINGS-STUDIO](https://avatars.githubusercontent.com/u/289497522?v=4)](https://github.com/PHINGS-STUDIO "PHINGS-STUDIO (12 commits)")

### Embed Badge

![Health badge](/badges/phings-studio-miranda-image-proxy/health.svg)

```
[![Health](https://phpackages.com/badges/phings-studio-miranda-image-proxy/health.svg)](https://phpackages.com/packages/phings-studio-miranda-image-proxy)
```

###  Alternatives

[james-heinrich/phpthumb

The PHP thumbnail generator

321578.1k23](/packages/james-heinrich-phpthumb)[char0n/ffmpeg-php

PHP wrapper for FFmpeg application

493244.9k1](/packages/char0n-ffmpeg-php)[goat1000/svggraph

Generates SVG graphs

135931.0k3](/packages/goat1000-svggraph)[gravatarphp/gravatar

Gravatar URL builder which is most commonly called as a Gravatar library

12663.2k2](/packages/gravatarphp-gravatar)[sourcebroker/imageopt

Optimize images created/resized by TYPO3 so they take less space. Safe as it does not optimize original images.

3144.9k](/packages/sourcebroker-imageopt)

PHPackages © 2026

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