depage-graphics is a helper class to get resized and optimized images and thumbnails.
- supports gd as basic image resizing method
- support imagemagick and graphicsmagick binaries for better image quality support
- support external tools to optimize images like
- jpegtran
- jpegoptim
- optipng
- pngcrush
- composer support
You can compare depage-graphics to SLIR, Smart Lencioni Image Resizer. But where SLIR is only gd-based, you can use Imagemagick or Graphicsmagick as conversion tools to achieve better image quality.
You can use the graphics class as an image service to automatically resize, crop, convert and optimize your images, or to generate thumbnails.
To convert your image you add specific action to your image:
/path-to/image.jpg.resize-400x400.jpg
/path-to/image.jpg.r400x400.jpg
/path-to/image.jpg.thumb-100x75.jpg
/path-to/image.jpg.t100x75.jpg
/path-to/image.jpg.crop-200x200-10x10.jpg
/path-to/image.jpg.c200x200-10x10.jpg
You can also chain actions and parameters:
/path-to/image.png.resize-400x400.quality-50.background-ffffff.jpg
/path-to/image.png.r400x400.q50.bg-ffffff.jpg
This would resize your image to 400x400px set the jpeg quality to 50 and add a white background for transparent pixels.
Basic usage as image service with the gd library and no image optimization:
<?php
require_once(__DIR__ . "/php/Graphics/Graphics.php");
$imgurl = new Depage\Graphics\Imgurl();
$imgurl->render()->display();Extended usage as image service with the imagemagick as conversion utility and jpegtran and optipng as optimization tools:
<?php
require_once(__DIR__ . "/php/Graphics/Graphics.php");
$imgurl = new Depage\Graphics\Imgurl(array(
'extension' => "im",
'executable' => "/usr/bin/convert",
'optimize' => true,
'optimizers' => array(
'jpegtran' => "/usr/bin/jpegtran",
'optipng' => "/usr/bin/optipng",
),
));
$imgurl->render()->display();<?php
require_once(__DIR__ . "/php/Graphics/Graphics.php");
$graphics = new Depage\Graphics\Graphics(array(
'extension' => "im",
'executable' => "/usr/bin/convert",
'optimize' => true,
'optimizers' => array(
'jpegtran' => "/usr/bin/jpegtran",
'optipng' => "/usr/bin/optipng",
),
));
$graphics->addResize(400, 400);
$graphics->addBackground("#ffffff");
$graphics->render("sourceImage.png", "targetImage.jpg");location /basedirectory {
location ~ (?i)/basedirectory/(.*)\.(jpg|jpeg|gif|png)\.([^/]*)\.(jpg|jpeg|gif|png)$ {
rewrite (?i)^(/basedirectory)/(?!lib/cache/graphics)(.*)$ $1/lib/cache/graphics/$2 last;
try_files $uri /basedirectory/lib/global/getimage.php;
}
try_files $uri $uri/;
}
@todo
RewriteEngine on
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-s
RewriteRule ^(?!lib/cache/graphics)(.*)\.(jpg|jpeg|png|gif)\.([^/]*)\.(jpg|jpeg|png|gif)$ /lib/cache/graphics/$0
RewriteCond %{REQUEST_FILENAME} !-s
RewriteRule ^lib/cache/graphics/(.*)\.(jpg|jpeg|png|gif)\.([^/]*)\.(jpg|jpeg)$ /lib/global/getimage.php [T=image/jpeg]
RewriteCond %{REQUEST_FILENAME} !-s
RewriteRule ^lib/cache/graphics/(.*)\.(jpg|jpeg|png|gif)\.([^/]*)\.(png)$ /lib/global/getimage.php [T=image/png]
RewriteCond %{REQUEST_FILENAME} !-s
RewriteRule ^lib/cache/graphics/(.*)\.(jpg|jpeg|png|gif)\.([^/]*)\.(gif)$ /lib/global/getimage.php [T=image/gif]
Get composer at http://getcomposer.org and then just add this to your composer.json.
{
"require": {
"depage/graphics": "dev/master"
}
}
Now run
composer install
to install the current version of depage-graphics into your vendor dir.
- PHP 5.3 with following modules
- gd support
- external binaries (optional)
- convert
- gm
- jpegtran
- jpegoptim
- optipng
- pngcrush
You can fork us at: http://github.com/depage/depage-graphics/
For more information about depage-cms go to: http://www.depagecms.net/