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 1w ago

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 12% 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

[goat1000/svggraph

Generates SVG graphs

135931.0k3](/packages/goat1000-svggraph)[stefangabos/zebra_image

A single-file, lightweight PHP library designed for efficient image manipulation featuring methods for modifying images and applying filters

138121.6k7](/packages/stefangabos-zebra-image)[treinetic/imageartist

ImageArtist is a php gd Wrapper which makes Image manipulation insanely easy, we introduce ImageArtist as Photoshop for php

8783.2k](/packages/treinetic-imageartist)[johncarter/filament-focal-point-picker

An image focal point picker for Filament Admin.

4431.7k1](/packages/johncarter-filament-focal-point-picker)[yk/laravel-ocr

A wrapper for gocr.

1356.6k](/packages/yk-laravel-ocr)

PHPackages © 2026

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