Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/nielse63/php-image-cache

Image Cache is a very simple PHP class that accepts an image source and will compress and cache the file, move it to a new directory, and returns the new source for the image.
https://github.com/nielse63/php-image-cache

Last synced: 7 days ago
JSON representation

Image Cache is a very simple PHP class that accepts an image source and will compress and cache the file, move it to a new directory, and returns the new source for the image.

Awesome Lists containing this project

README

        

# NO LONGER MAINTAINED!!!

# Image Cache v. 1.0.0

Image Cache is a very simple PHP class that accepts an image source and will compress and cache the file, move it to a new directory, and returns the new source for the image.

## Current Status

[![Build Status](https://travis-ci.org/nielse63/php-image-cache.png?branch=master)](https://travis-ci.org/nielse63/php-image-cache)

Employing travis-ci.org for continuous integration testing and assurance of code validity.

## Installation

Install Composer by opening Terminal and navigating to the directory in which you'd like to install Image Cache.

Download Composer:

```bash
curl -sS https://getcomposer.org/installer | php
```

Create a `composer.json` file:

```json
{
"require" : {
"nielse63/phpimagecache": "dev-master"
}
}
```

Navigate to your project root and run the `install` command.

```bash
$ php composer.phar install
```

From there, include the `vendor/autoload.php` file in your project, and initialize the class as normal.

More information on installing and using Composer can be found at getcomposer.org, and dependency information on the package can be found at packagist.org.

## Testing

### Manual Testing

To test the script manually by receiving visual output, setup a virtual host and load `demo/index.php` in your browser. Three examples are set in that file: the original image called from an outside source; a cached example referencing the outside source via an absolute URL; and an internal source referencing a file path.

Using Chrome Developer Tools you can see the difference in load times between the external source (non-cached image) and the internally stored and cached image.

### Unit Testing

Some extremely basic unit tests are included with the script and can be run using PHP Unit. I'm working on continuing to build up these tests and would more than welcome any contributions to the tests.

To execute the tests in a bundled script (along with rebuilding the docs), clone the repository, navigate to the root of the repo in terminal, and execute:

```bash
$: sh build
```

Assuming you have the `phpunit` and `phpdoc` commands intalled, the tests will pass and docs will be rebuilt.

## What's Next

See the source for a full to do list of changes that I wish to accomplish moving forward.

## Contributing

Contributing to the project would be a massive help in maintaining and extending the script. The module is being used on a larger scale than I initially imagined, and continuing to maintain it is becoming a little time consuming for just me.

If you're interested in contributing, issue a pull request on Github or email me directly at [email protected].

For any issues found or extensions you'd like to see, feel free to submit an issue ticket so we can start a discussion about the viability of the problem and how it can be resolved.

## License

Creative Commons Attribution Lisence:

http://freedomdefined.org/Licenses/CC-BY

[![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/nielse63/php-image-cache/trend.png)](https://bitdeli.com/free "Bitdeli Badge")