CImage

CImage simplifies the process of working with images via PHP and its GD extension.

This small PHP class provides a much simpler and clearer syntax for editing and processing photo's on the server-side, and then caching and optimizing them for client-side delivery.

CImage and its img.php class are easy to integrate into any existing application and will help Web developers easily crop, cut, resize or stretch photos to certain dimensions.

Developers can not only manage an image's dimensions and aspect ratio, but they can also change its format, apply various effect filters on top, and also save it with various quality and compression settings.

This can prove a very useful feature, especially when developing Web-based applications that need to work with images in one way or another.

Usage instructions are provided with the CImage's README file.

What is new in this release:

• Always use password, setting in img_config.php.
• Resize gif keeping transparency.
• Now returns statuscode 500 when something fails.
• Three different modes: strict, production, development.
• Three files for all-in-one imgs.php , imgp.php , imgd.php.
• Change name of script all-in-one to webroot/imgs.php.
• Combine all code into one singel script, webroot/img_single.php.
• Disallow hotlinking/leeching by configuration.
• Alias-name is without extension.
• Option alias now requires password to work.
• Support for option password, pwd to protect usage of alias and remote download.
• Added support for option alias that creates a link to a cached version of the image.

What is new in version 0.7.0:

• Always use password, setting in img_config.php.
• Resize gif keeping transparency.
• Now returns statuscode 500 when something fails.
• Three different modes: strict, production, development.
• Three files for all-in-one imgs.php , imgp.php , imgd.php.
• Change name of script all-in-one to webroot/imgs.php.
• Combine all code into one singel script, webroot/img_single.php.
• Disallow hotlinking/leeching by configuration.
• Alias-name is without extension.
• Option alias now requires password to work.
• Support for option password, pwd to protect usage of alias and remote download.
• Added support for option alias that creates a link to a cached version of the image.

What is new in version 0.6:

• Rewrote and added documentation.
• Moved conolution expressesion from img_config.php to CImage.
• Minor cleaning of properties in CImage.
• Adding webroot/htaccess to show off how friendly urls can be created for img.php.
• Added option fill-to-fit, ff.
• Added option shortcut, sc to enable configuration of complex expressions.
• Added support for custom convolutions.
• Restructured testprograms.
• Corrected json on PHP 5.3.
• Improving template for tests in webroot/tests when testing out.
• Adding option convolve taking comma-separated list of 11 float-values, wraps and exposes imageconvoluttion().
• Adding option dpr, device-pixel-ratio which defaults to 1. Set to 2 to get a twice as large image. Useful for Retina displays. Basically a shortcut to enlarge the image.
• Adding utility cache.bash to ease gathering stats on cache usage.
• Cache-directory can now be readonly and serve all cached files, still failing when need to save files.
• Cache now uses same file extension as original image.

What is new in version 0.5.3:

• Added autoRotate,aro` to auto rotate image based on EXIF information.
• Added bgColor,bgc` to use as backgroundcolor when needing a filler color, for example rotate 45.
• Added rotateBefore,rb` to rotate image a certain angle before processing.
• Added rotateAfter,ra` to rotate image a certain angle after processing.
• Cleaned up code formatting, removed trailing spaces.
• Removed @ from opening images, better to display correct warning when failing #34, but put it back again.
• Setting gd.jpeg_ignore_warning to true as default #34.
• webroot/check_system.php now outputs version of PHP and GD.
• #32 correctly send 404 header when serving an error message.
• Trying to verify issue #29, but can not.
• Adding structure for testprograms together with, use webroot/test_issue29.php as sample.
• Improving code formatting.
• Support filenames of uppercase JPEG, JPG, PNG and GIF, as proposed in #37.
• Changing CImage::output() as proposed in #37.
• Adding security check that image filename is always below the path image_path as specified in img_config.php #37.
• Adding configuration item in img_config.php for setting valid characters in image filename.
• Moving webroot/test* into directory webroot/test.
• webroot/check_system.php now outputs if extension for exif is loaded.
• Broke API when initDimensions() split into two methods, new initDimensions() and loadImageDetails().

Requirements:

• PHP 5.3 or higher