mod_gfx: On-the-fly image operations

Installation

The makefile is very weak at the moment. As long as you have APXS installed, the build process should be a snap:

Ensure APXS, libgd, and gcc are installed
Compile module (run make)
Copy module/mod_gfx.so to your apache modules directory
Configure Apache to use module
Restart Apache

Simple Explanation

The way this module works is very simple. From a high-level, when you request an image through the module, the following happens:

Example URL: http://gfx.domain.com/(profile)/path/to/image.ext
The URL is broken out into a profile and path
We select an origin based on a matching GfxOriginMatch directive
We connect to the origin and send the path (minus profile) as a GET request
We load the image from the origin into memory
We select the desired profile and perform operations on the image
The resultant image is sent to the end-user

Configuration Example

LoadModule gfx_module modules/mod_gfx.so <Location /> SetHandler gfx </Location> GfxOriginMatch myorigin ^/regex/path/to/file.jpg$ <GfxOrigin "myorigin"> GfxOriginHost server1.backend.com GfxOriginHost server2.backend.com GfxOriginHost server3.backend.com </GfxOrigin> <GfxProfile "lowqual60x60"> GfxAction resize GfxRsX 60 GfxRsY 60 GfxQual 50 </GfxProfile> <GfxProfile "highqual640x480"> GfxAction resample GfxRsX 640 GfxRsY 480 GfxQual 95 </GfxProfile> <GfxProfile "forcePNG"> GfxAction noop GfxOutputFormat PNG </GfxProfile> <GfxProfile "watermark"> GfxAction watermark GfxWatermark /var/content/company_logo.png </GfxProfile>