PHPackages                             hiperbola/simple-image - 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. hiperbola/simple-image

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

hiperbola/simple-image
======================

A simple image resize tool that takes all the pain out of resizing images for the web.

010PHP

Since Aug 21Pushed 10y ago1 watchersCompare

[ Source](https://github.com/pavlin-policar/SimpleImage)[ Packagist](https://packagist.org/packages/hiperbola/simple-image)[ RSS](/packages/hiperbola-simple-image/feed)WikiDiscussions master Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

SimpleImage
===========

[](#simpleimage)

A simple image management system for resizing various images.

For a long time, I struggled with various image sizes. Thumbnails, preview images and any other nonsense resizing must be performed when undertaking the production of any website. Although tools do exist to simplify this, I found that setting them up would often take longer than doing the resizing manually. So I decided to try to make a very simple, easy to implement image system, that handles all the resizing for me. With the introduciton of the HTML5  tag, the need for this is even greater, as you need several different image sizes for each image you put on your website to keep loading times reasonable and to maintain responsivness.

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

[](#installation)

Install with composer using `composer require hiperbola/simple-image`.

The package comes with 2 files that are important. The `.htaccess` file and the `bootstrap.php` file.

The `.htaccess` file is the apache config file that redirects all supported image file requests the the `bootstrap.php` file. Move the `.htaccess` file to your root directory of your webpage, or if you already have an apache configuration file, in which case you can open the given htaccess file and copy the rewrite rule to your exising configuration file. Also, since composer installs packages into the vendor folder, you will need to modify the rewrite rule so it points to the valid `bootstrap.php` file.

Usually this will do just fine, if your `.htaccess` file is in your root directory. `RewriteRule ^(.*)\.(jpg|png) vendor/hiperbola/simple-image/bootstrap.php/$1 [L]`

Usage
-----

[](#usage)

After you've correctly installed the package, there really isn't much more to do. When linking to an image on your webhost simply append the parameters you would like to have applied. Currently, there are 3 modes of operation:

### Resize by height

[](#resize-by-height)

Keep the aspect ratio and specify a new height.

E.g. `url/image.jpg/h:400px`

### Resize by width

[](#resize-by-width)

Keep the aspect ratio and specify a new width.

E.g. `url/image.jpg/w:800px`

### Resize by width and height

[](#resize-by-width-and-height)

This will not keep the aspect ratio but stretch the image to satisfy the parameters.

E.g. `url/image.jpg/w:400/h:400`

Notes
-----

[](#notes)

You may be worried that image processing takes a long time, and under a heavy load this could become a major problem. This system uses a cache system, where any image that has been generated will be stored on disk so every dimension you request will be generated only once. The 'cache' is a small mysqlite database so no external database access is necessary.

###  Health Score

20

—

LowBetter than 13% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 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://www.gravatar.com/avatar/55c1bdbe1efc711c80675ce3d0cc32631428d9abce480c6cb37dedf4060ccb5c?d=identicon)[naxez7](/maintainers/naxez7)

---

Top Contributors

[![pavlin-policar](https://avatars.githubusercontent.com/u/5758119?v=4)](https://github.com/pavlin-policar "pavlin-policar (17 commits)")

### Embed Badge

![Health badge](/badges/hiperbola-simple-image/health.svg)

```
[![Health](https://phpackages.com/badges/hiperbola-simple-image/health.svg)](https://phpackages.com/packages/hiperbola-simple-image)
```

###  Alternatives

[char0n/ffmpeg-php

PHP wrapper for FFmpeg application

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

Generates SVG graphs

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

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

16653.6k2](/packages/gravatarphp-gravatar)[rsoury/wp-imgix

Rewrites WordPress image URLs to use ImgIX

167.2k](/packages/rsoury-wp-imgix)

PHPackages © 2026

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