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 20Pushed yesterdayCompare

[ 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 today

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

20

—

LowBetter than 13% of packages

Maintenance65

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 (10 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

[goat1000/svggraph

Generates SVG graphs

133890.0k3](/packages/goat1000-svggraph)[imagekit/imagekit

PHP library for Imagekit

46877.3k10](/packages/imagekit-imagekit)[gravatarphp/gravatar

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

12644.1k2](/packages/gravatarphp-gravatar)[vormkracht10/laravel-open-graph-image

Laravel package to generate dynamic Open Graph images

7218.1k](/packages/vormkracht10-laravel-open-graph-image)

PHPackages © 2026

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