https://github.com/pavlin-policar/simpleimage

A simple image management system for resizing various images.
https://github.com/pavlin-policar/simpleimage

Last synced: 16 days ago
JSON representation

A simple image management system for resizing various images.

• Host: GitHub
• URL: https://github.com/pavlin-policar/simpleimage
• Owner: pavlin-policar
• Created: 2015-06-25T13:32:06.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2015-08-21T09:56:20.000Z (about 9 years ago)
• Last Synced: 2024-10-07T17:03:17.324Z (about 1 month ago)
• Language: PHP
• Size: 156 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# 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

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

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

Keep the aspect ratio and specify a new height.

E.g.

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

### Resize by width

Keep the aspect ratio and specify a new width.

E.g.

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

### 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

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.