Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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.
- Host: GitHub
- URL: https://github.com/nielse63/php-image-cache
- Owner: nielse63
- License: other
- Created: 2013-09-26T20:57:05.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2024-07-05T23:12:40.000Z (5 months ago)
- Last Synced: 2024-11-28T11:08:40.896Z (14 days ago)
- Language: PHP
- Homepage: http://nielse63.github.io/php-image-cache
- Size: 39 MB
- Stars: 457
- Watchers: 48
- Forks: 105
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- php-awesome - Image Cache - 图片压缩、缓存类 (类库 / 图像处理)
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")